Mantenere la compatibilità del Divi Builder con WPML

Scopri come mantenere la compatibilità dei moduli Divi con WPML tramite il file di configurazione della lingua wpml-config.xml.

Questa documentazione è destinata al team di sviluppo di Divi e agli sviluppatori web che utilizzano Divi. Spiega il processo per mantenere la compatibilità del Divi Builder con WPML, che si esegue aggiornando il file di configurazione della lingua.

Questa pagina si riferisce a Divi 5, che memorizza i contenuti come blocchi compatibili con Gutenberg (Divi 4 utilizzava gli shortcode).

Come funziona l’integrazione del Divi Builder con WPML

Per capire come funziona il Divi Builder con WPML, iniziamo creando una pagina semplice utilizzando il Divi Builder. Nel nostro esempio qui sotto abbiamo aggiunto alcuni moduli, come Testo, Contatore numerico, Icona, ecc.

Per tradurre, vai su WPML → Dashboard di traduzione e trova la pagina nella sezione Pagine. Selezionala e fai clic su Traduci il tuo contenuto per selezionare il metodo di traduzione. Se disponi di crediti per la traduzione automatica, puoi tradurre questa pagina automaticamente in pochi minuti.

Utilizzare il file di configurazione della lingua

Nel file wpml-config.xml puoi configurare i seguenti elementi:

• Blocchi dei page builder
• Campi personalizzati
• Tassonomie personalizzate
• Testi dell’area di amministrazione / wp_options
• Configurazione del selettore di lingua

Per maggiori informazioni sulla struttura e la sintassi, consulta la nostra guida al file di configurazione della lingua.

Ottenere il file di configurazione per Divi

La configurazione del file wpml-config.xml estrae le stringhe dalle pagine create con il Divi Builder e le carica nell’Editor di traduzione avanzato. Utilizza questo file per aggiungere nuovi tipi di blocco e attributi, nonché per rimuovere i tipi di blocco obsoleti.

Puoi scaricare il file di configurazione della lingua dal nostro repository e posizionarlo nella cartella principale del tuo tema una volta configurato.

Ospitiamo il file di configurazione della lingua per Divi sui nostri server, in modo che sovrascriva il file di configurazione locale posizionato nella cartella principale di Divi. Questo garantisce che il file di configurazione sia sempre aggiornato.

Configurare i blocchi nel file di configurazione della lingua

Divi 5 utilizza la sintassi dei blocchi, quindi la registrazione dei moduli Divi per la traduzione è simile al processo per tradurre i blocchi Gutenberg:

• Tutte le definizioni dei blocchi sono racchiuse all’interno di un elemento genitore <gutenberg-blocks>.
• Ogni singolo blocco viene dichiarato con un elemento <gutenberg-block>, dove l’attributo type corrisponde al nome registrato del blocco.
• I campi traducibili vengono dichiarati come elementi figlio <key>.

Prendiamo l’esempio di un modulo Call to Action di Divi:

<!-- wp:divi/cta {"module":{"title":"CTA","button_text":"Contact Us","button_url":"https://example.com/contact/"}} /-->

Ecco come viene configurato nel file wpml-config.xml:

<gutenberg-blocks>
    <gutenberg-block type="divi/cta" translate="1">
       <key name="module">
         <key name="title" />
         <key name="button_text" />
         <key name="button_url" type="link" />
       </key>
    </gutenberg-block>
</gutenberg-blocks>

La struttura si scompone nel seguente modo:

• L’elemento <gutenberg-blocks> racchiude tutte le definizioni dei blocchi.
• Un elemento <gutenberg-block> definisce un singolo tipo di blocco, identificato dall’attributo type. Il translate="1" indica a WPML di elaborarlo.
• Ogni elemento <key> identifica un campo traducibile: title e button_text per i campi di solo testo, e button_url per un link.
• L’attributo type="link" indica a WPML di sostituire automaticamente l’URL con la versione tradotta dell’articolo o della pagina collegata.

Testare il file di configurazione della lingua

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

1. Configura un sito con Divi e WPML attivati. Assicurati di attivare anche gli add-on Traduzione stringhe e Traduzione media.

2. Per sovrascrivere il file di configurazione della lingua remoto con la versione aggiornata, vai su 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 questi alla pagina. In questo esempio, supponiamo che il modulo Pulsante sia stato appena aggiunto al Divi Builder. Aggiungilo alla pagina e fai clic su Pubblica.

4. Per tradurre la pagina con il pulsante, puoi utilizzare la Dashboard di traduzione. Un’alternativa è utilizzare l’Editor di traduzione avanzato (ATE), che può essere utile durante i test: ti permette di vedere il tag del modulo per ogni elemento Divi sulla pagina. Per aprire l’ATE, vai su Modifica della pagina e fai clic sull’icona più sotto il Riquadro della lingua nella barra laterale di destra.

5. Controlla gli elementi e aggiungi le tue traduzioni o permetti all’ATE di tradurre automaticamente.

Ora puoi dare un’occhiata alla pagina tradotta sul front-end. La pagina tradotta dovrebbe mostrare tutte le stringhe tradotte, il che significa che il file di configurazione della lingua aggiornato funziona correttamente.

Nel caso in cui dovessi riscontrare dei problemi, contatta il nostro team di sviluppo della 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 della compatibilità riceveranno le tue richieste e le esamineranno.