Configurar la detección de idioma del navegador

La detección de idioma del navegador puede redirigir una primera visita válida sin prefijo a una configuración regional determinada. Es una comodidad de enrutamiento, no un servicio de traducción: no crea contenido traducido ni modifica una URL de idioma explícita.

Configura rutas de idioma estables y selectores antes de activarla.

Activar la detección

Abre:

Settings → POM Translate → Languages setup → Base setup

Después:

1. confirma el Main language;
2. revisa el orden de los Additional languages;
3. activa Browser language detection;
4. elige Fallback language for redirects;
5. guarda la configuración base;
6. prueba en una sesión de navegación privada.

La función no tiene un destino útil a menos que la configuración regional prevista ya esté en la lista de idiomas configurados.

Comprender la prioridad de las solicitudes

POM Translate resuelve una solicitud válida sin prefijo en este orden:

1. una preferencia de idioma válida seleccionada previamente por el visitante;
2. la mejor coincidencia configurada a partir de la cabecera Accept-Language del navegador;
3. Fallback language for redirects;
4. el idioma principal si la alternativa configurada ya no es válida.

Un prefijo reconocido omite esta elección y selecciona su propia configuración regional. Visitar /fr/…, por ejemplo, sigue siendo una solicitud en francés aunque el navegador prefiera español.

Una preferencia del visitante se almacena cuando este sigue una ruta localizada válida. Puede seguir vigente hasta un año, por lo que cambiar solo las preferencias del navegador puede no reproducir una primera visita.

Cómo se comparan los idiomas del navegador

Primero gana una coincidencia exacta de configuración regional. Si el sitio ofrece en_GB y el navegador solicita esa configuración regional, POM Translate la selecciona.

Si no hay una coincidencia exacta, POM Translate normaliza la notación regional y después considera el idioma general de dos letras. Cuando varias variantes regionales configuradas comparten ese idioma, gana la primera en el orden efectivo de idiomas. La configuración regional principal va primero; las configuraciones regionales adicionales siguen su orden en el repetidor.

Se respetan los pesos de calidad del navegador. Esto significa que un idioma configurado con mayor prioridad puede ganar aunque otro idioma aparezca antes en la cabecera sin procesar.

Usa Order languages para controlar coincidencias ambiguas de idioma general.

Solicitudes que no se redirigen

La detección automática es deliberadamente limitada. No redirige:

• solicitudes que ya contienen un prefijo de idioma reconocido;
• solicitudes que no son GET ni HEAD;
• los puntos de conexión de administración, acceso, AJAX, cron, REST, XML-RPC o comentarios de WordPress;
• solicitudes de feed;
• rutas que parecen archivos porque contienen un punto;
• bots y rastreadores reconocidos.

Estas exclusiones evitan que la negociación de idioma interfiera con solicitudes que cambian estado, APIs, activos, tráfico administrativo y el rastreo de motores de búsqueda.

Cuando la detección elige otra configuración regional, POM Translate emite una redirección temporal al equivalente localizado de la ruta solicitada. Los parámetros de consulta se conservan mediante el generador de URL localizadas cuando es compatible.

Probar sin una preferencia antigua

Usa una ventana privada o borra la preferencia de idioma del sitio antes de cada prueba de primera visita.

Ejecuta esta matriz:

Prueba también el mismo contenido tras seleccionar manualmente un idioma distinto. La elección guardada del visitante debe tener prioridad sobre la cabecera del navegador en posteriores visitas válidas sin prefijo.

Evitar bucles de redirección y sorpresas

Antes del lanzamiento:

• verifica que cada prefijo configurado sea único;
• confirma que las rutas de origen y destino resuelvan el mismo objeto canónico;
• asegúrate de que las reglas de redirección externas no envíen rutas localizadas de vuelta a rutas sin prefijo;
• excluye las entradas de caché de página de ser compartidas entre distintos resultados de redirección;
• prueba detrás del CDN o proxy inverso real;
• mantén los selectores disponibles para que los visitantes puedan anular la detección automática.

Si la detección causa una navegación inesperada, desactiva Browser language detection manteniendo activas las URL de idioma explícitas. Esto aísla la negociación de la traducción y el enrutamiento.

Lee Configure the browser redirect fallback antes de elegir el destino sin coincidencia.