Configurar los idiomas del sitio
La lista de idiomas define qué locales puede renderizar POM Translate, mostrar en los selectores, aceptar en los flujos de trabajo de traducción y resolver mediante URLs localizadas. Configúrala antes de traducir un conjunto grande de contenido o de publicar enlaces a idiomas de destino.
Abre:
Settings → POM Translate → Languages setup → Base setup
El locale de origen proviene de WordPress. POM Translate añade los locales de destino y controla sus etiquetas públicas, el orden, la política de prefijos y la redirección opcional según el navegador.
Planificar el contrato de idiomas
Para cada locale previsto, decide:
- la variante exacta del locale, como
en_GBoen_US; - si es el origen canónico o un idioma adicional;
- el nombre público que los visitantes deben ver;
- su posición en los selectores;
- el prefijo de URL generado para él;
- si hay suficiente contenido listo para una ruta pública;
- qué ocurre con las URLs antiguas si el locale se elimina más adelante.
Un código de idioma no es solo una etiqueta. Influye en el contexto de la solicitud, el locale del software, la dirección de la traducción automática, los valores de lang y hreflang, el contexto de pedido de WooCommerce y la ruta pública.
Elegir la guía pertinente
| Objetivo | Guía |
|---|---|
| Establecer el locale de origen canónico | Elegir el idioma principal |
| Añadir uno o varios locales de destino admitidos | Añadir idiomas adicionales |
| Entender si se puede crear un locale arbitrario | Comprender el soporte de idiomas personalizados |
| Cambiar los nombres mostrados a los visitantes | Configurar las etiquetas públicas de idioma |
| Controlar la secuencia del selector y las coincidencias ambiguas del navegador | Ordenar los idiomas |
| Entender los prefijos de ruta generados automáticamente | Comprender los prefijos de URL de idioma |
| Decidir si el idioma de origen también usa un prefijo | Elegir la política de URL del idioma principal |
| Redirigir a los visitantes nuevos según la preferencia del navegador | Configurar la detección del idioma del navegador |
| Elegir el destino cuando ningún idioma del navegador coincide | Configurar la alternativa de redirección del navegador |
| Revisar cada campo de la pantalla de ajustes | Referencia de configuración de idiomas |
| Retirar un locale sin perder el control de sus URLs ni de sus datos | Eliminar un idioma de forma segura |
Secuencia de configuración recomendada
- Establece Settings → General → Site Language en el locale de origen canónico.
- Guarda y confirma que Main language muestra ese locale en POM Translate.
- Añade un Additional language usando la variante regional exacta requerida.
- Añade etiquetas personalizadas opcionales para el idioma principal y los de destino.
- Arrastra los idiomas adicionales al orden previsto del selector.
- Decide si el idioma principal debería usar su propio subdirectorio.
- Deja Browser language detection desactivada durante las pruebas de rutas.
- Elige un Fallback language for redirects válido.
- Guarda la sección de configuración Base.
- Prueba las URLs de origen y de destino en una ventana privada del navegador.
- Traduce y revisa una entrada representativa antes de añadir más locales.
- Activa la detección del navegador solo cuando las rutas explícitas y los selectores sean estables.
Guardar la configuración Base refresca las reglas de reescritura de WordPress, porque los prefijos disponibles y la política del idioma predeterminado pueden cambiar el enrutamiento público.
Qué cambia al añadir un locale
Un locale adicional pasa a formar parte de la lista de idiomas disponibles de POM Translate. Esa lista la usan las pantallas de traducción, la validación de locales, los selectores, la generación de URLs localizadas, las alternativas de SEO, las claves de caché y las integraciones dinámicas admitidas.
Añadir el locale no:
- traduce el contenido existente;
- revisa el texto generado automáticamente;
- crea entradas o términos duplicados;
- garantiza que cada slug localizado haya sido aprobado;
- hace que una ruta pública incompleta sea apta para el lanzamiento.
Usa exclusiones por tema y la planificación del selector cuando un idioma configurado no esté listo en todas partes.
Qué significa «alternativa» en este capítulo
No deben confundirse dos alternativas:
- Alternativa de contenido: un valor de destino vacío o estructuralmente no válido muestra su valor de origen.
- Alternativa de redirección del navegador: cuando la detección opcional del navegador no encuentra ninguna coincidencia configurada, el visitante es enviado al locale configurado seleccionado.
El ajuste Fallback language for redirects controla solo el segundo comportamiento. No crea una cadena de traducción como francés → inglés → español.
Verificar el estado completo de los idiomas
Para cada locale configurado, confirma:
- que aparece una vez en la posición prevista del selector;
- que su etiqueta y su significado regional son correctos;
- que su prefijo generado es único;
- que las rutas de origen y de destino seleccionan el locale esperado;
- que la política de prefijos del idioma principal está canonicalizada;
- que la detección del navegador no anula una ruta explícita;
- que la alternativa de redirección sigue configurada;
- que el contenido traducido, los enlaces, los metadatos de SEO y las cachés coinciden.
Continúa con Elegir el idioma principal al configurar un sitio nuevo.