La compatibilidad de Avia Layout Builder con WPML se asegura a través del archivo de configuración de idioma. Aprenda a usar 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 usan Enfold.
Cómo funciona la integración de Avia Layout Builder con WPML
Para entender cómo funciona Avia Layout Builder con WPML, empecemos creando una página sencilla usando 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 Guardar y completar.
Ahora, cuando vemos 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:
- 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). 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 (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 Enfold, lo que garantiza que el archivo de configuración esté siempre actualizado.
El archivo wpml-config.xml también se usa 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
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 hemos añadido 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 usando la opción de tipo “link” para el atributo, tal 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:
- Configure una instalación con Enfold y WPML activados. Active los complementos Traducción de cadenas y Traducción de medios.
- Debe anular el archivo de configuración de idioma remoto con el actualizado. Para ello, vaya a la página WPMLConfiguració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.
- Cree una nueva página y añádale los nuevos módulos. Si ha actualizado algunos atributos para módulos existentes, añádalos también a la página. En este ejemplo, supondremos que el módulo Button se ha añadido recientemente a Avia Layout Builder. Añádalo a la página y haga clic en Publicar.
- Haga clic en el icono más para traducir la página. Esto le llevará a la pantalla del Editor de traducción avanzado.
- Asegúrese de que el texto del módulo se muestra en el Editor de traducción avanzado.
- Añada sus traducciones y, a continuación, haga clic en Guardar y completar para guardar y aplicar las traducciones.
- 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 a nuestro repositorio (se abre en una pestaña nueva). Nuestros desarrolladores de compatibilidad recibirán su solicitud y la revisarán.
