Entender las cadenas registradas

Una cadena registrada es un valor público independiente que un tema, un plugin o una integración personalizada pone a disposición de POM Translate de forma explícita. Resulta útil para textos que no tienen entrada de entrada, término, elemento de menú o catálogo gettext.

Identidad del registro

Los desarrolladores registran un valor con:

pom_translate_register_string(
    'my-plugin/footer-message',
    (string) get_option( 'my_plugin_footer_message', '' )
);

El primer argumento es un nombre estable propiedad del producto. Mantenlo sin cambios cuando cambie el texto mostrado. El segundo argumento es el texto original actual.

El asistente también acepta los argumentos heredados de grupo y multilínea por compatibilidad. No crean grupos ni modos de edición separados en el Translation Manager actual, por lo que las integraciones no deberían depender de ellos para organizarse.

Mostrar un valor traducido

Pasa el valor original—no su nombre de registro—al asistente de traducción:

$message = (string) get_option( 'my_plugin_footer_message', '' );

echo esc_html( pom_translate__( $message ) );

pom_translate__() resuelve la configuración regional activa y devuelve el texto original cuando no hay ninguna traducción disponible. Puede registrar un valor desconocido automáticamente, pero el registro explícito con un nombre estable es preferible para los ajustes y para una administración predecible.

Para el código que ya conoce la configuración regional de destino, pom_translate_translate_string( $value, $locale ) proporciona la misma alternativa de texto original. Las integraciones que gestionan salidas REST o AJAX pueden usar pom_translate_translate_registered_string() cuando necesitan una búsqueda sin registro automático.

Escapa el valor devuelto según el contexto de salida. Usa esc_html() para texto plano y una lista de permitidos adecuada como wp_kses_post() solo cuando el ajuste admita HTML seguro de forma intencionada.

Ciclo de vida de la traducción

Los valores registrados aparecen en Translations → Other translations. Sus valores de configuración regional usan los mismos estados de traducción y el mismo flujo de revisión que otras cadenas respaldadas por la base de datos.

Si el valor original cambia mientras su nombre estable sigue siendo el mismo, POM Translate actualiza el registro original y elimina las traducciones antiguas de la configuración regional. Esto evita que una traducción escrita para un texto obsoleto se muestre como actual.

Para los mensajes gettext con formas plurales o contexto de mensaje, usa Software translations en su lugar.