{"id":234137,"date":"2023-02-20T11:53:00","date_gmt":"2023-02-20T08:53:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=234137"},"modified":"2022-11-11T16:01:01","modified_gmt":"2022-11-11T13:01:01","slug":"tutorial-sul-tema-wordpress-per-principianti-parte-8-traduzione","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/it\/tutorial-sul-tema-wordpress-per-principianti-parte-8-traduzione\/","title":{"rendered":"Tutorial sul tema WordPress per principianti \u2013 Parte 8: Traduzione"},"content":{"rendered":"\n

In questa lezione impariamo come funziona la traduzione (o altrimenti nota come i18n) in WordPress e come apportare le modifiche necessarie nei nostri modelli. Impareremo anche come impostare correttamente PoEdit per creare un file di traduzione per il nostro tema, pronto per essere tradotto in diverse lingue.<\/p>\n

Perch\u00e9 preoccuparsi di aggiungere il supporto per la traduzione?<\/h2>\n

Tutti i temi, almeno quelli che diventano pubblici per l’uso da parte di persone diverse dallo sviluppatore, dovrebbero essere disponibili per la traduzione. Questa si chiama internazionalizzazione (i18n in breve) e consente alle persone di tradurre i testi che aggiungi nel tuo tema in un’altra lingua.<\/p>\n

Il modo in cui funziona \u00e8 che tu, come autore di temi o sviluppatore di plugin, avvolgi tutti i tuoi testi (come "Leggi di pi\u00f9", "Nessun post") in determinate funzioni. Queste funzioni fanno in modo che WordPress sia in grado di raccoglierli e iniettarli una traduzione se esiste. All’interno del tuo tema (o plugin) puoi aggiungere file di un certo tipo di file per ogni lingua tradotta, o assicurarti che altre persone siano in grado di creare la propria traduzione nella loro lingua.<\/p>\n

Questo \u00e8 molto utile per le persone che vogliono usare WordPress e il tuo tema (o plugin) in una lingua diversa dalla lingua di origine in cui \u00e8 stato scritto (che di solito \u00e8 l’inglese). Ma pu\u00f2 anche essere utilizzato per cambiare alcuni testi in qualcosa di diverso all’interno della stessa lingua.<\/p>\n

Se sei interessato all’argomento, WordPress Codex ha una lunga e buona guida alla documentazione su i18n per sviluppatori<\/a>.<\/p>\n

Implementazione di i18n nel nostro tema<\/h2>\n

Abbiamo gi\u00e0 fatto la prima parte nel passaggio precedente<\/a> di questa serie di tutorial sul tema, in cui abbiamo aggiunto load_theme_textdomain<\/code>la funzione di configurazione del nostro tema. Nel caso ve lo foste dimenticato, questo \u00e8 quello che abbiamo aggiunto:<\/p>\n

load_theme_textdomain('wptutorial', get_stylesheet_directory(). '\/lang');<\/code><\/pre>\n
Il primo argomento \u00e8 l’handle, questa \u00e8 una stringa univoca che utilizzerai per raggruppare tutti i testi che appartengono al tuo tema. Ripeterai questa maniglia ogni volta che renderai un testo traducibile. Il secondo argomento dice a WordPress dove si trovano i file di traduzione. Li abbiamo definiti per risiedere in una sottocartella ‘ lang<\/code>‘ nella nostra directory dei temi.<\/p>\n
Non preoccuparti se questa cartella non esiste o non contiene alcun file: nulla andr\u00e0 in crash. Se WordPress non trova la cartella n\u00e9 i file di traduzione corretti, torner\u00e0 per impostazione predefinita ai testi che abbiamo nel tema.<\/p>\n
Il prossimo passo \u00e8 esaminare tutto il nostro codice e trovare qualsiasi output di testo che dovrebbe essere traducibile. \u00c8 buona norma assicurarsi di coprire assolutamente tutti i testi. Niente \u00e8 pi\u00f9 fastidioso dell’utilizzo di un tema o di un plug-in in cui l’autore ha codificato i testi rendendo impossibile la traduzione o la modifica in alcun modo.<\/p>\n
Come rendere traducibili i testi<\/h2>\n
Quello che facciamo con tutti i testi \u00e8 inserirli in una delle funzioni gettext di WordPress, che pi\u00f9 comunemente sono _e()<\/code>o __()<\/code>. Il primo \u00e8 un trattino basso con "e" che viene utilizzato quando si desidera fare eco al testo contemporaneamente. Il secondo \u00e8 costituito da due caratteri di sottolineatura e viene utilizzato quando non si desidera eseguire l’eco ma memorizzarlo o utilizzarlo in una variabile.<\/p>\n
WordPress ha pi\u00f9 funzioni gettext che servono a scopi pi\u00f9 specifici, ad esempio, esc_html__()<\/code>e altro. Tuttavia non entreremo nei dettagli per quelli in questo tutorial._n()``_x()<\/code><\/p>\n
Le funzioni gettext accettano due parametri; prima il testo stesso e, in secondo luogo, l’handle che hai definito in load_theme_textdomain<\/code>. In questo caso \u00e8 ‘ wptutorial<\/code>‘.<\/p>\n
Ad esempio, se hai qualcosa del genere:<\/p>\n
echo 'Read more';<\/code><\/pre>\n
Dovrai sostituirlo con:<\/p>\n
_e('Read more', 'wptutorial');<\/code><\/pre>\n
E allo stesso modo per la memorizzazione in una variabile;<\/p>\n
$myvariable = 'Read more';<\/code><\/pre>\n
Deve essere scritto cos\u00ec:<\/p>\n
$myvariable = __('Read more', 'wptutorial');<\/code><\/pre>\n
Ora dobbiamo trovare tutti i testi nei nostri modelli! Se hai seguito questo tutorial con una "T" non sono molti. Abbiamo alcune stringhe in index.php<\/code>e alcune in single.php<\/code>.<\/p>\n
Aggiunta del supporto per la traduzione nel nostro tema<\/h2>\n
Iniziamo con index.php<\/code>e individuare il messaggio "Nessun post, scusa" che abbiamo aggiunto se il ciclo non conteneva alcun post. Avvolgiamo questo testo all’interno _e()<\/code>perch\u00e9 vogliamo ancora farne eco. Quindi questo \u00e8 ci\u00f2 che otteniamo:<\/p>\n
...\n} else {\n    ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n...<\/code><\/pre>\n
Poich\u00e9 hai usato _e()<\/code>, non dovresti vedere alcun cambiamento quando premi Aggiorna in prima pagina o archivio. Ma sotto il cofano, questo testo \u00e8 ora traducibile!<\/p>\n
Abbiamo questo stesso testo nel nostro single.php<\/code>e page.php<\/code>. Aggiornali come abbiamo fatto in index.php<\/code>. Abbiamo aggiunto altri testi in single.php<\/code>, quindi ecco come appare dopo aver reso tutti i testi traducibili:<\/p>\n
...\n        <?php the_category(); ?>\n        <p><?php _e('Posted', 'wptutorial'); ?>: <?php the_date(); ?> <?php _e('at', 'wptutorial'); ?> <?php the_time(); ?><\/p>\n        <p><?php _e('Author', 'wptutorial'); ?>: <?php the_author(); ?><\/p>\n    <\/article>\n    <?php endwhile;\n} else {\n    ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n\u00a0\n...<\/code><\/pre>\n
D’ora in poi tutti i testi che aggiungiamo nel nostro tema ci assicuriamo di avvolgerli all’interno __()<\/code>o _e()<\/code>.<\/p>\n
File di traduzione<\/h2>\n
Ci sono due modi per fornire file di traduzione al tuo tema;<\/p>\n