Il plugin Multilingual Tools è un plugin di test che puoi utilizzare per registrare i widget personalizzati di Elementor per la traduzione. Il plugin include un WPML – Config Generator for Elementor che genera automaticamente la prima versione del codice XML per questi widget personalizzati.
Utilizzando questo strumento, potrai ottenere le informazioni necessarie per registrare il tuo widget.
Questa guida è rivolta agli sviluppatori che creano temi e plugin per Elementor e desiderano renderli compatibili con WPML. Se non sei uno sviluppatore, dai un’occhiata alla nostra guida su Come tradurre un sito web Elementor con WPML.
Primi passi
Per iniziare:
- Scarica il plugin Multilingual Tools dalla pagina GitHub di OnTheGoSystems.
- Assicurati di avere il plugin core WPML Multilingual CMS e il componente aggiuntivo WPML Traduzione stringhe installati e attivati sul tuo sito.
- Assicurati di avere già dei contenuti creati con Elementor sul tuo sito.
Perché utilizzare il plugin Multilingual Tools
In WPML 4.9 e versioni successive, WPML riconosce automaticamente i widget personalizzati di Elementor e li rende traducibili. Tuttavia, potrebbe registrare stringhe che non desideri tradurre.
Ecco perché ti consigliamo di utilizzare Multilingual Tools per registrare il tuo widget personalizzato di Elementor per la traduzione. Questo ti offre un controllo preciso su quali campi sono traducibili.
Come funziona
Quando crei una pagina utilizzando il page builder Elementor, tutto il contenuto viene salvato nel campo personalizzato _elementor_data.
Una volta aggiunti i widget personalizzati che desideri registrare per la traduzione in una pagina, WPML – Config Generator for Elementor accede a questo campo _elementor_data per leggerne i contenuti. Dopo la lettura, converte i dati in codice XML che corrisponde ai widget personalizzati che hai utilizzato sulla tua pagina.
Generare codice XML con WPML — Config Generator
Per generare automaticamente il codice XML per i tuoi widget personalizzati:
- Crea una nuova pagina e fai clic su Modifica con Elementor.
- Aggiungi alla pagina i widget personalizzati che desideri registrare per la traduzione.
Importante: quando aggiungi il tuo widget per renderlo traducibile, assicurati di compilare tutti i campi e di abilitare tutte le opzioni disponibili.
Questo perché WPML – Config Generator for Elementor non genera codice XML per alcun campo o opzione non configurati.
- Pubblica la pagina e torna alla schermata di modifica di WordPress per quella pagina. Scorri verso il basso fino alla sezione denominata WPML: Elementor Widgets. Vedrai il codice XML generato per i campi e le impostazioni del widget che non sono ancora registrati per la traduzione.
Testare il codice XML generato automaticamente
Prima di rendere il codice disponibile agli utenti finali, assicurati di esaminarlo e testarlo a fondo. WPML – Config Generator for Elementor è solo un punto di partenza.
Per testare il codice XML generato automaticamente:
- Copia il codice XML dalla sezione denominata WPML: Elementor Widgets nella schermata di modifica di WordPress della tua pagina con i widget personalizzati.
- Vai su WPML → Impostazioni e fai clic sulla scheda Configurazione XML personalizzata.
- Incolla il codice nell’editor e premi il pulsante Salva. Verifica di non visualizzare alcun avviso o errore di convalida. Assicurati di rimuovere eventuali campi che non dovrebbero essere tradotti o modificati dagli utenti, come i campi di configurazione e i campi con valori booleani. Lasciare questi campi disponibili per la traduzione può causare problemi ed errori per gli utenti finali.
- Torna alla schermata di modifica della pagina con i widget personalizzati. Apporta una piccola modifica alla pagina, come modificare il titolo della pagina, e fai clic su Aggiorna.
- Dal riquadro Lingua, fai clic sull’icona più per tradurre la pagina. Si aprirà l’Editor di traduzione avanzato e dovresti vedere i campi registrati dal widget personalizzato disponibili per la traduzione. Rivedi le traduzioni automatiche o inserisci le tue e fai clic su Completo quando hai finito.
- Dai un’occhiata alla pagina tradotta sul front-end per assicurarti che i campi del widget personalizzato appaiano correttamente.
Utilizzare le funzionalità di ispezione aggiuntive
Oltre a generare automaticamente il codice XML per i tuoi widget personalizzati di Elementor, WPML – Config Generator for Elementor fornisce informazioni di debug aggiuntive.
Queste informazioni ti consentono di ispezionare e comprendere i dati sottostanti e il modo in cui vengono utilizzati. Possono essere utili in casi specifici, ad esempio quando il codice XML non funziona come previsto.
WPML Config XML (generato per tutti i widget nella pagina)
Cosa fa: fornisce il codice XML per tutti i widget sulla pagina, inclusi quelli già registrati per la traduzione.
Perché è utile: ti consente di rivedere o modificare il codice XML delle impostazioni dei widget esistenti.
Valore RAW da _elementor_data (JSON)
Cosa fa: mostra il valore originale del campo _elementor_data dell’articolo.
Perché è utile: ti consente di vedere i dati che WPML – Config Generator for Elementor Widgets utilizza per generare il codice XML.
Array generato da _elementor_data
Cosa fa: fornisce il valore del campo _elementor_data dell’articolo, convertito in un array.
Perché è utile: puoi utilizzare l’array a scopo di debug.
Widget estratti da _elementor_data
Cosa fa: mostra quali widget personalizzati il plugin è stato in grado di estrarre e utilizzare dal campo _elementor_data.
Perché è utile: se qui non vedi un widget personalizzato, un campo del widget personalizzato o un’opzione del widget personalizzato, non verrà aggiunto all’XML. Questo è utile per il debug.