Actualiza el texto de origen de una cadena registrada

Las cadenas registradas usan un nombre estable para identificar un ajuste y un valor de origen separado para conservar su texto actual. Cuando ese valor de origen cambia, las traducciones escritas para la redacción anterior pueden dejar de ser correctas.

Qué hace POM Translate

Cuando una integración registra el mismo nombre estable con un texto de origen modificado, POM Translate actualiza el registro de origen y elimina sus antiguas traducciones de idioma. La cadena actualizada puede volver entonces al flujo de trabajo de traducción. Una traducción exacta solo puede reutilizarse cuando el mismo texto de origen ya se conoce en otro lugar.

Hasta que no haya disponible un nuevo valor de idioma, el asistente de cadena registrada recurre como alternativa al nuevo texto original. Así, los visitantes ven el texto de origen actual en lugar de una traducción obsoleta.

Flujo de trabajo de actualización segura

1. Anota qué idiomas tienen actualmente una traducción.
2. Cambia y guarda el ajuste original en su tema o plugin propietario.
3. Carga la funcionalidad para que su integración registre el nuevo valor.
4. Ve a Translations → Other translations.
5. Elige cada idioma de destino por turnos.
6. Busca por el nombre registrado estable.
7. Traduce la nueva redacción y selecciona Save translations.
8. Comprueba la salida pública en todos los idiomas afectados.

Trata los cambios de puntuación, mayúsculas, marcado y marcadores de posición también como cambios de origen. Una edición pequeña puede alterar el significado o los requisitos de formato.

Orientación para desarrolladores

Mantén estable el nombre de registro:

pom_translate_register_string(
    'my-plugin/checkout-note',
    (string) get_option( 'my_plugin_checkout_note', '' )
);

No añadas un número de versión ni un hash al nombre cada vez que cambie el texto. Eso crearía un nuevo origen registrado en lugar de actualizar la identidad del ajuste existente.

No reutilices un nombre para ajustes no relacionados. Un nombre estable debe describir un único valor público durante toda la vida de la integración.

Comprueba el resultado

Después de guardar las nuevas traducciones, confirma que:

• el nuevo origen aparece en Other translations;
• la traducción antigua no se muestra de forma silenciosa;
• el valor de destino correcto aparece en la página pública;
• los marcadores de posición o el marcado permitido permanecen intactos.

Las actualizaciones del catálogo Gettext siguen un proceso diferente: regenera u obtén el origen POT/PO actualizado, vuelve a cargar el dominio y exporta nuevos archivos PO/MO.