WordPress-Plugins und -Themes sind Werkzeuge, mit denen Sie die Funktionalität und das Aussehen Ihrer WordPress-Website anpassen können. Viele von ihnen enthalten Einstellungen und Konfigurationsoptionen, mit denen Sie Dinge nach Ihren Bedürfnissen anpassen können. Easy Digital Downloads gibt Ihnen beispielsweise die Möglichkeit, den E-Mail-Betreff und die Kopfzeile der Kaufbeleg-E-Mail zu steuern, die nach einem Kauf an die Kunden gesendet wird:
Während diese Arten von Einstellungen praktisch sind, wenn Sie Text ändern müssen, der in einem Plugin oder Theme enthalten ist, ist es nicht praktikabel, solche Einstellungen für
alle Textzeichenfolgen aufzunehmen. Einige Textzeichenfolgen, ob für Benutzer angezeigt oder nur im WordPress-Adminbereich, werden als für die Betrachter ausreichend angesehen und können nicht einfach geändert werden.
Hier kommt das
Say What? WordPress-Plugin ins Spiel. Say What? nutzt einen WordPress-Standard, der Plugin- und Theme-Entwickler dazu ermutigt, alle Textzeichenfolgen „übersetzungsbereit“ zu machen. Wenn eine Textzeichenfolge übersetzungsbereit ist, bedeutet dies, dass mit der richtigen WordPress-Konfiguration das Plugin oder Theme in eine andere Sprache übersetzt werden kann.
Say What? kann diese übersetzungsbereiten Textzeichenfolgen einzeln anvisieren und nach Bedarf ändern.
Say What? zur Änderung einer Textzeichenfolge verwenden
Betrachten wir ein einfaches Beispiel, wie eine Textzeichenfolge mit dem
Say What?-Plugin geändert werden kann.
Wenn ein Produkt in Easy Digital Downloads in den Warenkorb gelegt wird und der Kunde zur Kasse geht, wird der Kassen-Warenkorb mit einer Liste der Produkte angezeigt, die der Kunde in den Warenkorb gelegt hat.
Beachten Sie die Überschriften „Artikelname“, „Artikelpreis“ und „Aktionen“, die über den Spalten im Kassen-Warenkorb angezeigt werden. Dies sind Textzeichenfolgen, die in Easy Digital Downloads enthalten sind. Es gibt jedoch keine Einstellungen, um diesen Text zu ändern. Wir werden also
Say What? verwenden, um den Text „Artikelname“ mit den folgenden Schritten zu ändern.
1. Installieren und aktivieren Sie
Say What?. Wenn Sie nicht wissen, wie man ein WordPress-Plugin installiert, lesen Sie diesen Artikel von WP Beginners.
2. Nach der Aktivierung gehen Sie in Ihrem WordPress-Dashboard zu
Tools -> Textänderungen und klicken Sie oben auf der Seite auf die Schaltfläche Neu hinzufügen.
3. Sie werden mit vier Textfeldern konfrontiert:
Originalzeichenfolge, Textdomain, Textkontext und Ersetzungszeichenfolge.
- Originalzeichenfolge – Dieses Feld ist für den Text, den Sie ändern möchten. In diesem Fall möchten wir die Textzeichenfolge „Artikelname“ ändern, also geben Sie genau das in das Feld ein. Hinweis: Dieses Feld ist Groß- und Kleinschreibungsempfindlich. Das bedeutet, Sie müssen den Text genau so eingeben, wie er angezeigt wird. „Artikelname“ und „artikelname“ sind nicht dieselbe Textzeichenfolge.
- Textdomain – Dieses Feld erfordert eine eindeutige Kennung, die jedes Plugin oder Theme haben muss. Für Easy Digital Downloads ist die Textdomain
easy-digital-downloads. Wenn Sie Hilfe beim Finden der Textdomain für ein anderes Plugin oder Theme benötigen, wenden Sie sich bitte an den Entwickler. - Textkontext – Dieses Feld ist nicht immer erforderlich. Manchmal sind zwei oder mehr Textzeichenfolgen in einem einzelnen Plugin oder Theme exakt gleich. Wenn dies geschieht, stellen Entwickler normalerweise einen Kontext für jede Textzeichenfolge bereit, der hilft zu identifizieren, wo jede bestimmte Zeichenfolge verwendet wird. In den meisten Fällen kann dieses Feld leer gelassen werden.
- Ersatzzeichenfolge – Dieses Feld ist Ihr Spielplatz. Der Text, den Sie in das Feld Originalzeichenfolge eingeben, wird durch alles ersetzt, was Sie in dieses Feld eingeben.
4. Speichern Sie Ihre neue Textänderung und überprüfen Sie die Ergebnisse.
Hier ist ein Blick auf eine Textänderung, die zu unserem Beispiel passt:
Mit dieser Textänderung können wir erwarten, dass „Artikelname“ durch „Mein benutzerdefinierter Text“ im Warenkorb ersetzt wird.
Erfolg!
Fehlerbehebung & häufige Probleme
Es gibt Zeiten, in denen die Verwendung von
Say What? etwas komplizierter ist als das obige Beispiel. Wenn Sie eine neue Textänderung vorgenommen haben und diese nicht richtig funktioniert, gibt es ein paar verschiedene Dinge zu überprüfen.
Groß-/Kleinschreibung
Stellen Sie sicher, dass Ihr
Originalzeichenfolge-Wert das gleiche Groß-/Kleinschreibungsmuster wie die Textzeichenfolge verwendet, die Sie ändern möchten. Mein Text ist nicht dasselbe wie mein text.
Platzhalter
Übersetzungsbereite Zeichenfolgen in WordPress können in PHP-Code eingeschlossen sein, der es ermöglicht, Teile des Textes durch Platzhalter zu ersetzen.
Zum Beispiel zeigt Easy Digital Downloads auf der Checkout-Seite eine Fehlermeldung an, wenn ein Kunde versucht, einen Kauf mit einer E-Mail-Adresse abzuschließen, die einem anderen Kunden gehört. Die folgende Nachricht wird angezeigt:
Die E-Mail-Adresse [email protected] wird bereits verwendet.
Während dies für den Kunden wie eine normale Textzeichenfolge aussieht, verwendet die tatsächliche Textzeichenfolge einen PHP-Platzhalter, um es der E-Mail-Adresse zu ermöglichen, einen anderen Wert basierend auf der E-Mail-Adresse zu haben, die der Kunde zu verwenden versucht. Die tatsächliche Textzeichenfolge sieht also so aus:
Die E-Mail-Adresse %s wird bereits verwendet.
Wie Sie sehen können,
%s ist der Platzhalter für die E-Mail-Adresse. Wenn Sie Ihre Textänderung in Say What? erstellen, muss Ihr Wert im Feld Originalzeichenfolge die Textzeichenfolge so wie sie ist enthalten, was bedeutet, dass Ihr Wert einen oder mehrere PHP-Platzhalter enthalten kann.
Textkontext erforderlich
Es ist nicht ungewöhnlich, dass zwei verschiedene Textzeichenfolgen exakt gleich sind. Wenn dies vorkommt, werden Entwickler ermutigt, einen Kontext bereitzustellen, der erklärt, wo jede Textzeichenfolge verwendet wird, um sie voneinander zu unterscheiden.
Wenn Sie den Code einer Plugin- oder Theme-Datei nach einer bestimmten Textzeichenfolge durchsuchen würden, z. B. der Textzeichenfolge „Speichern“ in einem bestimmten Plugin, stellen Sie möglicherweise fest, dass diese exakte Textzeichenfolge an drei verschiedenen Stellen verwendet wird. Das bedeutet, dass ohne Kontext die Änderung der Textzeichenfolge Änderungen an allen drei Stellen verursacht. Um dies zu vermeiden, bemerken Sie möglicherweise eine übersetzungsbereite Textzeichenfolge in der Codebasis, die wie folgt aussieht:
__( 'Speichern', 'the button for saving plugin settings', 'text-domain');
Diese Textzeichenfolge bietet einen Kontext von
the button for saving plugin settings. Wenn Sie Ihre Textänderung in Say What? erstellen, stellen Sie sicher, dass Sie diesen exakten Wert in das Feld Text context eingeben.
Hinweise & Tipps
Manchmal ist es etwas mühsam, eine Textzeichenfolge aufzuspüren. Die Textzeichenfolge selbst ist möglicherweise nicht immer mit dem Text identisch, den Sie auf Ihrer Website angezeigt sehen.
Eine schnelle Möglichkeit, die exakte Textzeichenfolge zu finden, nach der Sie suchen, besteht darin, im Stammverzeichnis des Plugins oder Themes nach einem Verzeichnis
languages zu suchen und dann dieses Verzeichnis nach einer Datei mit der Endung .pot zu durchsuchen. Diese Datei sollte eine vollständige Liste der vom Plugin oder Theme bereitgestellten übersetzungsbereiten Zeichenfolgen enthalten. Durchsuchen Sie die Liste strategisch nach Ihrer Zeichenfolge. Sie möchten beispielsweise nach „already in use“ suchen, wenn Sie nach der Zeichenfolge aus unserem Platzhalterbeispiel suchen.
Wenn Sie eine Textzeichenfolge nicht finden können, wenden Sie sich an den Support für das Plugin oder Theme und bitten Sie um Hilfe bei der Suche. Es könnte sein, dass Sie sie einfach übersehen haben oder dass die Textzeichenfolge nicht übersetzungsbereit ist.
