Artefactos de conteúdo do Payload
Traduza campos selecionados do Payload CMS e texto Lexical suportado, preservando a estrutura usada para gravar os resultados no fornecedor.
Uma página do Payload combina conteúdo legível com IDs, relações, ficheiros carregados e a estrutura do editor. A integração começa por selecionar os campos localizados e criar um artefacto para tradução. Em seguida, o processador payload traduz os valores simples suportados e o texto Lexical contidos nesse artefacto.
Utilize a integração do Payload para selecionar conteúdo e voltar a gravá-lo no CMS. Enviar diretamente um registo do CMS sem o filtrar ignora a seleção de campos do fornecedor e pode incluir dados que nunca se destinaram a tradução.
Campos selecionados e texto formatado #
Um artefacto com campos selecionados pode conter um título e uma árvore Lexical:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}O título e o conteúdo textual suportado destinam-se a tradução. Os tipos de nós Lexical, os dados de formatação e a estrutura em linha suportada orientam a reconstrução. Os destinos das ligações, os ficheiros carregados, as relações e os campos estruturais dos blocos não passam a ser texto para tradução só por conterem cadeias de caracteres. Ainda assim, o texto localizado selecionado nos campos de blocos suportados pode ser traduzido após a filtragem pelo fornecedor.
No Lexical, os segmentos de texto suportados mantêm a formatação e a estrutura em linha. Os nós personalizados têm de ser verificados à luz da representação suportada; o suporte para Lexical não se estende à árvore de documentos de um editor qualquer.
Correspondência entre origem e destino #
Os caminhos dos campos de origem e de destino identificam os valores correspondentes. Quando é fornecido um destino existente sem uma versão anterior da origem, o processador aproveita os valores de destino correspondentes já presentes e traduz o que falta. Não substitui todos os campos localizados existentes só por se tratar da primeira sincronização registada.
Quando existe uma versão anterior da origem, é necessário processar as unidades de origem alteradas e os valores de destino em falta. Um documento existente no CMS pode estar apenas parcialmente traduzido, pelo que a sua presença não garante que esteja completo. A reconstrução parte do artefacto de origem selecionado e insere os valores suportados, traduzidos ou mantidos; serializa o JSON em vez de preservar os bytes de origem.
O alinhamento do texto formatado tem de ser verificado após as edições. Uma alteração na estrutura de um parágrafo ou num nó personalizado pode afetar a correspondência, mesmo que algumas palavras se mantenham. Verifique o campo resultante no CMS e o conteúdo apresentado, não apenas a validade do artefacto.
Da seleção à gravação dos resultados #
A integração do Payload assegura a seleção do esquema, a leitura por idioma, a configuração da ligação e a gravação dos resultados. O pacote do Payload CMS documenta as exportações do plugin. Mantenha esses passos do fornecedor antes e depois do processamento do artefacto, para que os campos selecionados sejam gravados no documento e no idioma corretos.
Depois de gravar os resultados, abra o documento localizado no CMS e verifique tanto os campos simples como o texto formatado. Siga as ligações, verifique as relações incorporadas e compare os campos abrangidos no destino com a seleção de origem. A reconstrução do artefacto não concede permissão de escrita no fornecedor nem determina se o conteúdo está pronto para publicação.