Mantenere la compatibilità di WPBakery Page Builder con WPML

La compatibilità di WPBakery Page Builder con WPML è garantita attraverso il file di configurazione della lingua. Scopri come utilizzare questo file per mantenere la compatibilità.

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

Se sei un cliente che desidera tradurre un sito creato con WPBakery, consulta la nostra documentazione dettagliata per saperne di più su come creare siti multilingue con WPBakery Page Builder e WPML.

Come funziona l’integrazione di WPBakery Page Builder con WPML

Per capire come funziona WPBakery Page Builder con WPML, inizieremo creando una pagina semplice utilizzando WPBakery Page Builder. Includeremo alcuni moduli, come un Text Block, un Message Box e un Hover Box.

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

Questo ti porterà alla schermata dell’Editor di traduzione avanzato, dove potrai tradurre la tua pagina. Inserisci le traduzioni per ogni frase e confermale facendo clic sul segno di spunta verde. Quando sei soddisfatto di tutte le tue traduzioni, fai clic su Completo.

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.

Per gli autori che includono una versione personalizzata di WPBakery Page Builder nel loro tema, tieni presente che sarà necessario aggiornare il file di configurazione della lingua della versione personalizzata del plugin.

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

Per estrarre le stringhe dalle pagine create con WPBakery Page Builder e caricarle nella schermata dell’Editor di traduzione, dobbiamo configurare WPML affinché identifichi gli shortcode e gli attributi che contengono le stringhe da tradurre. Questo viene fatto aggiungendo un file, chiamato wpml-config.xml, che di solito viene posizionato nella cartella principale del tuo tema. Per WPBakery Page Builder, ospitiamo il file di configurazione della lingua sui nostri server. È impostato per sovrascrivere il file di configurazione locale presente nella cartella principale di WPBakery Page Builder, 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 Tabs al file wpml-config.xml.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

La struttura dell’esempio precedente può essere suddivisa come segue:

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

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 type per l’attributo. Ecco un esempio:

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

Testare il file di configurazione della lingua

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

1. Configura un’installazione con WPBakery Page Builder e WPML attivati. Scarica e attiva i componenti aggiuntivi Traduzione stringhe e Traduzione media.
2. Dovrai 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, quindi fai clic su Salva.

3. Crea una nuova pagina e aggiungi i nuovi moduli. Nel caso in cui tu abbia aggiornato alcuni attributi per i moduli esistenti, aggiungi anche questi alla pagina. In questo esempio, supporremo che il modulo Call To Action sia stato appena aggiunto a WPBakery Page Builder. Aggiungilo alla pagina e fai clic su Pubblica.

4. Fai clic sull’icona più per tradurre la pagina. Questo ti porterà alla schermata dell’Editor di traduzione avanzato.
5. Assicurati che gli elementi testuali del modulo siano visualizzati nell’Editor di traduzione avanzato.
6. Inserisci le tue traduzioni e confermale con il segno di spunta verde. Quando hai finito, fai clic sul pulsante Completo.

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.

Tieni presente che gli stili CSS per gli elementi della pagina dalla lingua originale vengono copiati nella lingua di traduzione. Questo assicura che tutto venga visualizzato correttamente tra le lingue. Se desideri disabilitare questa funzionalità, consulta questo articolo per le istruzioni.

Se riscontri problemi, contatta il nostro team per lo sviluppo della compatibilità. Saranno felici di verificare i problemi relativi al file di configurazione della lingua.

Una volta terminati i test, invia una richiesta di merge al nostro repository. I nostri sviluppatori della compatibilità riceveranno la tua richiesta e la esamineranno.

Tieni presente che il file di configurazione della lingua ospitato sul nostro repository è per la versione predefinita di WPBakery Page Builder. Nel caso in cui tu stia aggiornando il file di configurazione della lingua di una versione personalizzata di WPBakery Page Builder, applica le modifiche al file di configurazione all’interno della cartella principale del tuo plugin.