Mantenere la compatibilità di Avia Layout Builder (Enfold) con WPML

La compatibilità di Avia Layout Builder con WPML è garantita dal file di configurazione della lingua. Scopri come utilizzare questo file per mantenere la compatibilità.

Questa pagina è destinata al team di sviluppo di Enfold, agli sviluppatori che offrono una versione personalizzata del page builder, agli autori che sviluppano componenti aggiuntivi per Avia Layout Builder e agli sviluppatori web che utilizzano Enfold.

Come funziona l’integrazione di Avia Layout Builder con WPML

Per capire come funziona Avia Layout Builder con WPML, iniziamo creando una semplice pagina utilizzando Avia Layout Builder. Includeremo alcuni moduli, come un Text Block, un Icon Box e un Button.

Questi moduli racchiudono il contenuto negli shortcode:

Per tradurre la pagina che abbiamo creato, fai clic sull’icona più che si trova nel meta-box della lingua nella barra laterale.

Questo apre la pagina nell’Editor di traduzione avanzato, dove puoi tradurre la tua pagina. Aggiungi le tue traduzioni e fai clic su Completo.

Ora, quando visualizziamo la pagina tradotta sul front-end, possiamo vedere il contenuto tradotto.

Aggiornare il file di configurazione della lingua

Potresti dover aggiornare gli shortcode del page builder nel file di configurazione della lingua per diversi motivi:

1. Aggiunta di un nuovo shortcode al page builder
2. Aggiunta di un nuovo attributo a uno shortcode esistente
3. Rimozione di uno shortcode obsoleto

Puoi scaricare il file di configurazione della lingua dal nostro repository. Aggiungi gli shortcode o gli attributi agli shortcode esistenti all’interno del file di configurazione della lingua.

Struttura degli shortcode del page builder nel file di configurazione della lingua

Per estrarre le stringhe dalle pagine create utilizzando Avia Layout Builder e caricarle nella schermata dell’Editor di traduzione, dobbiamo configurare WPML in modo che identifichi gli shortcode e gli attributi che contengono le stringhe che richiedono la traduzione. Questo si ottiene aggiungendo un file, chiamato wpml-config.xml, che in genere viene posizionato nella cartella principale del tuo tema. Per Enfold, ospitiamo il file di configurazione della lingua sui nostri server. È impostato per sovrascrivere il file di configurazione locale posizionato nella cartella principale di Enfold, assicurando che il file di configurazione sia sempre aggiornato.

Il file wpml-config.xml viene utilizzato anche per configurare i seguenti elementi:

1. Campi personalizzati
2. Tassonomie personalizzate
3. Testi admin / wp_options
4. Configurazione del selettore di lingua
5. Shortcode del page builder

Consulta la nostra documentazione dettagliata per saperne di più sulla struttura e la sintassi del file di configurazione della lingua.

Come esempio, vediamo come abbiamo aggiunto lo shortcode Button al file 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 struttura dell’esempio precedente può essere suddivisa come segue:

• Tutti gli shortcode sono racchiusi nel tag principale shortcodes (plurale).
• Il tag shortcode (singolare) racchiude tutti i tag appartenenti a un singolo shortcode.
• Il tag tag definisce il nome dello shortcode, che in questo caso è av_button.
• Gli shortcode possono avere uno o più attributi; di conseguenza, li racchiudiamo nel tag attributes (plurale) e utilizziamo il tag attribute (singolare) per definire il titolo di ciascun attributo. In questo caso, abbiamo gli attributi label e link.

Per gli shortcode che includono attributi di link, puoi fare in modo che i link interni puntino automaticamente alla versione tradotta di quell’articolo utilizzando l’opzione di tipo “link” per l’attributo, come mostrato nell’esempio precedente.

Testare il file di configurazione della lingua

Per testare il file di configurazione della lingua aggiornato, segui questi passaggi:

1. Prepara un’installazione con Enfold e WPML attivati. Attiva i componenti aggiuntivi Traduzione stringhe e Traduzione media.
2. Devi sovrascrivere il file di configurazione della lingua remoto con quello aggiornato. Per farlo, vai alla pagina WPML → Impostazioni e fai clic sulla scheda Configurazione XML personalizzata. Copia il contenuto del tuo file di configurazione della lingua aggiornato nell’editor e fai clic su Salva.

3. Crea una nuova pagina e aggiungi i nuovi moduli. Se hai aggiornato alcuni attributi per i moduli esistenti, aggiungi anche quelli alla pagina. In questo esempio, supporremo che il modulo Button sia stato appena aggiunto ad Avia Layout Builder. Aggiungilo alla pagina e fai clic su Pubblica.

4. Fai clic sull’icona più per tradurre la pagina. Questo ti porta alla schermata dell’Editor di traduzione avanzato.
5. Assicurati che il testo del modulo sia visualizzato nell’Editor di traduzione avanzato.
6. Aggiungi le tue traduzioni, quindi fai clic su Completo per salvare e applicare le traduzioni.

7. Controlla la pagina tradotta sul front-end.

La pagina tradotta mostra tutte le stringhe tradotte, il che significa che il file di configurazione della lingua aggiornato funziona correttamente. Se riscontri dei problemi, ti preghiamo di contattare il nostro team di sviluppo per la compatibilità. Saranno felici di verificare i problemi relativi al file di configurazione della lingua.

Una volta terminati i test, invia una merge request al nostro repository. I nostri sviluppatori per la compatibilità riceveranno la tua richiesta e la revisioneranno.