Traducir el contenido del constructor

La compatibilidad con el constructor depende de dónde almacene su contenido. POM Translate dispone de una ruta dedicada a Visual Composer para post_content que contiene shortcodes de [vc_. Otros constructores solo son compatibles cuando su texto visible para el visitante está disponible a través del contenido normal de la entrada, una clave de meta translatable registrada o una integración específica del producto.

No asumas que activar Content expone todos los controles del constructor.

Identifica el modelo de almacenamiento

Antes de traducir, crea una pequeña página de prueba que contenga:

• un encabezado;
• un componente de texto enriquecido;
• un botón con etiqueta y URL;
• una imagen con texto alternativo;
• un componente repetido o anidado.

Publícala o publícala de forma privada, guarda y abre Manage translations. Compara la tabla con la pantalla del constructor.

Si falta texto importante, determina si se encuentra en:

• post_content ordinario;
• shortcodes de Visual Composer;
• una clave de meta de la entrada;
• un objeto de plantilla reutilizable;
• un widget global o una opción del software.

Cada familia de almacenamiento requiere la superficie de traducción correspondiente.

Trabaja con Visual Composer

Cuando post_content contiene [vc_, POM Translate elige automáticamente su analizador de Visual Composer. Extrae los segmentos de texto y atributos compatibles mientras crea un esqueleto para la estructura del shortcode.

POM Theme declara sus campos de módulo translatables independientemente del editor. Entre ellos se incluyen títulos, subtítulos, texto de botones, etiquetas accesibles, etiquetas del buscador, mensajes de formularios y texto de listados. Las mismas declaraciones se aplican a los shortcodes utilizados fuera de las filas de Visual Composer. Estos campos se detectan incluso cuando el editor de WPBakery no está cargado, incluidas las peticiones en segundo plano del gestor de traducciones. Las URLs, los ajustes de consulta, los ID y los controles visuales siguen formando parte del diseño.

Los títulos, las descripciones y las etiquetas de fecha de las cronologías aparecen como filas individuales de Shortcode group field. Traduce su texto con normalidad; la estructura del grupo de parámetros se reconstruye automáticamente. La configuración del grupo, incluidas las clases CSS, se conserva. Los módulos de código y script no se tratan como prosa. Los atributos de texto enriquecido conservan su HTML, sus delimitadores de comillas y sus saltos de párrafo. Los atributos HTML independientes alt, title, placeholder y aria-label se extraen junto con el texto del constructor. Los elementos HTML marcados con data-pom-translate="skip" conservan su contenido, incluidos los shortcodes que contienen.

Para una página existente, guarda la página de origen o abre Generate pending translations y utiliza Process all para descubrir estos campos. Translate pending only procesa filas ya almacenadas y no descubre campos que faltan. A continuación, abre Translate contents, filtra por el Object ID de la página y confirma que sus encabezados y etiquetas de botones aparecen. Traduce las nuevas filas pendientes y comprueba la página en el idioma de destino. Un porcentaje de finalización cubre las cadenas descubiertas; compáralo con el contenido visible de la página antes de considerar la página terminada.

Traduce únicamente las filas mostradas en Translate contents. Conserva los marcadores protegidos y nunca pegues un árbol de [vc_row] reconstruido en un único campo.

Después de guardar, inspecciona:

• el orden de filas y columnas;
• los bloques de texto;
• las etiquetas y los destinos de los botones;
• los componentes HTML sin formato;
• los shortcodes anidados;
• la visibilidad responsiva;
• los elementos reutilizables o con plantilla.

Trabaja con constructores basados en meta

Activa Meta para el tipo de entrada, pero entiende que este interruptor es solo un requisito previo. POM Translate procesa las claves de metadatos registradas como translatables; no examina cada registro de meta de la entrada.

Los arrays estructurados y los documentos de constructor serializados no son campos de texto ordinarios. Necesitan una integración que exponga cadenas estables legibles por humanos y restaure de forma segura el esquema del constructor.

Si aparece una fila de meta de texto registrado como Field: key_name, traduce su contenido sin alterar ningún token protegido.

Separa el contenido de los controles

Traduce:

• encabezados y párrafos visibles;
• etiquetas de botones;
• alternativas y leyendas de imágenes cuando estén expuestas;
• etiquetas de formularios visibles para el visitante;
• descripciones accesibles.

No traduzcas:

• ID de elementos;
• clases CSS;
• puntos de ruptura;
• nombres de animaciones;
• identificadores de plantillas;
• colores, dimensiones o ajustes numéricos;
• URLs internas, a menos que las gestione la capa de traducción de URLs.

Gestiona las revisiones del constructor

Mover o reemplazar componentes puede cambiar las claves estructurales. Guardar el origen hace que POM Translate limpie las filas que ya no se utilizan y regenere las filas modificadas. Sus traducciones anteriores pueden desaparecer cuando cambia la identidad del origen.

Termina el trabajo de diseño principal antes de la revisión lingüística. Tras ediciones de diseño posteriores, comprueba el porcentaje del idioma y filtra por Pending en lugar de asumir que solo ha cambiado el texto visible.

Decide si el constructor es compatible

Una prueba correcta requiere que:

• cada valor visible previsto aparezca una sola vez;
• los valores de configuración no aparezcan como prosa;
• el texto de destino guardado se muestre en el componente correcto;
• los elementos anidados y repetidos permanezcan alineados;
• una edición del diseño de origen produzca un trabajo pendiente comprensible;
• la salida en móvil siga siendo válida.

Si esas comprobaciones fallan, no traduzcas el constructor a gran escala. Registra su texto a través de metadatos compatibles o implementa primero una integración estable.

Continúa con Traducir campos personalizados para el texto almacenado fuera de post_content.