Artefactos de contenido de Payload
Traduce los campos seleccionados de Payload CMS y el texto compatible de Lexical sin alterar la estructura que utiliza el proveedor para guardar los resultados.
Una página de Payload combina contenido legible con identificadores, relaciones, archivos subidos y la estructura del editor. La integración selecciona primero los campos localizados y crea un artefacto para traducirlos. A continuación, el gestor payload traduce los valores simples compatibles y el texto de Lexical que contiene ese artefacto.
Usa la integración con Payload para seleccionar el contenido y guardar los resultados. Si envías directamente un registro del CMS sin filtrar, te saltas la selección de campos del proveedor y puedes incluir datos que nunca se concibieron para su traducción.
Campos seleccionados y texto enriquecido #
Un artefacto con los campos seleccionados puede contener un título y un árbol de Lexical:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}El título y el contenido de texto compatible son los elementos que se traducen. Los tipos de nodo de Lexical, los datos de formato y la estructura en línea compatible guían la reconstrucción. Los destinos de los enlaces, los archivos subidos, las relaciones y los campos estructurales de los bloques no se convierten en prosa por el mero hecho de contener cadenas de texto. El texto localizado seleccionado dentro de los campos de bloque compatibles sí puede traducirse una vez aplicado el filtrado del proveedor.
En Lexical, los fragmentos de texto compatibles conservan el formato y la estructura en línea. Los nodos personalizados deben revisarse para comprobar si encajan en la representación compatible; la compatibilidad con Lexical no se extiende al árbol de documentos de cualquier editor.
Correspondencia entre origen y destino #
Las rutas de los campos de origen y destino identifican los valores correspondientes. Cuando se proporciona un destino existente sin un origen anterior, el gestor conserva los valores de destino presentes en las rutas correspondientes y traduce los que faltan. No sobrescribe todos los campos localizados existentes solo porque sea la primera sincronización registrada.
Si hay un origen anterior, deben procesarse las unidades de origen modificadas y los valores de destino que faltan. Un documento existente en el CMS puede estar parcialmente traducido, por lo que su presencia no demuestra que esté completo. La reconstrucción parte del artefacto de origen seleccionado e inserta los valores compatibles, ya sean traducidos o conservados; serializa JSON en lugar de conservar los bytes del origen.
La alineación del texto enriquecido debe revisarse después de cada modificación. Un cambio en la estructura de los párrafos o un nodo personalizado puede afectar a la correspondencia, aunque algunas palabras sigan siendo las mismas. Comprueba el campo resultante del CMS y el contenido renderizado, no solo la validez del artefacto.
Conecta la selección con el guardado de resultados #
La integración con Payload se encarga de la selección del esquema, la lectura por idioma, la configuración de la conexión y el guardado de resultados. El paquete de Payload CMS documenta las exportaciones del complemento. Mantén esos pasos del proveedor antes y después de la ejecución del gestor de artefactos para que los campos seleccionados se guarden en el documento y el idioma correctos.
Tras guardar los resultados, abre el documento localizado del CMS y revisa tanto los campos simples como el texto enriquecido. Sigue los enlaces, comprueba las relaciones integradas y compara los campos cubiertos en el destino con los seleccionados en el origen. La reconstrucción del artefacto no concede permisos de escritura en el proveedor ni determina si el contenido está listo para publicarse.