Internationalisieren Sie Ihr WordPress-Plugin

WordPress-Plugins ermöglichen es Ihnen, Ihr Blog einfach zu ändern und zu verbessern, indem Sie neue Funktionen hinzufügen, die im Basiscode nicht verfügbar sind.

Die Verwendung von Plugins funktioniert effektiver als der Versuch, die gesamte Kernprogrammierung von WordPress zu ändern. Definiert als ein Programm oder eine Reihe von Funktionen, die in PHP geschrieben sind, fügen Plugins spezifische Funktionen hinzu, die leicht über die WordPress API in den Blog integriert werden können.

Wenn Sie ein WordPress-Plugin geschrieben haben, können Sie es viel leichter zugänglich machen, indem Sie es in eine andere Sprache übersetzen. Dies wird als Internationalisierung bezeichnet.

Internationalisierung vs. Lokalisierung

Bevor Sie Ihr Plugin internationalisieren können, müssen Sie wissen, was es bedeutet. Auch bekannt als i18n, bedeutet dies, das Plugin so zu modifizieren, dass andere Kulturen, die andere Sprachen sprechen, Ihr Plugin einfach benutzen können.

Lokalisierung dagegen ist der eigentliche Modifikationsprozess.

Internationalisierung ist mehr als nur die Schnittstelle zu übersetzen. Zum Beispiel müssen Annahmen, die Sie über imperiale Einheiten und metrische Einheiten getroffen haben, Interpunktionszeichen wie die Verwendung eines Kommas zur Trennung von Tausenden anstelle eines Zeitraums sowie andere kulturelle Themen angesprochen werden, bevor Sie Ihre Arbeit richtig lokalisieren können.

Während dies ein Leitfaden ist, der sich darauf konzentriert, ein Plugin zu lokalisieren, ist es dennoch wichtig, diese zusätzlichen Anpassungen zu berücksichtigen.

Domains und Initialisierung

Wenn Sie Ihr Plugin lokalisieren, müssen Sie eine Textdomäne erstellen, die getrennt von denen ist, die WordPress verwendet oder die von anderen Plugins definiert wurden. Was immer Sie für eine Textdomäne verwenden möchten, liegt an Ihnen, aber Sie sollten etwas Einzigartiges und Sinnvolles auswählen, das mit dem Inhalt Ihres Plugins zusammenhängt.

Bevor Sie Ihr Plugin vollständig lokalisieren können, müssen Sie WordPress mitteilen, wie es Ihre Strings finden kann. Wenn der Code nicht bereits vorhanden ist, müssen Sie etwas wie die folgende Zeile in Ihre Codierung einfügen:

add_action( 'init', 'myFunction' );

Dieser Code kommuniziert mit WordPress, um ihm mitzuteilen, dass er die Funktion myFunction nach dem Laden verwenden soll. Diese Funktion benennt dann Ihre Textdomäne nach WordPress und zeigt ihr, wie sie die lokalisierten Strings laden kann, was ähnlich aussehen sollte:

function myFunction() {load_plugin_textdomain( 'mytextdomain', 'wp-content/plugins' );}

Die WordPress-Funktion load_plugin_textdomain informiert WordPress darüber, dass es eine Textdomäne namens mytextdomain gibt und die Dateien mit den lokalisierten Strings im Serverordner wp-content / plugin liegen. (Wenn Sie Ihre Plug-in-Dateien in einen anderen Ordner und Pfad verschieben, müssen Sie dies natürlich durch den entsprechenden Pfad ersetzen.)

Internationales Image über Shutterstock.

Strings vorbereiten

Nach der Initialisierung müssen Sie die statischen Zeichenfolgen in eine Funktion ändern, mit der WordPress die richtige lokalisierte Version dieser Zeichenfolge verwenden kann. Schließlich funktioniert es nicht gut, dass WordPress die falsche Sprache zieht.

