# Traduzioni DiviChild

Per quanto riguarda le traduzioni delle stringhe facenti parte delle interfacce gestite da tema, è stata resa disponibile l'appostita funzione WPCLI attraverso il gestore di pacchetti php Composer.

Attenzione!

Per usare questa funzionalità è necessario avere istallato PHP e Composer nel proprio sistema.

# Prima sviluppare e poi tradurre

Per semplificare il lavoro di traduzione è bene concentrarsi prima sullo sviluppo del tema, con tutte le sue parti e funzioni e soltanto alla fine procedere con le traduzioni.

# Scrivere codice in Inglese

Per ottimizzare il processo di traduzione è bene scrivere il codice in Inglese.

# Come scrivere codice correttamente localizzabile

Ogni stringa inserita nei template del tema deve essere passata secondo gli standard di localizzazione previsti da WP. Nel caso di questo tema le stringhe devono essere passate con il seguente sistema

$string = __("String in English","divichild");

o

e_("String in English","divichild");

Per maggiori info vedi https://developer.wordpress.org/reference/functions/__/ (opens new window) e fai ulteriori ricerche da solo.

Una volta finito il lavoro di stesura del tema (che deve necessariamente essere fatto in Inglese) sarà possibile utilizzare i comandi da terminale per la creazione del file .pot da utilizzare per la creazione dei file .po e .mo

# Procedura di traduzione

  • Come prima cosa ottieni il file .pot attraverso il comando da terminale (vedi sotto)
  • Crea tutti i file di lingua di cui hai bisogno inserendoli nella cartella /languages del tema
  • Copia il contenuto del file .pot nei relativi file di lingua .po
  • Traduci tutte le stringhe dei file .po
  • Compila i file .po in file .mo attraverso i comandi da terminale (vedi sotto)

# Comandi traduzione da terminale

Per utlizzare i seguenti comandi, è neccessario aver istallato Composer (opens new window) e essersi assicurati di aver installato tutte le dipendenze, esattamente come avviene per i node modules. Attenzione! a differenza di Grunt, che risiede nella root del progetto, il progetto Composer risiede invece nella root del tema child, quindi, prima di eseguire qualsiasi comando Composer, è necessario spostarsi da terminale all'interno della cartella del tema child:

cd wp-content/themes/Divi-Child

Una volta nella cartella del tema child (solo la prima volta che utilizzate i comandi Composer) lanciare l'installazione delle dipendenze:

composer install

Per generare il file .pot lanciare il seguente comando:

composer run make-pot

questo creerà il file aggiornato con tutte le stringhe rintracciate nel tema all'interno della cartella languages. Il file si chiamerà divichild.pot

Per compilare i file .po in file .mo lanciare il seguente comando:

composer run make-mo

questo compilerà tutti i file .po contenuti nella cartella languages nei relativi .mo

Per compilare solo il file italiano

composer run make-mo-it

questo compilerà soltanto il file it_IT.po in it_IT.mo