Comprende los prefijos de idioma en las URL

Un prefijo de idioma es el primer segmento de la ruta que identifica la configuración regional activa, como /fr/. POM Translate genera estos prefijos a partir de la lista de configuraciones regionales configuradas y los mantiene únicos.

No existe un campo de prefijo por idioma habitual en la configuración Base.

Los prefijos estándar usan el código de idioma

Cuando una configuración regional configurada utiliza un idioma de dos letras, POM Translate normalmente usa ese código:

fr_FR → /fr/
de_DE → /de/
it_IT → /it/

Los idiomas adicionales siempre requieren un prefijo. La configuración regional principal lo requiere únicamente cuando Use a subdirectory for the default language está habilitada.

Las colisiones regionales usan prefijos específicos

Dos configuraciones regionales no pueden ser propietarias de /en/. Cuando más de una configuración regional configurada comparte el mismo idioma de dos letras, POM Translate deriva un prefijo más específico a partir de la configuración regional completa:

en_GB + en_US
→ /en-gb/ + /en-us/

La misma regla se aplica a otros grupos de idiomas regionales. Los valores generados se normalizan, se comparan con los prefijos ya en uso y se hacen únicos.

Por lo tanto, añadir o eliminar un idioma regional hermano puede cambiar el prefijo generado de una configuración regional ya establecida. Trata los cambios en la lista de idiomas regionales como migraciones de URL.

Las etiquetas y los prefijos son independientes

Cambiar Custom language label de English (UK) a English no cambia /en-gb/.

La configuración regional controla el prefijo. La etiqueta controla la presentación. El slug traducido de una entrada controla un segmento posterior:

/en-gb/seasonal-menu/
│       └─ localized post slug
└─ generated locale prefix

Edita el segmento de la entrada en Translations → Translate URLs, no en los ajustes de idioma.

Los prefijos seleccionan el contexto de la solicitud

Para una solicitud localizada entrante, POM Translate:

1. compara el primer segmento de la ruta con el mapa de prefijos configurado;
2. selecciona la configuración regional coincidente;
3. almacena esa configuración regional válida como la preferencia del visitante;
4. elimina la capa de idioma de la ruta utilizada para la resolución del objeto;
5. asigna las bases y slugs localizados de vuelta a un objeto canónico de WordPress.

Un prefijo reconocido explícito es determinante. La detección del navegador no lo sustituye.

Guarda y actualiza el enrutamiento

Guardar Languages setup → Base setup vacía las reglas de reescritura de WordPress. Prueba las rutas inmediatamente después de:

• añadir una configuración regional;
• eliminar una configuración regional;
• añadir o eliminar un idioma regional hermano;
• cambiar la política de prefijo del idioma principal.

Si WordPress sigue usando reglas obsoletas, guarda Settings → Permalinks una vez e inspecciona las capas de redirección, seguridad, caché de páginas y CDN.

Planifica los cambios de prefijo como migraciones públicas

Antes de cambiar una configuración que produce prefijos:

1. enumera las URL de origen y destino importantes;
2. registra las rutas de destino indexadas y enlazadas externamente;
3. prepara redirecciones permanentes desde las rutas antiguas;
4. actualiza menús, selectores, sitemaps, URL canónicas y alternativas;
5. purga las entradas antiguas de la página y del CDN;
6. verifica que la nueva ruta resuelva el mismo objeto canónico;
7. mantén las cadenas de redirección en un solo salto.

No confíes en que un prefijo eliminado siga seleccionando su antiguo idioma. Una vez que una configuración regional no está disponible, ese primer segmento ya no se reconoce como su contexto de POM Translate.

Verifica cada prefijo

Para cada configuración regional:

• la ruta de la portada usa el primer segmento esperado;
• dos variantes regionales tienen prefijos distintos;
• las URL de origen y destino resuelven el mismo objeto canónico;
• el idioma del documento coincide con el prefijo;
• los enlaces del selector usan la misma ruta generada;
• los metadatos canónicos y de idiomas alternativos coinciden;
• las rutas antiguas redirigen después de una migración;
• las cachés de página y las claves del CDN permanecen separadas por la ruta de la configuración regional.

Lee Choose the main-language URL policy para conocer la única decisión de prefijo expuesta directamente en la configuración Base.