Come importare o aggiungere traduzioni per plugin e temi su WordPress.org

Opzione 2 — come includere le traduzioni con il tuo plugin o tema WordPress

Puoi includere le traduzioni direttamente nel tuo plugin o tema in modo che gli utenti le ricevano come parte del tuo prodotto. Basta inserire i file di traduzione nella tua cartella /languages/ e aggiungere un piccolo frammento di codice per fare in modo che WordPress li carichi invece delle traduzioni della comunità.

Inserisci i tuoi file .mo compilati all’interno della directory /languages/ del tuo plugin o tema.

Questa struttura assicura che WordPress possa trovarli quando carica il tuo text domain.

Esempio:

my-plugin/
 ├─ my-plugin.php
 ├─ languages/
 │ ├─ my-plugin-es_ES.mo
 │ ├─ my-plugin-fr_FR.mo

my-plugin/
 ├─ my-plugin.php
 ├─ languages/
 │   ├─ my-plugin-es_ES.mo
 │   ├─ my-plugin-fr_FR.mo

Suggerimento: Usa lo stesso text domain nei nomi dei file di traduzione e nelle tue chiamate load_plugin_textdomain() o load_theme_textdomain().

Per impostazione predefinita, WordPress dà la priorità alle traduzioni della community da WordPress.org rispetto a quelle in bundle.

Per assicurarti che il tuo plugin o tema utilizzi i file .mo in bundle invece delle traduzioni della community, aggiungi il filtro load_textdomain_mofile.

function my_plugin_load_embedded_translation_file( $mofile, $domain ) {
 if ( 'my-domain' === $domain && false !== strpos( $mofile, WP_LANG_DIR . '/plugins/' ) ) {
 $locale = apply_filters( 'plugin_locale', determine_locale(), $domain );
 $local_mofile = WP_PLUGIN_DIR . '/' . dirname( plugin_basename( __FILE__ ) ) . '/languages/' . $domain . '-' . $locale . '.mo';       

  if ( file_exists( $local_mofile ) ) {
 return $local_mofile;
 }
 }
 return $mofile;
}
add_filter( 'load_textdomain_mofile', 'my_plugin_load_embedded_translation_file', 10, 2 );

function my_plugin_load_embedded_translation_file( $mofile, $domain ) {
    if ( 'my-domain' === $domain && false !== strpos( $mofile, WP_LANG_DIR . '/plugins/' ) ) {
        $locale = apply_filters( 'plugin_locale', determine_locale(), $domain );
        $local_mofile = WP_PLUGIN_DIR . '/' . dirname( plugin_basename( __FILE__ ) ) . '/languages/' . $domain . '-' . $locale . '.mo';

        if ( file_exists( $local_mofile ) ) {
            return $local_mofile;
        }
    }
    return $mofile;
}
add_filter( 'load_textdomain_mofile', 'my_plugin_load_embedded_translation_file', 10, 2 );

function my_theme_load_embedded_translation_file( $mofile, $domain ) {
 if ( 'my-domain' === $domain && false !== strpos( $mofile, WP_LANG_DIR . '/themes/' ) ) {
 $locale = apply_filters( 'theme_locale', determine_locale(), $domain );
 $local_mofile = get_template_directory() . '/languages/' . $locale . '.mo';   

  if ( file_exists( $local_mofile ) ) {
 return $local_mofile;
 }
 }
 return $mofile;
}
add_filter( 'load_textdomain_mofile', 'my_theme_load_embedded_translation_file', 10, 2 );

function my_theme_load_embedded_translation_file( $mofile, $domain ) {
    if ( 'my-domain' === $domain && false !== strpos( $mofile, WP_LANG_DIR . '/themes/' ) ) {
        $locale = apply_filters( 'theme_locale', determine_locale(), $domain );
        $local_mofile = get_template_directory() . '/languages/' . $locale . '.mo';

        if ( file_exists( $local_mofile ) ) {
            return $local_mofile;
        }
    }
    return $mofile;
}
add_filter( 'load_textdomain_mofile', 'my_theme_load_embedded_translation_file', 10, 2 );

Conferma che WordPress stia caricando le traduzioni che hai incluso nel tuo plugin o tema invece delle traduzioni della comunità da translate.wordpress.org.

Puoi farlo installando il tuo plugin o tema su un sito di test e impostando WordPress su una delle lingue che hai fornito.

1. Vai su Impostazioni → Generale → Lingua del sito e seleziona una lingua che hai incluso nella tua cartella /languages/.
2. Carica una pagina o schermata che contenga stringhe che sai essere tradotte nel tuo file .mo.
3. Verifica che le stringhe appaiano nella lingua corretta e corrispondano alle traduzioni che hai aggiunto.

Se vedi ancora vecchie traduzioni della comunità, rivedi lo snippet di codice nel passaggio precedente per assicurarti che punti correttamente WordPress ai tuoi file .mo in bundle.

In alternativa, puoi installare un plugin come Query Monitor. Apri qualsiasi pagina e guarda sotto Lingue per vedere quale file .mo viene caricato per il tuo dominio di testo.