Traducir contenido dentro de shortcodes
POM Translate puede extraer el texto interno de los shortcodes y los valores de los atributos, manteniendo el shortcode como estructura protegida. La tabla de traducción etiqueta estas filas como Contenido interno del shortcode o Atributo del shortcode.
Solo las filas extraídas están pensadas para traducirse. No reescribas la sintaxis completa del shortcode.
Guarda primero el shortcode canónico
El shortcode debe estar presente en el objeto de origen publicado o privado. Guarda la entrada una vez que su etiqueta, atributos y anidamiento sean definitivos para que POM Translate pueda asignar claves estructurales estables.
A continuación, abre Translations → Translate contents y filtra por esa entrada.
Traduce el contenido interno
Para un shortcode como:
[notice]Delivery takes two business days.[/notice]traduce la fila interna extraída legible por humanos. El shortcode de apertura y el de cierre permanecen en el esqueleto del cuerpo y no deben pegarse en el área de texto de traducción, salvo que el propio origen extraído muestre marcadores de shortcode protegidos.
Verifica el formato anidado en la ruta pública, porque el contenido interno también puede contener HTML en línea protegido.
Traduce los atributos de forma selectiva
Los atributos pueden ser texto editorial o configuración técnica. POM Translate mantiene una lista de permitidos específica para los shortcodes de formulario de contacto de POM conocidos, de modo que las etiquetas, los marcadores de posición, las descripciones, los mensajes, el texto de los botones, la copia de privacidad y otros valores visibles para el visitante puedan extraerse sin exponer atributos estructurales.
Para las etiquetas de shortcode sin un mapa registrado, los atributos son aptos por defecto y las integraciones pueden refinar esa decisión. Por lo tanto:
- lee el Contexto con atención;
- traduce solo los valores que los visitantes deberían leer;
- deja sin cambios los ID, las direcciones de correo, los nombres de campo, los controles numéricos, las URL, las clases CSS y las claves de opción;
- pide al proveedor del shortcode que registre un mapa de atributos explícito si aparecen valores técnicos.
Un mapa vacío para un shortcode conocido significa que no se traduce ninguno de sus atributos.
Mantén intactos los tokens estables
El procesamiento de shortcodes sustituye las piezas extraídas por marcadores estables en el esqueleto almacenado. Si una fila de traducción contiene tokens:
- conserva cada token;
- no traduzcas los caracteres del marcador;
- no dupliques un token para repetir contenido;
- no muevas un token a otra fila.
Las ediciones no válidas de los marcadores de posición protegidos pueden rechazarse al guardar. Incluso una traducción sintácticamente aceptada debe probarse a través del renderizador real del shortcode.
Responde a las ediciones del shortcode
Cambiar una etiqueta, una lista de atributos, el orden de anidamiento o el texto de origen puede alterar la identidad de la fila extraída. Cuando cambia una fila de origen, se eliminan sus traducciones de destino anteriores, salvo que haya disponible una traducción de origen que coincida exactamente para reutilizarla.
Después de reestructurar un shortcode:
- guarda el objeto de origen;
- recarga su resumen de configuración regional;
- filtra por Pendiente;
- traduce las filas nuevas;
- confirma que las filas obsoletas ya no se muestran;
- vuelve a probar el componente renderizado.
Verifica el contenido funcional
Comprueba:
- las etiquetas y los mensajes visibles;
- el envío y la validación del formulario;
- los valores de opción frente a las etiquetas de opción;
- el texto del correo para el cliente y el administrador;
- los enlaces de privacidad y la redacción del consentimiento;
- los campos ocultos y los identificadores técnicos;
- el diseño adaptable;
- el comportamiento con una fila de destino intencionadamente vacía.
Si el shortcode comienza por [vc_, lee también Traducir contenido del maquetador, porque el analizador de Visual Composer sigue su propia ruta de extracción.