La compatibilidad de Avada Builder con WPML está garantizada a través del archivo de configuración de idioma. Le mostraremos cómo utilizar 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 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
- 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 utilizando Avada Builder. Incluiremos algunos módulos, como un Text Block, una Alert y un Flip Box.
Para traducir la entrada, localice la caja Idioma en la barra lateral derecha y haga clic en el icono del signo más junto al idioma al que desea traducir la entrada.
Esto le llevará al Editor de traducción avanzado, donde podrá traducir su página. Haga clic en el icono del signo más junto a cada línea para añadir las traducciones. Cuando haya terminado con todas, haga clic en el botón Completo.
Actualizar el archivo de configuración de idioma
Es posible que deba 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. A continuación, 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, se debe configurar WPML para que identifique los shortcodes y los 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 en nuestros servidores. Está configurado para anular el archivo de configuración local ubicado 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 la sintaxis del archivo de configuración de idioma visitando nuestra página sobre los archivos de configuración de idioma.
A modo de 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 solo 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 de tipo 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.
Deberá comenzar anulando el archivo de configuración de idioma remoto con el actualizado. Para ello:
- Vaya a WPML → Configuració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 los nuevos módulos. En caso de que haya actualizado algunos atributos de módulos existentes, añádalos también a la página. Para fines de demostración, crearemos una página con el módulo Button asumiendo que se ha añadido recientemente a Avada Builder.
- Desde la caja Idioma, haga clic en el icono del signo más para traducir la página.
- Se le llevará al Editor de traducción avanzado, donde puede hacer clic en el icono del signo más junto a cada línea para traducir los elementos textuales del módulo.
- Si desea 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 Completo 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 terminadas las pruebas, envíe una solicitud de fusión a nuestro repositorio. Nuestros desarrolladores de compatibilidad recibirán su solicitud y la revisarán.