WPML può leggere un file di configurazione che gli indica cosa deve essere tradotto nei temi e nei plugin. Il file si chiama wpml-config.xml e si trova nella cartella principale del plugin o del tema.
Lo scopo del file di configurazione della lingua
Per ottenere la compatibilità con WPML, dovresti anche creare un file di configurazione che ti aiuterà a mantenere la compatibilità nelle tue versioni future. WPML può tradurre qualsiasi elemento del tuo sito WordPress, ma devi indicargli cosa deve essere tradotto. Questo file serve proprio a questo.
Vai alla pagina WPML → Impostazioni.
Questa pagina dice a WPML tutto ciò che deve sapere, inclusi quali campi personalizzati tradurre o sincronizzare, quali tipi di post personalizzati e tassonomie devono essere multilingue e persino quali testi dell'area di amministrazione tradurre.
Il file di configurazione della lingua include queste informazioni in modo che ogni singolo utente non debba inserirle manualmente nella pagina di amministrazione.
Per alcuni temi e plugin, ospitiamo i file di configurazione della lingua sui nostri server. Puoi vederne un elenco qui. Sono impostati per sovrascrivere il file locale di configurazione della lingua che si trova all'interno della cartella principale del tema o del plugin.
WPML ti permette anche di sovrascrivere manualmente qualsiasi impostazione caricata dai file di configurazione della lingua di temi e plugin. Questo vale sia per i file di configurazione della lingua all'interno della cartella principale del tema o del plugin, sia per i file di configurazione della lingua ospitati sui nostri server.
Impostare le opzioni di traduzione per temi e plugin di terze parti
WPML è compatibile con molti temi e plugin popolari e per questi non è necessario creare un file di configurazione della lingua.
Tuttavia, se stai utilizzando un tema o un plugin i cui contenuti non vengono visualizzati correttamente nell'Editor di traduzione avanzato di WPML, potresti dover configurare manualmente le relative opzioni di traduzione.
Per configurare le opzioni di traduzione per temi e plugin di terze parti, vai su WPML → Impostazioni e fai clic sulla scheda Configurazione XML personalizzata. Usa l'editor di testo in questa pagina per inserire il codice proprio come faresti se stessi creando un file wpml-config.xml.
Generare automaticamente il file wpml-config.xml
Se non hai familiarità con la creazione di file XML, il nostro team ha creato il plugin Multilingual Tools che semplifica questa operazione. Sebbene sia stato inizialmente concepito come uno strumento per aiutare gli autori di temi e plugin a rendere i loro prodotti pronti per il multilinguismo (Multilingual Ready), può essere facilmente utilizzato per generare il tuo file wpml-config.xml.
Per saperne di più sulla generazione del tuo file wpml-config.xml, visita la pagina del plugin Multilingual Tools. Nello specifico, consulta la sezione Come genero i file di configurazione della lingua utilizzando Multilingual Tools?.
Una volta ottenuto il file di configurazione, aggiungilo alla cartella principale del tuo tema. Se ne hai già uno, non sovrascriverlo. Modifica invece il tuo file XML originale e aggiungi il codice generato con il plugin Multilingual Tools.
Tieni presente che questo plugin non è destinato all'uso su siti live o di produzione.
Per leggere questo tutorial e creare i file di configurazione della lingua per i tuoi temi e plugin, puoi iniziare con questo di esempio: wpml-config.zip.
Dovrai modificarlo, ma puoi utilizzare le sezioni e la struttura di questo file.
Struttura e sintassi
WPML ti permette di configurare una serie di elementi utilizzando il file wpml-config.xml. Usa le seguenti guide per trovare ulteriori informazioni e istruzioni su come rendere traducibili elementi specifici del sito:
- Tradurre gli shortcode personalizzati con WPML
- Registrare il contenuto del page builder per la traduzione
- Registrare i widget personalizzati del page builder per la traduzione
- Impostare le opzioni di traduzione per i campi personalizzati utilizzando il file di configurazione di WPML
- Registrare termini personalizzati, tipi e tassonomie come traducibili
- Rendere traducibili i blocchi personalizzati di Gutenberg
- Tradurre i testi che i temi e i plugin salvano in wp_options
- Personalizzare il selettore di lingua di WPML utilizzando il file di configurazione di WPML
- Abilitare i valori numerici per la traduzione
Utilizzare il file di configurazione della lingua di WPML con i temi child
Se stai utilizzando un tema child, il file di configurazione della lingua del tema genitore sovrascrive quello che si trova nel tema child. WPML fornisce una pagina di configurazione che ti permette di sovrascrivere facilmente questo comportamento con qualsiasi impostazione personalizzata.
Consideriamo un esempio in cui il file di configurazione della lingua del tema genitore imposta il tipo di post personalizzato “Property” come traducibile.
Se stai utilizzando un tema child e vuoi impostare il tipo di post personalizzato “Property” come non traducibile, vai alla pagina WPML → Impostazioni e fai clic sulla scheda Configurazione XML personalizzata. Usa l'editor per impostare il tipo di post personalizzato “Property” come non traducibile. Semplicemente, imposta il valore dell'attributo translate su 0 invece di 1.
Le impostazioni nella scheda Configurazione XML personalizzata hanno la priorità sulle impostazioni nel file di configurazione della lingua del tema genitore.
