Comment importer des traductions de thèmes et d’extensions dans WordPress.org

Alternative plus rapide : regrouper les traductions avec votre thème ou votre extension

Pour un contrôle total sur les traductions, vous pouvez inclure des fichiers de traduction dans votre extension ou votre thème. De cette façon, les utilisateurs les reçoivent dans le cadre de votre produit.

Placez simplement les fichiers de traduction dans votre dossier /languages/ et ajoutez un petit extrait de code pour que WordPress les charge au lieu des traductions communautaires.

Placez vos fichiers .mo compilés dans le répertoire /languages/ de votre extension ou de votre 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 votre thème au lieu des traductions communautaires de translate.wordpress.org.

Pour ce faire, installez votre extension ou votre thème sur un site de test et basculez WordPress vers 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 qui contient des chaînes dont vous savez qu’elles sont 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 communautaires, vérifiez l’extrait de code de l’étape précédente pour vous assurer qu’il pointe correctement WordPress vers vos fichiers .mo groupés.