Diese Funktion bietet einen kurzen Namen, der die Internationalisierung erleichtert: die Double-Underbar-Funktion _ (string, domain). Die Funktion hat zwei Parameter, der erste ist der Standard-String, den das Plugin verwendet, sollte keine lokalisierte Version verfügbar sein. Der zweite Parameter ist dieselbe Textdomäne, die Sie zuvor im Code ausgewählt haben.

Vor diesem Schritt könnte Ihr Code wie folgt aussehen:

function addMyAdminPage() {add_options_page('A Page Title','A Menu Title',7, __FILE__, 'myAdminFunction' );}

Nach dem Hinzufügen des Codes könnte es so aussehen:

function addMyAdminPage() {add_options_page(__( 'A Page Title', 'textdomain' ),__( 'A Menu Title', 'textdomain' ),7, __FILE__, 'myAdminFunction' );}

Internationales Image über Shutterstock.

Lokalisierung

Mit all den Vorbereitungen sind Sie endlich bereit für den eigentlichen Prozess, Ihr WordPress-Plugin in mehrere Sprachen zu verwandeln.

Um eine Lokalisierung für Ihr Plugin zu erstellen, müssen Sie eine .po-Datei mit einem Namen, der dem Namen Ihrer Plug-in-Datei entspricht, sowie den ISO-639-Zwei-Buchstaben-Codes für jedes Land und jede Sprache erstellen. Wenn Ihr Plugin beispielsweise exemplarname heißt und Sie es nach Spanisch (Europäisch) lokalisieren möchten, würde es als "exemplarname-es_ES.po" angezeigt.

Während der WordPress-Codex Tools anbietet, die bei der Lokalisierung helfen können, ist es oft besser, einfach die .po-Datei von einem Plugin als Ausgangspunkt zu verwenden. .po-Dateien bestehen aus einem einzelnen Header und dann aus Übersetzungspaaren:

msgid "Options"msgstr "Opciones"

Die msgid ist die Standardzeichenfolge, die in der Double-Underbar-Funktion angezeigt wird, die Sie diktieren. Mit der erstellten .po-Datei können Sie eines der Tools verwenden, die WordPress anbietet, um eine .mo-Datei zu erstellen, die die andere Datei ist, die WordPress benötigt.

Andere Übersetzer helfen lassen

Niemand kennt jede einzelne Sprache. Daher sollten Sie Ihre Ressourcen erweitern und andere Menschen bei der Übersetzung in andere Sprachen unterstützen lassen. Sie müssen sich jedoch einem speziellen Verfahren unterziehen, um die notwendigen Dateien für Ihre Übersetzer zu erstellen, da Sie nicht möchten, dass der Quellcode versehentlich unterbrochen wird.

Die Datei, die Sie Übersetzern geben möchten, ist eine POT-Datei, die ähnlich aussieht:

#: wp-admin/admin-header.php:49msgid "Options"msgstr ""

Es gibt zwei Möglichkeiten, diese Datei zu generieren. Wenn Sie Ihr Plugin in das Repository gestellt haben, gehen Sie einfach auf die Admin-Seite und wählen Sie "Generate POT file". Diese Datei wird an Übersetzer geschickt, damit sie sie lokalisieren können. Sie werden jedoch wahrscheinlich Ihr Plug-in mitgeben, damit die Übersetzer Ihnen keine Fragen zum Plugin stellen müssen.

Wenn Sie Ihr Plugin noch nicht im Repository haben, können Sie das WordPress I18n Tools Verzeichnis und verwende das Skript makepot.php wie folgt:

php makepot.php wp-plugin the-plugin-directory

Denken Sie daran, dass Sie Ihr GNU Internationalisierungsprogramm auf Ihrem Server installieren müssen, bevor Sie diesen Befehl ausführen.

Internationales Image über Shutterstock.

Testen

