Configura la compatibilità di WPML con i temi e i plugin di WordPress – Impostazioni e wpml-config.xml personalizzato

Questa pagina esiste per il resto: temi e plugin meno popolari, versioni molto recenti rilasciate prima che la compatibilità di WPML si adeguasse, e un piccolo numero di aiuti generici per siti che presentano sintomi specifici. La maggior parte dei clienti non visita mai questa pagina. Quando lo fai, di solito è perché il Supporto WPML ti ha indicato un’opzione specifica o un wpml-config.xml da incollare.

Due sottopagine di Impostazioni riguardano la compatibilità, e questa pagina le copre entrambe. Impostazioni > Compatibilità contiene le opzioni per i sintomi comuni. Impostazioni > Configurazione XML personalizzata è il punto in cui scrivi il tuo wpml-config.xml, descritto nella seconda metà di questa pagina. L’interfaccia utente per le impostazioni predefinite più comuni (preferenze di traduzione per tipo di post, per tassonomia e per campo) si trova in una pagina Impostazioni separata, trattata in Cosa viene tradotto e cosa no; la maggior parte dei clienti usa quell’interfaccia e viene qui solo quando non soddisfa le loro esigenze.

Opzioni di compatibilità

Apri WPML > Impostazioni > Compatibilità. La pagina ha quattro schede. Ogni scheda è rivolta a una classe specifica di problemi di compatibilità.

Opzioni di localizzazione – Per temi e plugin le cui traduzioni non vengono caricate

Quando un tema o un plugin include già le proprie traduzioni dell’interfaccia utente (file .mo in una cartella /languages/) ma queste traduzioni non appaiono sul tuo sito, la scheda Opzioni di localizzazione ha tre opzioni che aiutano WPML a trovarle e applicarle.

• Carica automaticamente il file .mo del tema usando load_textdomain. Forza WPML a chiamare load_textdomain() per il dominio di testo del tema. Usalo quando le traduzioni del tema sono presenti sul disco ma non vengono visualizzate.
• Inserisci textdomain. Sostituisce il dominio di testo rilevato automaticamente. Alcuni temi registrano il loro dominio di testo in modi non standard; questo campo ti permette di specificarlo esplicitamente.
• Usa i domini di testo del tema o del plugin quando le chiamate gettext non usano una stringa letterale. Un flag di compatibilità per temi e plugin che usano chiamate __() con argomenti variabili invece di stringhe letterali. WPML non può rilevarle automaticamente e questa opzione lo aiuta ad applicare comunque le traduzioni.

Se il Supporto WPML ti indirizza qui, ti dirà quale opzione e quale textdomain impostare.

Rendere i temi multilingue

Regola gli ID per la funzionalità multilingue. Un livello di compatibilità per i temi che codificano rigidamente presupposti monolingua (ad esempio, un tema che memorizza un “ID dell’immagine in evidenza” una volta e usa la stessa immagine in tutte le lingue).

La maggior parte dei temi moderni compatibili con WPML non ne ha bisogno. I temi più vecchi o meno ottimizzati per WPML a volte sì. Attiva questa opzione se vedi riferimenti ai contenuti (immagini, menu, elementi in evidenza) che si mescolano in modo errato tra le lingue.

Filtro della lingua per le operazioni AJAX

Memorizza un cookie della lingua per supportare il filtro della lingua per AJAX. Alcuni plugin usano AJAX per recuperare i contenuti: elenchi di prodotti filtrati, liste di articoli impaginate tramite AJAX, risultati di ricerca durante la digitazione. Senza un cookie della lingua, l’endpoint AJAX non sa in quale lingua rispondere e restituisce risultati nella lingua sbagliata.

Attiva il cookie se noti questo sintomo: i visitatori sulla pagina francese ottengono risultati in inglese dalle sezioni caricate tramite AJAX. È una soluzione da una sola casella di controllo per un’intera classe di bug.

Pagine di accesso e registrazione

Consenti la traduzione delle pagine di accesso e registrazione. Il file /wp-login.php integrato di WordPress e la schermata di registrazione non fanno parte dei normali contenuti tradotti da WPML. Si trovano al di fuori della catena di template del tema. Questa opzione li aggiunge all’insieme di pagine traducibili di WPML.

Se il tuo sito funziona su nginx, l’opzione richiede anche una modifica alla configurazione del server. La pagina rimanda alla guida per nginx di WPML con l’esatto blocco di configurazione.

Testi di temi e plugin – Impostazioni qui, scanner altrove

Due tipi di lavoro sulle stringhe di temi e plugin si dividono su due schermate:

