Referencia de configuración de idiomas
La pantalla Base setup define la lista efectiva de idiomas y la primera capa del enrutamiento público:
Settings → POM Translate → Languages setup → Base setup
Usa esta referencia para comprobar qué cambia cada campo y qué queda fuera de él.
Referencia de campos
| Campo | Valor aceptado | Efecto en tiempo de ejecución |
|---|---|---|
| Main language | La configuración regional actual del sitio de WordPress; solo lectura | Define la configuración regional de origen canónica |
| Custom label for the main language | Texto sin formato opcional | Sustituye la etiqueta de visualización de la configuración regional principal en los selectores |
| Additional languages | Lista ordenable de definiciones de configuraciones regionales compatibles | Añade configuraciones regionales de destino en el orden almacenado |
| Language | Una configuración regional compatible por elemento del repetidor | Selecciona la configuración regional de destino exacta |
| Custom language label | Texto sin formato opcional por destino | Sustituye la etiqueta de esa configuración regional en el selector |
| Use a subdirectory for the default language | Activado o desactivado | Decide si la configuración regional de origen necesita también un prefijo de URL |
| Browser language detection | Activado o desactivado | Permite que las visitas sin prefijo elegibles se redirijan por preferencia o coincidencia del navegador |
| Fallback language for redirects | Una configuración regional actualmente configurada | Proporciona el destino de redirección cuando ningún idioma del navegador coincide |
Guardar la Base setup actualiza las reglas de reescritura de WordPress.
Valores derivados automáticamente
POM Translate no ofrece aquí un campo normal para:
- una definición de configuración regional personalizada arbitraria;
- un prefijo de URL editable por idioma;
- una configuración regional de contenido alternativa separada;
- una configuración regional de origen por entrada;
- un interruptor de activado/desactivado dentro de cada fila de idioma.
Las filas adicionales se activan por estar presentes. Elimina la fila para retirar la configuración regional de la lista efectiva.
Los prefijos de URL se derivan de las configuraciones regionales configuradas y se mantienen únicos. El contenido que falta recurre directamente al valor de origen canónico, no a la alternativa de redirección.
Orden efectivo de idiomas
La lista de idiomas disponibles se construye de la siguiente manera:
main locale
then each unique additional locale in repeater orderLos valores vacíos, las configuraciones regionales duplicadas y una fila adicional igual a la configuración regional principal se ignoran. Por lo tanto, la configuración regional principal permanece en primer lugar aunque su campo de solo lectura no se pueda arrastrar al repetidor.
Este orden lo utiliza el contexto del selector y puede decidir qué variante regional coincide con un idioma general del navegador.
Resolución de etiquetas
Cuando POM Translate necesita un nombre de configuración regional legible, utiliza:
- la etiqueta personalizada configurada;
- la etiqueta local de la definición del idioma;
- la etiqueta en inglés de la definición;
- el código de configuración regional sin procesar.
Una etiqueta personalizada cambia únicamente la presentación. No cambia la configuración regional, el prefijo, la definición de la bandera, el almacenamiento de traducciones ni los metadatos del idioma.
Validación de la alternativa de redirección
El selector de alternativa se construye a partir de las configuraciones regionales actualmente configuradas. En tiempo de ejecución, POM Translate vuelve a validar el valor guardado.
Si el ajuste está vacío, no es válido o hace referencia a una configuración regional que ya no está disponible, la configuración regional de origen se convierte en la alternativa de redirección efectiva.
El campo no tiene efecto mientras Browser language detection esté desactivado.
Ajustes que se configuran en otros lugares
| Decisión | Ubicación |
|---|---|
| Configuración regional de origen | Settings → General → Site Language |
| Tipos de contenido y campos traducibles | Settings → POM Translate → Content types |
| Slugs específicos de configuración regional | Translations → Translate URLs |
| Formato y marcado del selector | Settings → POM Translate → Languages setup → Language switcher |
| Exclusiones de idioma para contenido específico | Translations → Translation exclusions |
| Texto de destino manual | Translations → Translate contents |
Comportamiento en multisitio
Cada sitio tiene su propia configuración regional de WordPress y su propio contexto de ajustes de POM Translate. Configura los idiomas principal y adicionales en el sitio cuyas rutas públicas afectan.
Una configuración regional habilitada en un subsitio no se convierte automáticamente en un destino en todos los sitios de la red. Comprueba de forma independiente la URL de inicio de cada sitio, la política de prefijos, los selectores y el espacio de nombres de caché.
Verificación de la configuración
Después de guardar:
- recarga Base setup y confirma que todos los valores se han guardado;
- confirma que cada destino aparece una vez y en orden;
- inspecciona el prefijo generado para cada configuración regional;
- abre las URL de inicio de origen y de destino sin haber iniciado sesión;
- verifica que los selectores usan las etiquetas previstas;
- comprueba que la alternativa de redirección pertenece a la lista disponible;
- guarda Settings → Permalinks solo si el enrutamiento sigue sin actualizarse después del guardado normal de ajustes;
- borra las cachés afectadas de página completa y de CDN.
Usa las guías específicas de este capítulo antes de cambiar un ajuste en un sitio público establecido.