La compatibilidad de Avada Builder con WPML se asegura mediante el archivo de configuración de idioma. Le mostraremos cómo usar y actualizar este archivo para mantener la compatibilidad.
Esta documentación está dirigida al equipo de desarrollo de Avada y a los desarrolladores web que utilizan Avada. Si usted es un cliente que busca traducir un sitio creado con Avada, consulte nuestra página de documentación sobre la creación de sitios multilingües con Avada y WPML.
Primeros pasos
Antes de empezar, asegúrese de tener lo siguiente instalado y activado en su sitio:
- El tema Avada (se abre en una pestaña nueva)
- El plugin núcleo de WPML y el plugin WPML Traducción de cadenas
Cómo funciona la integración de Avada Builder con WPML
Para entender cómo funciona Avada Builder con WPML, comencemos creando una entrada sencilla usando Avada Builder. Incluiremos algunos módulos, como un Bloque de texto, una Alerta y un Flip Box.
Para traducir la entrada, localice la caja Idioma en la barra lateral derecha y haga clic en el icono más junto al idioma al que quiera traducir la entrada.
Esto le llevará al Editor de traducción avanzado, donde podrá traducir su página. Haga clic junto a cada línea para añadir su traducción. Cuando haya terminado con todas, haga clic en Guardar y completar.
Actualizar el archivo de configuración de idioma
Es posible que necesite actualizar los shortcodes del maquetador visual en el archivo de configuración de idioma por diferentes motivos:
- Añadir un nuevo shortcode al maquetador visual
- Añadir un nuevo atributo a un shortcode existente
- Eliminar un shortcode obsoleto
Puede descargar el archivo de configuración de idioma desde nuestro repositorio (se abre en una pestaña nueva). Luego, puede añadir los nuevos shortcodes o atributos a los shortcodes existentes en el archivo de configuración de idioma.
Estructura de los shortcodes del maquetador visual en el archivo de configuración de idioma
Para extraer cadenas de las páginas creadas con Avada Builder y cargarlas en el Editor de traducción avanzado, WPML debe estar configurado para identificar los shortcodes y atributos que contienen las cadenas que requieren traducción.
Esto se hace añadiendo un archivo, llamado wpml-config.xml, que normalmente se coloca en la carpeta raíz de su tema. Para Avada, alojamos el archivo de configuración de idioma (se abre en una pestaña nueva) en nuestros servidores. Está configurado para anular el archivo de configuración local situado en la carpeta raíz de Avada, lo que garantiza que el archivo de configuración esté siempre actualizado.
El archivo wpml-config.xml también se utiliza para configurar los siguientes elementos:
- Campos personalizados
- Taxonomías personalizadas
- Textos de administración / wp_options
- Configuración del selector de idiomas
- Shortcodes del maquetador visual
Puede obtener más información sobre la estructura y sintaxis del archivo de configuración de idioma visitando nuestra página sobre archivos de configuración de idioma.
Como ejemplo, veamos cómo añadimos el shortcode Flip Box al archivo wpml-config.xml:
Ejemplo de los shortcodes de Avada Builder en el archivo de configuración de idioma
<shortcodes>
<shortcode>
<tag>fusion_flip_box</tag>
<attributes>
<attribute>title_front</attribute>
<attribute>title_back</attribute>
<attribute>text_front</attribute>
<attribute>image</attribute>
</attributes>
</shortcode>
</shortcodes>La estructura del ejemplo anterior se puede desglosar de la siguiente manera:
- Todos los shortcodes están envueltos con la etiqueta shortcodes
- La etiqueta shortcode envuelve todas las etiquetas que pertenecen a un único shortcode.
- La etiqueta tag define el nombre del shortcode, que en este caso es fusion_flip_box.
- Los shortcodes pueden tener uno o más atributos, por lo que los envolvemos en la etiqueta attributes (plural) y usamos la etiqueta attribute (singular) para definir el título de cada atributo. En este caso, tenemos title_front, title_back, text_front y la image.
Para los shortcodes que incluyen atributos de enlace, puede hacer que los enlaces internos apunten automáticamente a la versión traducida de esa entrada utilizando la opción type para el atributo. Aquí tiene un ejemplo:
Ejemplo de shortcodes de Avada Builder que incluyen atributos de enlace
<shortcode>
<tag>fusion_soundcloud</tag>
<attributes>
<attribute type="link">url</attribute>
</attributes>
</shortcode>Probar el archivo de configuración de idioma actualizado
Para probar el archivo de configuración de idioma actualizado, confirme que tiene Avada, el plugin núcleo de WPML y WPML Traducción de cadenas instalados y activados en su sitio.
Tendrá que empezar por anular el archivo de configuración de idioma remoto con el actualizado. Para ello:
- Vaya a WPMLConfiguración y haga clic en la pestaña Configuración XML personalizada. Pegue el contenido de su archivo de configuración de idioma actualizado en el editor y haga clic en Guardar.
- Cree una nueva página y añádale el nuevo módulo (o módulos). En caso de que haya actualizado algunos atributos para módulos existentes, añádalos también a la página. Para fines de demostración, crearemos una página con el módulo Botón y asumiremos que se acaba de añadir a Avada Builder.
- Desde la caja Idioma, haga clic en el icono más para traducir la página.
- Se le dirigirá al Editor de traducción avanzado, donde podrá hacer clic junto a cada uno de los textos del módulo para introducir su traducción.
- Si quiere traducir el enlace del botón, empiece a escribir el nombre de la URL en la barra de búsqueda Buscar origen en la parte superior de la página. Recuerde hacer clic en el botón Guardar y completar cuando haya terminado de añadir las traducciones.
Para ver si la página traducida muestra todas las cadenas traducidas y si el archivo de configuración de idioma actualizado funciona correctamente, puede echar un vistazo a su página recién traducida en el front-end.
Obtener ayuda
En caso de que encuentre algún problema, póngase en contacto con nuestro equipo de desarrollo de compatibilidad. Estarán encantados de ayudarle a revisar los problemas relacionados con el archivo de configuración de idioma.
Una vez que haya terminado con las pruebas, envíe un merge request a nuestro repositorio (se abre en una pestaña nueva). Nuestros desarrolladores de compatibilidad recibirán sus solicitudes y las revisarán.