• Le impostazioni su questa pagina. Gestiscono la compatibilità per le traduzioni che il tema o il plugin include già: load_textdomain, sostituzione del textdomain, chiamate gettext non letterali.
• Lo scanner ha la sua schermata dedicata. Quando devi trovare stringhe di temi e plugin che non sono ancora registrate per la traduzione, usa la schermata Traduzione testi admin. È raggiungibile dalla scheda Stringhe in Traduzioni, sotto la sezione “non vedi le stringhe che stai cercando?”.

Per il flusso di lavoro completo di scansione delle stringhe, vedi Tradurre le stringhe.

wpml-config.xml personalizzato

I temi e i plugin compatibili con WPML includono un file wpml-config.xml che indica a WPML esattamente quali dei loro campi, tipi di post, tassonomie, shortcode e chiavi meta devono essere traducibili. WPML lo legge all’attivazione. Per tutti i temi e i plugin principali e più popolari, questo significa che la traduzione funziona correttamente fin da subito. Non devi fare nulla.

Quando il file wpml-config.xml fornito con un tema o un plugin non è sufficiente per il tuo sito, ne scrivi uno tu. WPML lo applica sopra a quello fornito dal tema o dal plugin.

Quando scrivere il proprio wpml-config.xml

Tre scenari.

• Un campo che devi tradurre non è nel file wpml-config.xml fornito. L’autore del tema o del plugin non ha dichiarato un campo personalizzato come traducibile, ma tu hai bisogno di tradurlo sul tuo sito.
• Un campo ha l’impostazione predefinita sbagliata. Il file wpml-config.xml fornito contrassegna qualcosa come Copia e tu vuoi Traduci, o viceversa.
• Stai creando un tema o un plugin personalizzato e vuoi dichiarare il suo comportamento di traduzione dalla pagina Impostazioni di WPML invece di includere un file wpml-config.xml nel tuo codice.

In ogni caso, il Supporto WPML potrebbe indirizzarti qui con l’esatto wpml-config.xml da incollare. Per lo più si tratta di un’azione guidata dal Supporto, occasionalmente è guidata dallo sviluppatore.

Perché modificare wpml-config.xml nell’area di amministrazione di WPML invece che nel file del tema

Potresti modificare direttamente il file wpml-config.xml del tema o del plugin. Ma quella modifica andrebbe persa al successivo aggiornamento del tema o del plugin. L’editor nell’area di amministrazione di WPML in WPML > Impostazioni > Configurazione XML personalizzata sovrappone il tuo wpml-config.xml a quello fornito dal tema o dal plugin, e sopravvive agli aggiornamenti. È il posto giusto per le modifiche specifiche del sito.

La struttura di un wpml-config.xml

La pagina è un editor XML. Incolla un blocco <wpml-config>...</wpml-config>, salva e WPML applicherà il tuo wpml-config.xml.

Un wpml-config.xml minimo che dichiara uno shortcode come traducibile:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

I tipi di elementi che dichiareresti in genere:

• <custom-fields>. Contrassegna un campo personalizzato come translate, copy, copy-once o nothing.
• <custom-types>. Dichiara un tipo di post personalizzato come traducibile.
• <taxonomies>. Dichiara una tassonomia personalizzata come traducibile.
• <shortcodes>. Elenca gli shortcode il cui contenuto deve essere tradotto da WPML.
• <custom-term-fields>. Per i metadati dei termini.

Ogni elemento ha i propri attributi (ad esempio, action="translate" su un campo personalizzato). Per il riferimento completo a wpml-config.xml (ogni elemento, ogni attributo, ogni valore consentito), consulta le Informazioni per gli sviluppatori di WPML.

Un flusso di lavoro pratico

Se il Supporto WPML ti fornisce un blocco wpml-config.xml da incollare:

1. Apri WPML > Impostazioni > Configurazione XML personalizzata.
2. Incolla il loro XML all’interno del blocco <wpml-config> esistente (o sostituisci i contenuti se ti hanno fornito il blocco completo).
3. Salva.
4. WPML applica immediatamente il tuo wpml-config.xml. Se dichiara un nuovo tipo di post o campo traducibile, la voce appare subito in Impostazioni > Traduzione dei tipi di post / Traduzione dei campi personalizzati.

Se stai creando un tema o un plugin personalizzato e vuoi includere la sua configurazione per WPML con il codice, dovrai invece inserire lo stesso blocco <wpml-config> in un file wpml-config.xml nella cartella principale del tuo tema o plugin. WPML lo legge all’attivazione. L’editor nell’area di amministrazione serve per le modifiche specifiche del sito; il file incluso serve per le impostazioni predefinite del tema o del plugin.