Configurar la compatibilidad de WPML con temas y plugins de WordPress: Configuración y wpml-config.xml personalizado

Esta página existe para el resto: temas y plugins menos populares, versiones muy recientes que el autor publicó antes de que la compatibilidad de WPML se pusiera al día, y un pequeño número de ayudas genéricas para sitios que presentan síntomas específicos. La mayoría de los clientes nunca vienen aquí. Cuando lo hace, suele ser porque el Soporte de WPML le ha indicado un interruptor específico o un wpml-config.xml para pegar.

Dos subpáginas de Configuración cubren la compatibilidad, y esta página cubre ambas. Configuración > Compatibilidad contiene los interruptores para los síntomas comunes. Configuración > Configuración XML personalizada es donde escribe su propio wpml-config.xml, descrito en la segunda mitad de esta página. La interfaz de usuario para los valores predeterminados más comunes (preferencias de traducción por tipo de contenido, por taxonomía y por campo) se encuentra en una página de Configuración separada que se cubre en Qué se traduce y qué no; la mayoría de los clientes usan esa interfaz y solo vienen aquí cuando no cubre lo que necesitan.

Interruptores de compatibilidad

Abra WPML > Configuración > Compatibilidad. La página tiene cuatro tarjetas. Cada tarjeta se centra en una clase específica de problema de compatibilidad.

Opciones de localización: para temas y plugins cuyas traducciones no se cargan

Cuando un tema o plugin ya incluye sus propias traducciones de la interfaz de usuario (archivos .mo en una carpeta /languages/) pero esas traducciones no aparecen en su sitio, la tarjeta Opciones de localización tiene tres interruptores que ayudan a WPML a encontrarlas y aplicarlas.

• Cargar automáticamente el archivo .mo del tema mediante load_textdomain. Obliga a WPML a llamar a load_textdomain() para el dominio de texto del tema. Úselo cuando las traducciones del tema estén en el disco pero no aparezcan.
• Introducir el dominio de texto. Anula el dominio de texto detectado automáticamente. Algunos temas registran su dominio de texto de formas no estándar; este campo le permite especificarlo explícitamente.
• Usar dominios de texto de temas o plugins cuando las llamadas a gettext no usan un literal de cadena. Un indicador de compatibilidad para temas o plugins que usan llamadas a __() con argumentos variables en lugar de cadenas literales. WPML no puede detectarlas automáticamente, y este interruptor le ayuda a aplicar las traducciones de todos modos.

Si el Soporte de WPML le dirige aquí, le dirán qué interruptor y qué dominio de texto configurar.

Hacer que los temas funcionen de forma multilingüe

Ajustar ID para la funcionalidad multilingüe. Una capa de compatibilidad para temas que codifican suposiciones de un solo idioma (por ejemplo, un tema que almacena un «ID de imagen destacada» una vez y usa la misma imagen en todos los idiomas).

La mayoría de los temas modernos compatibles con WPML no necesitan esto. Los temas más antiguos o menos adaptados a WPML a veces sí. Actívelo si ve que las referencias de contenido (imágenes, menús, elementos destacados) se filtran incorrectamente entre idiomas.

Filtrado de idiomas para operaciones AJAX

Almacenar una cookie de idioma para admitir el filtrado de idiomas por AJAX. Algunos plugins usan AJAX para obtener contenido: listados de productos filtrados, listas de entradas paginadas por AJAX, resultados de búsqueda a medida que se escribe. Sin una cookie de idioma, el punto de enlace de AJAX no sabe en qué idioma responder y devuelve resultados en el idioma equivocado.

Active la cookie si ve este síntoma: los visitantes de la página en francés obtienen resultados en inglés de las secciones cargadas por AJAX. Es una solución de una sola casilla para toda una clase de errores.

Páginas de inicio de sesión y registro

Permitir traducir las páginas de inicio de sesión y de registro. El /wp-login.php integrado de WordPress y la pantalla de registro no forman parte del contenido habitual que traduce WPML. Viven fuera de la cadena de plantillas del tema. Este interruptor los añade al conjunto de páginas traducibles de WPML.

Si su sitio funciona en nginx, el interruptor también requiere un ajuste en la configuración del servidor. La página enlaza con la guía de nginx de WPML con el bloque de configuración exacto.

Textos de temas y plugins: Configuración aquí, analizador en otro lugar

