Comment importer ou ajouter des traductions pour les extensions et les thèmes sur WordPress.org

Option 2 — Comment inclure des traductions avec votre extension ou thème WordPress

Vous pouvez inclure directement les traductions dans votre extension ou thème afin que les utilisateurs les reçoivent dans le cadre de votre produit. Il suffit de placer les fichiers de traduction dans votre dossier /languages/ et d’ajouter un petit extrait de code pour que WordPress les charge à la place des traductions de la communauté.

Placez vos fichiers .mo compilés dans le répertoire /languages/ de votre extension ou thème.

Cette structure garantit que WordPress peut les trouver lors du chargement de votre domaine de texte.

Exemple :

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

Conseil : Utilisez le même domaine de texte dans les noms de vos fichiers de traduction et dans vos appels load_plugin_textdomain() ou load_theme_textdomain().

Par défaut, WordPress donne la priorité aux traductions communautaires de WordPress.org par rapport à celles incluses.

Pour vous assurer que votre extension ou thème utilise les fichiers .mo inclus plutôt que les traductions communautaires, ajoutez le filtre 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 );

Confirmez que WordPress charge les traductions que vous avez incluses dans votre extension ou thème au lieu des traductions de la communauté de translate.wordpress.org.

Vous pouvez le faire en installant votre extension ou thème sur un site de test et en changeant WordPress pour l’une des langues que vous avez fournies.

1. Allez dans Réglages → Général → Langue du site et sélectionnez une langue que vous avez incluse dans votre dossier /languages/.
2. Chargez une page ou un écran contenant des chaînes que vous savez être traduites dans votre fichier .mo.
3. Vérifiez que les chaînes apparaissent dans la langue correcte et correspondent aux traductions que vous avez ajoutées.

Si vous voyez toujours d’anciennes traductions de la communauté, revoyez l’extrait de code de l’étape précédente pour vous assurer qu’il dirige correctement WordPress vers vos fichiers .mo inclus.

Alternativement, vous pouvez installer une extension comme Query Monitor. Ouvrez n’importe quelle page et regardez sous Langues pour voir quel fichier .mo est chargé pour votre domaine de texte.