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.
Un plugin imprescindible suele ser un único archivo PHP en la carpeta wp-content/mu-plugins. Para un plugin imprescindible, coloque wpml-config.xml en una carpeta que tenga el mismo nombre que el archivo del plugin, sin .php. Por ejemplo, para wp-content/mu-plugins/my-plugin.php, WPML lee wp-content/mu-plugins/my-plugin/wpml-config.xml.
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 todos y cada uno de los usuarios no tengan 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í (se abre en una pestaña nueva). 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 (se abre en una pestaña nueva). Esto se aplica a ambos, a los archivos de configuración de idiomas dentro de la carpeta raíz del tema o plugin y a los archivos de configuración de idiomas alojados en nuestros servidores.
Configurar las 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 necesite 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á diseñado para utilizarse 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 varios elementos utilizando el archivo wpml-config.xml. Utilice las siguientes guías para encontrar información adicional e instrucciones sobre cómo hacer traducibles elementos específicos del sitio:
- 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 usando el archivo de configuración de WPML
- Registrar términos personalizados, tipos de contenido y taxonomías como traducibles
- Hacer traducibles los bloques personalizados de Gutenberg
- Traducir textos que el tema y los plugins guardan en wp_options
- Personalizar el selector de idiomas de WPML usando el archivo de configuración de WPML
- Activar valores numéricos para su traducción
Usar el 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 configura el tipo de contenido personalizado “Property” para que sea traducible.
Si está utilizando un tema hijo y desea configurar el tipo de contenido personalizado “Property” para que no sea traducible, navegue 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, establezca el valor del atributo translate en 0 en lugar de 1.
La configuración en la pestaña Configuración XML personalizada tiene prioridad sobre la configuración en el archivo de configuración de idiomas del tema padre.