Mit all Ihren lokalisierten Dateien ist es an der Zeit, sie zu testen und zu sehen, ob Sie etwas vergessen haben. Testen Sie Ihre Lokalisierung, indem Sie eine einfache Zeile in Ihrer WordPress-Konfiguration ändern, um sie so zu überlisten, dass sie eine andere Datei verwenden soll. Ändern Sie die Datei wp-config und suchen Sie die folgende Zeile:

define ('WPLANG', 'en_US');

Wenn diese Zeile noch nicht existiert, sollten Sie überprüfen, ob Ihre Installation noch funktioniert. Wenn ja, kehren Sie zu der Datei zurück und ändern Sie den Länder- und Sprachcode. Im vorherigen Beispiel wäre das wie folgt:

define ('WPLANG', 'es_ES');

Aktivieren Sie schließlich Ihr Plugin, um zu testen, wie es aussieht. Denken Sie daran, nach dem Testen wieder zur ursprünglichen Standardsprache zurückzukehren.

Aktualisieren Sie Ihr Plugin

Mit all den Änderungen, die WordPress im Laufe der Zeit macht, ist Ihr Plugin möglicherweise nicht voll funktionsfähig mit nachfolgenden Updates. Stellen Sie sicher, dass Sie sich immer die Zeit nehmen, Ihr Plugin zu aktualisieren, wann immer dies möglich ist. Vorausgesetzt, Sie haben es bereits im WordPress Plugin Repository gehostet, können Sie einige Schritte unternehmen, um neue Funktionen hinzuzufügen oder Patches im Laufe der Zeit zu aktualisieren. Sie können dies so oft wie nötig tun.

Wenn Sie mit der Aktualisierung Ihres Plugins fertig sind und die neueste Version veröffentlichen möchten, müssen Sie eine Checkliste beachten:

Testen Sie Ihr Plugin und stellen Sie sicher, dass die neueste Version korrekt funktioniert. Achte darauf, dass du die verschiedenen WordPress Versionen im Kopf hast und probiere sie mit jeder Version aus. Testen Sie nicht einfach neue Funktionen, da Sie auch ältere Funktionen versehentlich unterbrechen können.
Gehen Sie in den Stammordner und ändern Sie den Header-Kommentar in der PHP-Hauptdatei, damit Sie die Versionsnummer aktualisieren können. Stellen Sie sicher, dass Sie auch die Versionsnummer in der readme.txt-Datei im Stammordner im stable-Tag-Feld ändern.
Es ist immer ratsam, einen anderen Unterabschnitt des Changelog-Bereichs der Datei readme.txt zu erstellen, damit Sie kurz beschreiben können, was in der neuesten Version im Vergleich zur vorherigen Version neu ist. Was auch immer Sie hier eingeben, wird dem Tab "Änderungsprotokoll" auf der Seite für Ihr Plugin hinzugefügt.
Stellen Sie sicher, dass Sie ein neues SVN-Tag als Teil des Trunks erstellen.
Warten Sie einige Minuten, bis das System die neuen Änderungen registriert hat. Gehen Sie dann zu Ihrer Plug-in-Seite und zu einem Blog, in dem Ihr neues Plug-in installiert ist, um sicherzustellen, dass alles ordnungsgemäß aktualisiert wurde. Beachten Sie, dass diese Update-Prüfungen zwischengespeichert werden können. Es kann daher erforderlich sein, ein wenig länger auf eine vollständige Aktualisierung zu warten.

Alles in allem gibt es nicht viel anderes, um Ihr Plugin in verschiedene Sprachen zu internationalisieren. Solange Sie diese Schritte genau befolgen, können Sie Ihr Plugin in so viele verschiedene Sprachen wie nötig lokalisieren.

Hast du ein WordPress-Plugin lokalisiert? Welche Sprachen wünschen sich häufiger? Lassen Sie es uns in den Kommentaren wissen.

WordPress-Plugins erstellen WordPress i18n Wordpress Internationalisierung WordPress-Sprachen Wordpress-Lokalisierung Wordpress-Topf-Dateien