WooCommerce Produktfilter übersetzen: Polylang, WPML und Loco
In einem mehrsprachigen Shop ist der Produktfilter oft nur halb übersetzt: Die Farbnamen wechseln die Sprache, aber die Blocktitel, der Button Filtern (Filter) oder Alle bereinigen (Clear All) bleiben in der Originalsprache. Der Filter zeigt Texte aus mehreren Quellen, und jede davon wird an einer anderen Stelle übersetzt. Diese Anleitung zeigt, wie Sie die Beschriftungen Ihres WooCommerce Produktfilters mit Polylang, WPML oder Loco Translate übersetzen, Quelle für Quelle und mit der genauen Syntax, die das Plugin erwartet.
Woher die einzelnen Filtertexte kommen
| Text im Filter | Woher er stammt | Wo er übersetzt wird |
|---|---|---|
| Begriffsnamen: Kategorien, Farben, Größen | WordPress-Begriffe | Ihr Mehrsprachigkeits-Plugin, wie bei jeder Kategorie oder jedem Attributbegriff |
| Blocktitel ohne individuelles Label | Der Taxonomiename, bei Attributen "Product Color" und so weiter | Ihr Mehrsprachigkeits-Plugin, besser aber ein individuelles Label (siehe unten) |
| Texte, die Sie in den Filtereinstellungen eingegeben haben: individuelle Labels, Button-Texte, Platzhalter, Umschalt- und Weitere Produkte (Show more)-Texte, Tooltips, Titel und Optionen von Meta-Filtern, Abschnittstitel | HUSKY-Einstellungen | WPML-Taxonomie-Label-Übersetzungen (WPML taxonomies labels translations) unter Erweitert (Advanced) → Code |
| Integrierte Oberflächentexte: Filtern (Filter), Zurücksetzen (Reset), Alle bereinigen (Clear All), Preisbereich (price range), Auf Lager (In stock), Produktfilterformular anzeigen (Show products filter form) | Text Domain woocommerce-products-filter | WPML String Translation, Loco Translate oder .po/.mo-Dateien |
| Titel des Filter-Widgets | Das WordPress-Widget | Widget-Übersetzung Ihres Mehrsprachigkeits-Plugins |
Die meisten gescheiterten Versuche übersetzen einen Text an der falschen Stelle, etwa einen Attributtitel in Loco Translate oder ein individuelles Label in der WPML String Translation, wo das Plugin es nie registriert.
WooCommerce Produktfilter mit Polylang oder WPML übersetzen
Filtertitel und alle Texte, die Sie in die Plugin-Einstellungen eingeben, werden über eine einzige Zuordnungstabelle im Plugin übersetzt. Sie funktioniert mit WPML und Polylang gleich; das Feld erscheint nur, wenn eines von beiden aktiv ist.
- Geben Sie dem Block ein festes Original. Klicken Sie auf dem Tab Struktur (Structure) auf das Zahnrad (Zusatzoptionen (additional options)) neben der Taxonomie und füllen Sie Individuelles Taxonomie-Label (Taxonomy custom label) aus, zum Beispiel
Color. Ohne individuelles Label ist das Original der Taxonomiename, den WordPress in der aktuellen Sprache liefert. Bei Attributen bildet WooCommerce ihn als "Product Color", und ein Übersetzungs-Plugin hat ihn möglicherweise schon geändert, sodass eine für eine Form geschriebene Zeile in einer anderen Sprache nicht passt. - Öffnen Sie Erweitert (Advanced) → Code → WPML-Taxonomie-Label-Übersetzungen (WPML taxonomies labels translations) und fügen Sie pro Label und Sprache eine Zeile hinzu: Sprache, Doppelpunkt, Originaltext, Caret-Zeichen, Übersetzung.
- Verwenden Sie den richtigen Sprachcode. Bei WPML ist es der WPML-Sprachcode (
fr,de,pt-br). Bei Polylang ist es das Locale der Sprache (fr_FR,en_GB,uk), wie es in der Spalte Locale der Polylang-Sprachliste steht. Wer auf einer Polylang-Website miten_GBden Codeenverwendet, löst damit am häufigsten das Problem aus, dass sich nichts ändert. - Speichern Sie, leeren Sie dann den Seitencache und prüfen Sie die Seite in der anderen Sprache.
Für einen englischen Shop mit Französisch und Deutsch, unter WPML:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
Dasselbe unter Polylang:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
Die Standardsprache braucht keine Zeilen: Ohne Treffer wird das Original angezeigt.
Wie die Zuordnung funktioniert
- Das Original muss der Text sein, den der Block ohne Übersetzung anzeigen würde: das individuelle Label oder, wenn es keines gibt, der Taxonomiename. Leerzeichen an den Enden und die Groß- und Kleinschreibung spielen keine Rolle, und Labels in jeder Schrift funktionieren.
- Jede Zeile braucht das Sprachpräfix. Eine Zeile wie
Containertyp^Container typewird ignoriert. - Das Original darf einen Doppelpunkt enthalten, aber kein Caret-Zeichen: Das erste
^beendet es. - Es ist eine Tabelle, keine Einstellung pro Feld. Eine Zeile übersetzt diesen Text überall, wo er den Filter durchläuft: den Blocktitel, den Titel im Panel der ausgewählten Filter, einen Button oder einen Platzhalter.
Dieselbe Tabelle übersetzt auch die Texte, die Sie in die Einstellungen eingegeben haben: Text für Filter-Button (Filter button text) und Text für Zurücksetzen-Button (Reset button text), den Titel des Preisfilters, die Platzhalter der Text-, SKU- und Autorensuche, die Umschalttexte, die Texte Weitere Produkte (Show more) und Zeige weniger (Show less), Tooltips, Titel und Optionen von Meta- und ACF-Filtern sowie Abschnittstitel. Schreiben Sie die Zeile mit genau dem Text, den Sie eingegeben haben, zum Beispiel fr:Sort by price^Trier par prix.
Eine Nebenwirkung ist für eigenes CSS wichtig: Jeder Block erhält auch eine Klasse, die aus dem angezeigten Titel gebildet wird, also woof_container_couleur auf der französischen Seite und woof_container_color auf der englischen. Gestalten Sie Blöcke über die Klasse, die aus dem Taxonomie-Slug gebildet wird, etwa .woof_container_pa_color, die in jeder Sprache gleich ist.
Oberflächentexte: Loco Translate, WPML String Translation und .po-Dateien
Die integrierten Texte des Plugins sind gewöhnliche WordPress-Strings in der Text Domain woocommerce-products-filter. Zwei Einstellungen wirken sich auf sie aus: Text für Filter-Button (Filter button text) und Text für Zurücksetzen-Button (Reset button text). Sind diese Felder leer, verwenden die Buttons die übersetzbaren Standardtexte Filtern (Filter) und Zurücksetzen (Reset); sobald Sie einen eigenen Text eingeben, wird er zu einem Einstellungstext und gehört in die oben beschriebene Zuordnungstabelle.
WPML. Scannen Sie das Plugin unter WPML → Theme and plugins localization und übersetzen Sie dann die Strings der Domain woocommerce-products-filter in der String Translation.
Loco Translate, auch die übliche Wahl mit Polylang, dessen String-Liste keine Plugin-Strings enthält:
- Gehen Sie zu Loco Translate → Plugins, öffnen Sie HUSKY und fügen Sie eine neue Sprache hinzu.
- Wählen Sie den Speicherort Custom oder System, nicht den plugineigenen Ordner
languages. Plugin-Updates ersetzen diesen Ordner, und in 3.4.6 lädt das Plugin keine Übersetzungsdateien daraus. - Öffnen Sie vor dem Synchronisieren Loco Translate → Einstellungen (Settings) und erhöhen Sie Skip PHP files larger than auf mindestens 200 KB. Die Hauptdatei des Plugins ist etwa 145 KB groß und enthält Strings wie Alle bereinigen (Clear All), Preisbereich (price range), die Sortiernamen im Panel der ausgewählten Filter und Produktfilterformular anzeigen (Show products filter form). Mit dem Standardlimit von 100 KB überspringt Loco die Datei, diese Strings fehlen, und eine Synchronisierung entfernt sie aus einer bestehenden Übersetzung.
- Synchronisieren, übersetzen, speichern. Loco kompiliert die .mo-Datei neben der .po-Datei.
Fertige Übersetzungsdateien für viele Sprachen finden Sie auf der Übersetzungsseite. Welches Werkzeug Sie auch verwenden: Der Dateiname muss mit dem exakten Locale Ihrer Website enden, zum Beispiel woocommerce-products-filter-de_DE.mo, und die Datei gehört nach wp-content/languages/plugins/ oder in den benutzerdefinierten Ordner von Loco. Die FAQ Arbeiten mit WPML enthält die Kurzfassung der Tabellensyntax.
Einzelne Strings per Hook, pro Sprache
Manche Texte lassen sich im Code leichter festlegen, besonders wenn derselbe Text je nach Sprache abweichen soll. Diese Hooks gibt es in 3.4.6:
- woof_filter_title: erhält jeden Text, der die Zuordnungstabelle durchläuft, und zwar nach der Tabelle, sodass er jeden Blocktitel, Button oder Platzhalter ändern kann.
- woof_clear_all_text: der Link Alle bereinigen (Clear All) im Panel der ausgewählten Filter.
- woof_start_filtering_btn_txt: der Button Produktfilterformular anzeigen (Show products filter form).
woof_ext_custom_title_by_instock,woof_ext_custom_title_by_onsales,woof_ext_custom_title_by_featured,woof_ext_custom_title_by_backorder: Labels der Checkboxen für Auf Lager, Im Angebot, Hervorgehoben und Lieferrückstand.
/*
* Product filter: per-language texts set in code.
* Child theme functions.php or a code snippets plugin.
*/
function my_filter_lang() {
if (function_exists('pll_current_language')) {
return pll_current_language(); // Polylang: language slug, e.g. "fr"
}
return apply_filters('wpml_current_language', null); // WPML: language code
}
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
$texts = array(
'en' => array('Formations' => 'Bands'),
'de' => array('Formations' => 'Besetzungen'),
);
return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);
add_filter('woof_clear_all_text', function ($text) {
return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});
Beachten Sie, dass die Sprache hier der Polylang-Slug (fr) ist, nicht das Locale aus der Zuordnungstabelle.
Begriffe, Begriffsreihenfolge und Swatches in anderen Sprachen
Der Filter gibt die Begriffe der aktuellen Sprache aus, die WordPress liefert. Erscheint ein Wert in der Originalsprache, ist der Begriff selbst noch nicht übersetzt: Übersetzen Sie ihn in WPML (Attribute über WooCommerce Multilingual) oder in Polylang. Ist er übersetzt und zeigt trotzdem den alten Namen, leeren Sie den Seitencache und den Cache Cache-Begriffe (Cache terms) des Plugins mit dem Button Begriffs-Cache löschen (clear terms cache) unter Erweitert (Advanced) → Optionen (Options).
Übersetzte Begriffe sind eigene Begriffe mit eigener Reihenfolge. Um die Reihenfolge der Standardsprache zu übernehmen, öffnen Sie die Begriffsliste (Produkte (Products) → Kategorien (Categories) oder Produkte (Products) → Attribute (Attributes) → Begriffe konfigurieren (Configure terms)), wechseln Sie die Admin-Sprache und ordnen Sie die Begriffe neu an. Farben und Bilder der Typen Color und Image müssen nur bei den Begriffen der Standardsprache gesetzt werden: Ein übersetzter Begriff ohne eigene Farbe oder eigenes Bild verwendet die seines Originals.
Checkliste
- Jeder Block, dessen Titel übersetzt werden soll, hat ein Individuelles Taxonomie-Label (Taxonomy custom label), und die Zeilen unter WPML-Taxonomie-Label-Übersetzungen (WPML taxonomies labels translations) wiederholen dieses Label exakt.
- Das Sprachpräfix ist unter WPML der WPML-Sprachcode und unter Polylang das vollständige Locale.
- In Einstellungsfelder eingegebene Texte stehen in der Zuordnungstabelle; integrierte Strings werden in der Domain
woocommerce-products-filterübersetzt. - Die Loco-Dateien liegen im Speicherort Custom oder System, und das PHP-Größenlimit wurde vor dem Synchronisieren erhöht.
- Eigenes CSS spricht Blöcke über den Taxonomie-Slug an, nicht über den Titel.
- Seitencache und Begriffs-Cache wurden vor dem Test der zweiten Sprache geleert.
Wenn sich ein Label trotzdem nicht ändern lässt, eröffnen Sie im HUSKY-Support-Forum ein Thema mit dem Link zur Seite in der zweiten Sprache, dem verwendeten Übersetzungs-Plugin und den Zeilen, die Sie hinzugefügt haben.