WPML puede leer un archivo de configuración que le indica qué necesita traducción en los temas y plugins. El archivo se llama wpml-config.xml y se coloca en la carpeta raíz del plugin o tema.
El propósito del archivo de configuración de idiomas
Como parte de lograr la compatibilidad con WPML, también debe crear un archivo de configuración que le ayudará a mantener la compatibilidad en sus futuras versiones. WPML puede traducir cualquier cosa en su sitio de WordPress, pero necesita indicarle qué necesita traducción. Este archivo hace exactamente eso.
Vaya a la página WPML → Configuración.
Esta página le indica a WPML todo lo que necesita saber, incluyendo qué campos personalizados traducir o sincronizar, qué tipos de contenido personalizados y taxonomías deben ser multilingües, e incluso qué textos de administración traducir.
El archivo de configuración de idiomas incluye esta información para que cada usuario no tenga que introducirla manualmente en la página de administración.
Para algunos de los temas y plugins, alojamos los archivos de configuración de idiomas en nuestros servidores. Puede ver una lista aquí. Está configurado para anular el archivo de configuración de idiomas local que se encuentra dentro de la carpeta raíz del tema o plugin.
WPML también le permite anular manualmente cualquier configuración cargada por los archivos de configuración de idiomas de temas y plugins. Esto se aplica tanto a los archivos de configuración de idiomas dentro de la carpeta raíz del tema o plugin como a los archivos de configuración de idiomas alojados en nuestros servidores.
Configurar opciones de traducción para temas y plugins de terceros
WPML es compatible con muchos temas y plugins populares y para ellos, no necesita crear un archivo de configuración de idiomas.
Sin embargo, si está utilizando un tema o plugin cuyo contenido no aparece correctamente en el Editor de traducción avanzado de WPML, es posible que deba configurar sus opciones de traducción manualmente.
Para configurar las opciones de traducción para temas y plugins de terceros, vaya a WPML → Configuración y haga clic en la pestaña Configuración XML personalizada. Utilice el editor de texto de esta página para introducir el código tal como lo haría si estuviera creando un archivo wpml-config.xml.
Generar el archivo wpml-config.xml automáticamente
Si no está familiarizado con la creación de archivos XML, nuestro equipo ha creado el plugin Herramientas multilingües que facilita esta tarea. Aunque inicialmente se concibió como una herramienta para ayudar a los autores de temas y plugins a hacer que sus productos sean Multilingual Ready (preparados para ser multilingües), se puede utilizar fácilmente para generar su propio archivo wpml-config.xml.
Para obtener más información sobre cómo generar su archivo wpml-config.xml, visite la página del plugin Herramientas multilingües. Específicamente, busque en la sección ¿Cómo genero archivos de configuración de idiomas utilizando Herramientas multilingües?
Una vez que tenga el archivo de configuración, añádalo a la raíz de la carpeta de su tema. Si ya tiene uno, no lo sobrescriba. En su lugar, edite su archivo XML original y añada el código generado con el plugin Herramientas multilingües.
Tenga en cuenta que este plugin no está pensado para usarse en sitios de producción en vivo.
Para leer este tutorial y crear archivos de configuración de idiomas para sus temas y plugins, puede empezar con este de ejemplo: wpml-config.zip.
Tendrá que editarlo, pero puede utilizar las secciones y la estructura de este archivo.
Estructura y sintaxis
WPML le permite configurar una serie de elementos utilizando el archivo wpml-config.xml. Utilice las siguientes guías para encontrar información adicional e instrucciones sobre cómo hacer que elementos específicos del sitio sean traducibles:
- Traducir shortcodes personalizados con WPML
- Registrar el contenido del maquetador visual para su traducción
- Registrar widgets personalizados del maquetador visual para su traducción
- Configurar opciones de traducción para campos personalizados mediante el archivo de configuración de WPML
- Registrar términos, tipos y taxonomías personalizados como traducibles
- Hacer que los bloques personalizados de Gutenberg sean traducibles
- Traducir textos que los temas y plugins guardan en wp_options
- Personalizar el selector de idiomas de WPML utilizando el archivo de configuración de WPML
- Activar valores numéricos para su traducción
Uso del archivo de configuración de idiomas de WPML con temas hijos
Si está utilizando un tema hijo, el archivo de configuración de idiomas del tema padre anula el que se encuentra en el tema hijo. WPML proporciona una página de configuración que le permite anular esto fácilmente con cualquier configuración personalizada.
Consideremos un ejemplo en el que el archivo de configuración de idiomas del tema padre establece que el tipo de contenido personalizado “Property” sea traducible.
Si está utilizando un tema hijo y desea que el tipo de contenido personalizado “Property” no sea traducible, vaya a la página WPML → Configuración y haga clic en la pestaña Configuración XML personalizada. Utilice el editor para configurar el tipo de contenido personalizado “Property” como no traducible. Simplemente, cambie el valor del atributo translate a 0 en lugar de 1.
La configuración de la pestaña Configuración XML personalizada tiene prioridad sobre la configuración del archivo de configuración de idiomas en el tema padre.
