Mantener la compatibilidad de Avia Layout Builder (Enfold) con WPML

La compatibilidad de Avia Layout Builder con WPML se asegura mediante el archivo de configuración de idioma. Aprenda a utilizar este archivo para mantener la compatibilidad.

Esta página está dirigida al equipo de desarrollo de Enfold, a los desarrolladores que ofrecen una versión personalizada del maquetador visual, a los autores que desarrollan complementos para Avia Layout Builder y a los desarrolladores web que utilizan Enfold.

Cómo funciona la integración de Avia Layout Builder con WPML

Para entender cómo funciona Avia Layout Builder con WPML, comencemos por crear una página sencilla utilizando Avia Layout Builder. Incluiremos algunos módulos, como un Text Block, un Icon Box y un Button.

Estos módulos envuelven el contenido en shortcodes:

Para traducir la página que hemos creado, haga clic en el icono más que se encuentra en la caja meta de idiomas de la barra lateral.

Esto abre la página en el Editor de traducción avanzado, donde puede traducir su página. Añada sus traducciones y haga clic en Completo.

Ahora, al ver la página traducida en el front-end, podemos ver el contenido traducido.

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:

1. Añadir un nuevo shortcode al maquetador visual
2. Añadir un nuevo atributo a un shortcode existente
3. Eliminar un shortcode obsoleto

Puede descargar el archivo de configuración de idioma desde nuestro repositorio. Añada los shortcodes o atributos a los shortcodes existentes dentro del archivo de configuración de idioma.

Estructura de los shortcodes del maquetador visual en el archivo de configuración de idioma

Para extraer las cadenas de las páginas creadas con Avia Layout Builder y cargarlas en la pantalla del Editor de traducción, necesitamos configurar WPML para que identifique 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 Enfold, alojamos el archivo de configuración de idioma en nuestros servidores. Está configurado para anular el archivo de configuración local situado en la carpeta raíz de Enfold, 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:

1. Campos personalizados
2. Taxonomías personalizadas
3. Textos de administración / wp_options
4. Configuración del selector de idiomas
5. Shortcodes del maquetador visual

Consulte nuestra documentación detallada para obtener más información sobre la estructura y sintaxis del archivo de configuración de idioma.

Como ejemplo, veamos cómo añadimos el shortcode Button al archivo wpml-config.xml:

<wp-config>
   <shortcodes>
      <shortcode>
         <tag>av_button</tag>
         <attributes>
            <attribute>label</attribute>
            <attribute type="link" encoding="av_link">link</attribute>
         </attributes>
      </shortcode>
   </shortcodes>
</wp-config>

La estructura del ejemplo anterior se puede desglosar de la siguiente manera:

• Todos los shortcodes están envueltos con la etiqueta principal shortcodes (plural).
• La etiqueta shortcode (singular) envuelve todas las etiquetas que pertenecen a un único shortcode.
• La etiqueta tag define el nombre del shortcode, que en este caso es av_button.
• Los shortcodes pueden tener uno o más atributos; por lo tanto, 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 los atributos label y link.

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 “link” para el atributo, tal y como se muestra en el ejemplo anterior.

Probar el archivo de configuración de idioma

Para probar el archivo de configuración de idioma actualizado, siga estos pasos:

1. Configure una instalación con Enfold y WPML activados. Active los complementos Traducción de cadenas y Traducción de medios.
2. Debe anular el archivo de configuración de idioma remoto con el actualizado. Para ello, vaya a la página WPML → Configuración y haga clic en la pestaña Configuración XML personalizada. Copie el contenido de su archivo de configuración de idioma actualizado en el editor y haga clic en Guardar.

3. Cree una nueva página y añádale los nuevos módulos. Si ha actualizado algunos atributos de módulos existentes, añádalos también a la página. En este ejemplo, supondremos que el módulo Button se acaba de añadir a Avia Layout Builder. Añádalo a la página y haga clic en Publicar.

4. Haga clic en el icono más para traducir la página. Esto le llevará a la pantalla del Editor de traducción avanzado.
5. Asegúrese de que el texto del módulo se muestra en el Editor de traducción avanzado.
6. Añada sus traducciones y, a continuación, haga clic en Completo para guardar y aplicar las traducciones.

7. Compruebe la página traducida en el front-end.

La página traducida muestra todas las cadenas traducidas, lo que implica que el archivo de configuración de idioma actualizado funciona correctamente. Si tiene algún problema, póngase en contacto con nuestro equipo de desarrollo de compatibilidad. Estarán encantados de revisar los problemas relacionados con el archivo de configuración de idioma.

Una vez terminadas las pruebas, envíe una solicitud de fusión (merge request) a nuestro repositorio. Nuestros desarrolladores de compatibilidad recibirán su solicitud y la revisarán.