Dos tipos de trabajo con cadenas de temas y plugins se dividen en dos pantallas:

• La configuración de esta página. Gestionan la compatibilidad de las traducciones que el tema o plugin ya incluye: load_textdomain, anulación del dominio de texto, gettext no literal.
• El analizador es su propia pantalla. Cuando necesite encontrar cadenas de temas y plugins que aún no están registradas para su traducción, use la pantalla Traducción de textos de administración. Se accede a ella desde la pestaña Cadenas en Traducciones, en la sección «¿no ve las cadenas que busca?».

Para ver el flujo de trabajo completo de análisis de cadenas, consulte Traducir cadenas.

wpml-config.xml personalizado

Los temas y plugins compatibles con WPML incluyen un archivo wpml-config.xml que le dice a WPML exactamente cuáles de sus campos, tipos de contenido, taxonomías, shortcodes y metaclaves deben ser traducibles. WPML lo lee al activarse. Para todos los temas y plugins importantes y populares, esto significa que la traducción funciona correctamente desde el primer momento. No necesita hacer nada.

Cuando el wpml-config.xml que se incluye con un tema o plugin no es suficiente para su sitio, usted escribe el suyo propio. WPML lo aplica por encima de lo que incluya el tema o plugin.

Cuándo escribiría su propio wpml-config.xml

Tres escenarios.

• Un campo que necesita traducir no está en el wpml-config.xml incluido. El autor del tema o plugin no declaró un campo personalizado como traducible, pero usted necesita que se traduzca en su sitio.
• Un campo tiene el valor predeterminado incorrecto. El wpml-config.xml incluido marca algo como Copiar y usted quiere Traducir, o viceversa.
• Está creando un tema o plugin personalizado y quiere declarar su comportamiento de traducción desde la página de Configuración de WPML en lugar de incluir un archivo wpml-config.xml con su código.

En cualquier caso, el Soporte de WPML puede dirigirle aquí con el wpml-config.xml exacto que debe pegar. Principalmente es una acción impulsada por el Soporte, ocasionalmente por el desarrollador.

Por qué editar wpml-config.xml en el panel de administración de WPML en lugar de en el archivo del tema

Podría editar el propio wpml-config.xml del tema o plugin directamente. Pero ese cambio se pierde la próxima vez que el tema o plugin se actualiza. El editor del panel de administración de WPML en WPML > Configuración > Configuración XML personalizada superpone su wpml-config.xml a lo que sea que incluya el tema o plugin, y sobrevive a las actualizaciones. Es el lugar adecuado para los ajustes específicos del sitio.

La forma de un wpml-config.xml

La página es un editor XML. Pegue un bloque <wpml-config>...</wpml-config>, guarde y WPML aplicará su wpml-config.xml.

Un wpml-config.xml mínimo que declara un shortcode como traducible:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

Los tipos de elementos que normalmente declararía:

• <custom-fields>. Marca un campo personalizado como translate, copy, copy-once o nothing.
• <custom-types>. Declara un tipo de contenido personalizado como traducible.
• <taxonomies>. Declara una taxonomía personalizada como traducible.
• <shortcodes>. Enumera los shortcodes cuyo contenido debe traducir WPML.
• <custom-term-fields>. Para los metadatos de términos.

Cada elemento tiene sus propios atributos (por ejemplo, action="translate" en un campo personalizado). Para ver la referencia completa de wpml-config.xml (cada elemento, cada atributo, cada valor permitido), consulte la Información para desarrolladores de WPML.

Un flujo de trabajo práctico

Si el Soporte de WPML le da un bloque wpml-config.xml para pegar:

1. Abra WPML > Configuración > Configuración XML personalizada.
2. Pegue su XML dentro del bloque <wpml-config> existente (o reemplace el contenido si le han dado el bloque completo).
3. Guarde.
4. WPML aplica su wpml-config.xml inmediatamente. Si declara un nuevo tipo de contenido o campo traducible, la entrada aparecerá en Configuración > Traducción de tipos de entrada / Traducción de campos personalizados de inmediato.

Si está creando un tema o plugin personalizado y quiere incluir su configuración de WPML con el código, debería poner el mismo bloque <wpml-config> en un archivo wpml-config.xml en la raíz de su tema o plugin. WPML lo lee al activarse. El editor del panel de administración es para ajustes específicos del sitio; el archivo incluido es para los propios valores predeterminados del tema o plugin.