WPML puede leer un archivo de configuración que le indica qué necesita traducción en temas y plugins. El archivo se llama wpml-config.xml y se coloca en la carpeta raíz del plugin o tema.
Finalidad del archivo de configuración de idioma
Como parte de lograr la compatibilidad con WPML, también deberías crear un archivo de configuración que te ayudará a mantener la compatibilidad en tus futuras versiones. WPML puede traducir cualquier cosa en tu sitio WordPress, pero necesitas indicarle qué necesita traducción. Este archivo lo hace.
Ve a la página WPML → Configuración.
Página de Configuración de WPML
Esta página le dice a WPML todo lo que necesita saber, incluyendo qué campos personalizados traducir o sincronizar, qué publicaciones y taxonomías personalizadas deben ser multilingües e incluso qué textos de administración traducir.
El archivo de configuración de idioma incluye esta información para que cada usuario no tenga que ingresarla manualmente en la página de administración.
Para algunos temas y extensiones, alojamos los archivos de configuración de idioma en nuestros servidores. Puedes ver una lista aquí. Está configurado para anular el archivo de configuración de idioma local que se coloca dentro de la carpeta raíz del tema o plugin.
Configuración de opciones de traducción para temas y extensiones de terceros
WPML es compatible con muchos temas y plugins populares y para ellos, no necesitas crear un archivo de configuración de idioma.
Sin embargo, si estás usando un tema o plugin cuyo contenido no aparece correctamente en el Editor de Traducción Avanzada de WPML, es posible que necesites configurar manualmente sus opciones de traducción.
Para configurar las opciones de traducción para temas y plugins de terceros, ve a WPML → Configuración y haz clic en la pestaña Configuración XML Personalizada. Usa el editor de texto en esta página para ingresar el código tal como lo harías si estuvieras creando un archivo wpml-config.xml.
Configuración de las opciones de traducción para temas y extensiones de terceros en la Pestaña Configuración XML personalizada
Generar automáticamente el archivo wpml-config.xml
Si no estás familiarizado con la creación de archivos XML, nuestro equipo ha creado el plugin Multilingual Tools que facilita esta tarea. Aunque inicialmente fue concebido como una herramienta para ayudar a los autores de temas y plugins a hacer que sus productos sean multilingües, puede usarse fácilmente para generar tu propio archivo wpml-config.xml.
Para aprender más sobre cómo generar tu archivo wpml-config.xml, visita la página del plugin Multilingual Tools. Concretamente, busca en la sección ¿Cómo genero archivos de configuración de idioma utilizando herramientas multilingües?
Una vez que tengas el archivo de configuración, agrégalo a la raíz de la carpeta de tu tema. Si ya tienes uno, no lo sobrescribas. En su lugar, edita tu archivo XML original y agrega el código generado con el plugin Multilingual Tools.
Ten en cuenta que este plugin no está destinado a ser utilizado en sitios en vivo, de producción.
Para leer este tutorial y crear archivos de configuración de idioma para tus temas y extensiones, puedes empezar con este ejemplo – wpml-config.zip.
Tendrás que editarlo, pero puedes utilizar las secciones y la estructura de este archivo.
Estructura y sintaxis
WPML te permite configurar varios elementos usando el archivo wpml-config.xml. Usa las siguientes guías para encontrar información adicional e instrucciones sobre cómo hacer traducibles elementos específicos del sitio:
Usar el Archivo de Configuración de Idioma de WPML con Temas Hijo
Si estás usando un tema hijo, el archivo de configuración de idioma del tema padre anula el que se encuentra en el tema hijo. WPML proporciona una página de configuración que te permite anular fácilmente esto con cualquier configuración personalizada.
Consideremos un ejemplo donde el archivo de configuración de idioma del tema padre está configurando el tipo de publicación personalizada “Propiedad” para ser traducible.
El archivo de configuración de idioma del tema padre está configurando el tipo de publicación personalizada de propiedad para traducir
Si estás usando un tema hijo y deseas configurar el tipo de publicación personalizada “Propiedad” para que no sea traducible, navega a la página WPML → Configuración y haz clic en la pestaña Configuración XML Personalizada. Usa el editor para configurar el tipo de publicación personalizada “Propiedad” para que no sea traducible. Simplemente, establece el valor del atributo translate en 0 en lugar de 1.
Anulando la configuración de idioma del tema padre
Las configuraciones en la pestaña Configuración XML Personalizada tienen prioridad sobre las configuraciones en el archivo de configuración de idioma en el tema padre.
