Cómo importar o añadir traducciones para plugins y temas en WordPress.org

Opción 2: cómo incluir traducciones con su plugin o tema de WordPress

Puede incluir traducciones directamente en su plugin o tema para que los usuarios las reciban como parte de su producto. Simplemente coloque los archivos de traducción en su carpeta /languages/ y añada un pequeño fragmento de código para que WordPress los cargue en lugar de las traducciones de la comunidad.

Coloque sus archivos .mo compilados dentro del directorio /languages/ de su plugin o tema.

Esta estructura asegura que WordPress pueda encontrarlos al cargar su dominio de texto.

Ejemplo:

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

Sugerencia: Utilice el mismo dominio de texto en los nombres de sus archivos de traducción y en sus llamadas load_plugin_textdomain() o load_theme_textdomain().

De forma predeterminada, WordPress prioriza las traducciones de la comunidad de WordPress.org sobre las incluidas.

Para asegurarse de que su plugin o tema utiliza los archivos .mo incluidos en lugar de las traducciones de la comunidad, añada el 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 );

Confirme que WordPress está cargando las traducciones que incluyó en su plugin o tema en lugar de las traducciones de la comunidad de translate.wordpress.org.

Puede hacerlo instalando su plugin o tema en un sitio de prueba y cambiando WordPress a uno de los idiomas que ha proporcionado.

1. Vaya a Ajustes → General → Idioma del sitio y seleccione un idioma que haya incluido en su carpeta /languages/.
2. Cargue una página o pantalla que contenga cadenas que sepa que están traducidas en su archivo .mo.
3. Compruebe que las cadenas aparecen en el idioma correcto y coinciden con las traducciones que ha añadido.

Si sigue viendo traducciones antiguas de la comunidad, revise el fragmento de código en el paso anterior para asegurarse de que apunta correctamente a WordPress a sus archivos .mo incluidos.

Alternativamente, puede instalar un plugin como Query Monitor. Abra cualquier página y mire en Idiomas para ver qué archivo .mo se carga para su dominio de texto.