So importieren oder fügen Sie Übersetzungen für Plugins und Themes auf WordPress.org hinzu

Option 2 – So binden Sie Übersetzungen in Ihr WordPress-Plugin oder -Theme ein

Sie können Übersetzungen direkt in Ihr Plugin oder Theme einbinden, sodass Benutzer sie als Teil Ihres Produkts erhalten. Platzieren Sie die Übersetzungsdateien einfach in Ihrem /languages/-Ordner und fügen Sie einen kleinen Code-Schnipsel hinzu, damit WordPress diese anstelle von Community-Übersetzungen lädt.

Platzieren Sie Ihre kompilierten .mo-Dateien in Ihrem Plugin- oder Theme-/languages/-Verzeichnis.

Diese Struktur stellt sicher, dass WordPress sie beim Laden Ihrer Textdomain finden kann.

Beispiel:

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

Tipp: Verwenden Sie dieselbe Textdomain in Ihren Übersetzungsdateinamen und Ihren load_plugin_textdomain()– oder load_theme_textdomain()-Aufrufen.

Standardmäßig priorisiert WordPress Community-Übersetzungen von WordPress.org gegenüber gebündelten.

Um sicherzustellen, dass Ihr Plugin oder Theme die gebündelten .mo Dateien anstelle von Community-Übersetzungen verwendet, fügen Sie den load_textdomain_mofile Filter hinzu.

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 );

Bestätigen Sie, dass WordPress die Übersetzungen lädt, die Sie in Ihr Plugin oder Theme eingebunden haben, und nicht die Community-Übersetzungen von translate.wordpress.org.

Sie können dies tun, indem Sie Ihr Plugin oder Theme auf einer Testseite installieren und WordPress auf eine der Sprachen umstellen, die Sie in Ihrem Ordner angegeben haben.

1. Gehen Sie zu Einstellungen → Allgemein → Site-Sprache und wählen Sie eine Sprache aus, die Sie in Ihrem /languages/-Ordner angegeben haben.
2. Laden Sie eine Seite oder einen Bildschirm, der Zeichenketten enthält, von denen Sie wissen, dass sie in Ihrer .mo-Datei übersetzt sind.
3. Überprüfen Sie, ob die Zeichenketten in der richtigen Sprache angezeigt werden und mit den Übersetzungen übereinstimmen, die Sie hinzugefügt haben.

Wenn Sie immer noch alte Community-Übersetzungen sehen, überprüfen Sie den Code-Schnipsel im vorherigen Schritt, um sicherzustellen, dass er WordPress korrekt auf Ihre gebündelten .mo-Dateien verweist.

Alternativ können Sie ein Plugin wie Query Monitor installieren. Öffnen Sie eine beliebige Seite und schauen Sie unter Sprachen nach, um zu sehen, welche .mo Datei für Ihre Textdomain geladen wird.