Traducir los valores de los ajustes públicos

Un ajuste público es un texto guardado por el propietario de un sitio y mostrado a los visitantes, como un mensaje de pie de página o una llamada a la acción configurable. No se vuelve traducible automáticamente solo porque WordPress lo almacene como una opción. El tema o plugin que lo posee debe registrarlo y resolverlo a través de POM Translate.

Para propietarios de sitios y traductores

1. Guarda el valor original en la pantalla de ajustes del tema o del plugin.
2. Carga la funcionalidad pública una vez si la integración registra los valores cuando se ejecuta.
3. Ve a Translations → Other translations.
4. Elige la configuración regional de destino.
5. Busca el valor original o su nombre registrado.
6. Introduce la traducción y selecciona Save translations.
7. Abre la página en el idioma de destino y comprueba el resultado.

Cambiar el texto original del ajuste puede invalidar sus traducciones existentes. Vuelve a Other translations después de cada cambio en el texto original y proporciona nuevos valores para cada configuración regional.

Requisito de integración

El código propietario debe usar un nombre estable para el ajuste:

$label = (string) get_option( 'my_plugin_public_label', '' );

pom_translate_register_string( 'my-plugin/public-label', $label );

Al renderizar, debe resolver el mismo valor original:

echo esc_html( pom_translate__( $label ) );

El nombre estable identifica el ajuste a través de las ediciones del texto original. No lo construyas a partir del texto visible, de la configuración regional actual ni de un valor traducido.

Usa un escape de salida que coincida con el ajuste. Las etiquetas de texto plano deben escaparse como texto. Los ajustes diseñados para contener un marcado limitado deben renderizarse con la lista permitida de HTML documentada del producto.

Qué no registrar

No uses este flujo de trabajo para:

• contenido de entradas, términos, menús o campos personalizados compatibles;
• mensajes fijos del código fuente que ya usan gettext;
• valores de configuración privados, secretos, URL usadas solo como datos técnicos o controles exclusivos de administradores;
• valores que contengan datos de clientes o pedidos específicos de una solicitud.

Resultado esperado

La opción sigue siendo un único valor de origen en el producto que la posee. POM Translate almacena solo las variantes de cada configuración regional y devuelve el original cuando falta una traducción, de modo que la funcionalidad sigue siendo utilizable mientras se completan las traducciones.