Cómo se traducen las cadenas registradas de la interfaz
Las cadenas registradas abarcan etiquetas visibles en el sitio que no pertenecen de forma natural a una entrada, un término, un elemento de menú o un catálogo de software gettext. Un tema o plugin registra un nombre estable y un valor de origen actual; los editores traducen ese valor en Translations → Other translations.
Usa cadenas registradas para textos estables del sitio
Algunos ejemplos apropiados son:
- una opción del tema usada como encabezado público;
- una frase reutilizable del pie de página;
- una etiqueta de formulario almacenada fuera del contenido de la entrada;
- un mensaje definido por una integración con un propósito público estable;
- un valor predeterminado que se muestra en varias ubicaciones compatibles.
No registres:
- datos arbitrarios del visitante o del cliente;
- respuestas HTML dinámicas completas;
- IDs, tokens, precios, coordenadas o configuración serializada;
- cadenas gettext ordinarias de WordPress que ya pertenecen a un dominio de texto del software;
- contenido de entrada que POM Translate puede extraer de su objeto canónico.
Elegir la superficie correcta mantiene predecibles la propiedad del origen y la invalidación de caché.
El registro establece la identidad
El asistente público acepta un nombre de cadena único y su texto de origen actual. El nombre estable identifica la configuración o el propósito de la interfaz incluso si la redacción mostrada del origen cambia más adelante.
Un nombre ausente o vacío se rechaza. Volver a registrar el mismo nombre actualiza su valor de origen actual y la caché de cadenas registradas de la solicitud.
Los argumentos opcionales de agrupación heredada y multilínea siguen aceptándose por compatibilidad, pero la asociación de almacenamiento actual se basa en el nombre único y el valor de origen. No te fíes de una etiqueta de grupo para distinguir dos registros con el mismo nombre.
Las responsabilidades de origen y destino permanecen separadas
El tema, el plugin o la configuración que registra la cadena es dueño de su texto de origen. POM Translate es dueño de los valores en la configuración regional de destino para esa entrada registrada.
Cuando el texto de origen cambia, la unidad de origen subyacente se actualiza siguiendo las mismas reglas de origen exacto que los demás valores traducidos. El texto de destino existente debe revisarse salvo que se pueda reutilizar una coincidencia normalizada exacta.
Los editores no deben alterar la redacción del origen desde Other translations. Haz la corrección del origen donde se registra o se configura la cadena y, a continuación, permite que POM Translate actualice la entrada.
La representación es explícita
El registro por sí solo no sustituye palabras coincidentes en toda la página. El componente propietario de la cadena debe solicitar su traducción para la configuración regional activa o usar una integración de POM Translate compatible que lo haga.
La búsqueda:
- encuentra la entrada registrada para el valor de origen proporcionado;
- normaliza el idioma solicitado a una configuración regional configurada;
- devuelve el origen sin cambios para la configuración regional base;
- carga el valor de destino para otra configuración regional;
- devuelve el origen cuando no existe ninguna traducción no vacía.
POM Translate no registra automáticamente cadenas desconocidas durante una búsqueda de traducción. Esto evita que una respuesta dinámica de REST o AJAX llene el registro con valores específicos del cliente o de corta duración.
Las cadenas registradas no son catálogos gettext
| Cadenas registradas | Traducciones de software |
|---|---|
| Definidas deliberadamente por un tema, plugin o configuración compatible | Extraídas de los catálogos gettext de WordPress, del tema o del plugin |
| Se editan en Other translations | Se editan en Software translations |
| Se resuelven mediante el contrato de cadenas registradas de POM Translate | Se escriben y cargan desde los archivos PO/MO de WordPress |
| Pensadas para textos estables del sitio o de la integración | Pensadas para mensajes de la interfaz del software |
No dupliques un mensaje gettext como cadena registrada solo para evitar el flujo de trabajo de traducción de software.
Verifica una etiqueta registrada
- Elige una configuración pública o etiqueta de integración compatible que aparezca en Other translations.
- Anota su redacción de origen y dónde aparece en el sitio.
- Añade una traducción de destino y guárdala.
- Abre la ruta de origen y confirma que la etiqueta original permanece.
- Abre la ruta de destino y confirma que aparece la etiqueta traducida.
- Borra el valor de destino y verifica la alternativa del origen.
- Cambia el valor de origen mediante su configuración o integración propietaria.
- Recarga Other translations y confirma que el origen actualizado requiere la revisión oportuna.
Si una etiqueta aparece en la tabla pero nunca cambia públicamente, confirma que su propietario solicita la traducción registrada en ese contexto de salida. El registro hace que un valor esté disponible; no realiza una sustitución global de texto.