Entender el soporte de idiomas personalizados

POM Translate no ofrece actualmente un formulario para inventar una configuración regional adicional arbitraria. El selector Language utiliza el catálogo de idiomas compatibles del producto, y el asistente programático de activación/desactivación también normaliza la entrada con respecto a ese catálogo.

Una etiqueta de visualización personalizada no es una configuración regional personalizada.

Qué contiene una definición de idioma

Cada definición compatible proporciona información que se utiliza en todo el producto, incluyendo:

• un código de configuración regional como en_GB;
• un slug de idioma;
• un código de país y una definición de bandera cuando corresponda;
• nombres de idioma locales y en inglés;
• nombres de país locales y en inglés.

POM Translate utiliza la configuración regional como identidad estable. Las demás propiedades respaldan selectores, visualización regional, prefijos, dirección de traducción automática y metadatos de idioma.

Añadir únicamente un nombre y un código de dos letras dejaría incompletas esas relaciones.

Utiliza una variante regional existente cuando sea posible

Antes de concluir que se necesita un idioma personalizado:

1. abre Settings → POM Translate → Languages setup → Base setup;
2. añade una fila Additional language;
3. busca en el selector Language el nombre local, el nombre en inglés y la región;
4. compara los códigos completos de configuración regional que se muestran entre corchetes;
5. selecciona la variante compatible exacta;
6. usa Custom language label si solo es necesario cambiar el texto público.

Por ejemplo, cambiar «English (United Kingdom)» por «English» es una decisión de etiqueta. No requiere otra definición de configuración regional.

La configuración regional principal de WordPress es un caso especial

El Main language de solo lectura sigue a Settings → General → Site Language. Si WordPress proporciona una configuración regional del sitio que no está presente en el catálogo de POM Translate, la pantalla de configuración Base sigue incluyendo esa configuración regional actual como idioma de origen.

POM Translate puede recurrir al código de configuración regional sin procesar cuando las etiquetas del catálogo no están disponibles. Sin embargo, la presentación que depende del catálogo, como los nombres regionales o los metadatos de bandera, puede quedar incompleta.

Esto no hace que la configuración regional no compatible sea seleccionable como idioma adicional.

La activación programática tiene el mismo límite

El asistente público de alternancia de idiomas acepta:

• una configuración regional compatible exacta como en_GB;
• un equivalente con guion como en-GB;
• un código de idioma de dos letras, que se resuelve a la primera definición coincidente del catálogo.

La entrada no compatible se rechaza. Pasar en también es menos preciso que pasar en_GB porque elige la primera coincidencia del catálogo, no una región inferida de la audiencia del sitio.

Las integraciones deben almacenar y pasar la configuración regional compatible completa.

No edites el catálogo en su lugar

Evita modificar el archivo de datos de idioma del plugin para añadir una definición local:

• una actualización puede sobrescribir la edición;
• otros entornos no la compartirán;
• pueden quedar pendientes banderas, nombres, comportamiento de prefijos, catálogos y soporte del proveedor de traducción;
• la configuración regional no ha pasado la revisión de compatibilidad normal del producto.

Solicita una adición intencional al producto cuando una configuración regional realmente nueva deba pasar a ser compatible. Esa adición debe definir su identidad y verificar en conjunto el enrutamiento, los selectores, la coincidencia del navegador, el SEO, los catálogos de software, POM AI, WooCommerce y el comportamiento multisitio.

Las etiquetas personalizadas resuelven solo la presentación

Usa:

• Custom label for the main language para la configuración regional de origen;
• Custom language label dentro de una fila de idioma adicional para una configuración regional de destino.

Estos valores se sanean como texto plano y se ponen a disposición de los selectores de idioma y de las etiquetas de configuración regional. No cambian:

• el código de configuración regional;
• el prefijo de URL generado;
• lang o hreflang;
• la asociación de origen o destino;
• la definición de bandera regional;
• la coincidencia Accept-Language del navegador.

El marcado del conmutador debe usar la etiqueta de combinación {%custom_label%} cuando deba mostrarse ese texto personalizado exacto. El marcado predeterminado puede mostrar en su lugar etiquetas locales y en inglés proporcionadas por el catálogo.

Verifica la solución elegida

Después de seleccionar una variante compatible o de añadir una etiqueta personalizada:

1. recarga la configuración Base y confirma la configuración regional completa;
2. inspecciona el marcado del selector de idioma;
3. verifica el prefijo de la URL de destino;
4. inspecciona el valor lang del documento;
5. comprueba los metadatos canónicos y de idiomas alternativos;
6. prueba una cabecera de idioma del navegador exacta y una general;
7. confirma que la traducción automática y los catálogos de software reconozcan la configuración regional prevista.

Si el requisito se limita al texto visible para el visitante, continúa con Configure public language labels. Si lo que falta es la propia identidad de la configuración regional, no la simules con una etiqueta.