WooCommerce Filtertitel ändern: Präfix „Product“ entfernen
Product Color, Product Size, Product Material: Beginnt jeder Attributblock im Filter Ihres Shops mit demselben Wort, gibt der Filter nur den Namen aus, den WooCommerce dem Attribut gegeben hat. Um das Präfix „Product“ aus den Titeln des WooCommerce-Filters zu entfernen, geben Sie dem Block einen eigenen Titel, entweder einzeln in den Filtereinstellungen oder für alle Attribute auf einmal mit ein paar Zeilen Code. An denselben Stellen steuern Sie auch die übrigen Texte des Filters: die Blocktitel, die erste Option einer Dropdown-Liste, Alle bereinigen (Clear All), Zurücksetzen (Reset), Filtern (Filter), Weitere Produkte (Show more) und sogar die Namen einzelner Begriffe. Alle lassen sich ändern, ohne Plugin-Dateien zu bearbeiten.
Woher die einzelnen Texte im Filter kommen
HUSKY speichert keinen eigenen Namen für eine Taxonomie. Es fragt WordPress nach dem Plural-Namen der Taxonomie und gibt ihn aus, sofern Sie kein individuelles Label setzen. WooCommerce registriert jedes globale Attribut mit dem Plural-Namen Product %s, sodass das Attribut Farbe (Color) zu einer Taxonomie namens „Product Color“ wird, während ihr Singular-Name „Color“ bleibt. Kategorien und Schlagwörter funktionieren genauso: Ihre Plural-Namen lauten „Product categories“ und „Product tags“. Die Tabelle zeigt, woher jeder sichtbare Text stammt und wo Sie ihn ändern.
| Text auf der Seite | Woher er stammt | Wo Sie ihn ändern |
|---|---|---|
| Überschrift über dem gesamten Filter („HUSKY Filter“) | Der Widget-Titel | Das Feld Überschrift (Title) des Widgets |
| Titel eines Blocks (Product Color, Product categories) | Der Taxonomiename | Individuelles Taxonomie-Label (Taxonomy custom label) oder der Hook woof_filter_title |
| Erste Option einer Dropdown-Liste | Derselbe Taxonomiename | Der Blocktitel oder eine Kopie der Dropdown-Vorlage |
| Titel des Preisfilters | Der Text der Überschrift (Title text) des Preisfilters | Zusatzoptionen von Suche nach Preis (Search by Price) |
| Auf Lager (In stock), Zum Verkauf (On sale), Hervorgehobene Produkte (Featured products) | Texte der Erweiterungen | Die Hooks woof_ext_custom_title_* |
| Alle bereinigen (Clear All) im Panel der aktiven Filter | Plugin-String | Der Hook woof_clear_all_text |
| Buttons Filtern (Filter) und Zurücksetzen (Reset), Label Bestellung über (orderby) | Plugin-Strings und Optionen | Der Tab Optionen oder eine Übersetzung |
| Weitere Produkte (Show more) / Zeige weniger (Show less), mobil Filter öffnen (Open filter) / Filter schließen (Close filter) | Optionen des Tabs Design | Der Tab Design |
| Name eines einzelnen Begriffs | Der Begriff selbst | Der Hook woof_sort_terms_before_out |
Das Präfix „Product“ aus WooCommerce-Filtertiteln entfernen
Es gibt drei Wege, vom engsten bis zum weitesten Wirkungsbereich. Wählen Sie einen; Sie brauchen nicht alle.
Ein Block nach dem anderen: Individuelles Taxonomie-Label
- Öffnen Sie WooCommerce > Einstellungen > Products Filter (WooCommerce > Settings > Products Filter), Tab Struktur (Structure).
- Klicken Sie in der Zeile des Attributs (zum Beispiel
pa_color) auf das Zahnradsymbol, Zusatzoptionen (additional options). - Geben Sie den gewünschten Titel in Individuelles Taxonomie-Label (Taxonomy custom label) ein, zum Beispiel
Color. Lassen Sie das Feld leer, um zum Namen von WooCommerce zurückzukehren. - Klicken Sie im Popup auf Übernehmen (Apply) und dann unten auf der Einstellungsseite auf Änderungen speichern (Save changes).
Das individuelle Label ersetzt den Taxonomienamen überall, wo der Filter ihn verwendet: im Blocktitel, in der ersten Option einer Dropdown-Liste, im Platzhalter einer Mehrfachauswahl und in der Bezeichnung des ausgewählten Werts im Panel der aktiven Filter. So benennen Sie auch „Product categories“ in „Categories“ oder „Shop by type“ um oder geben einer Marken-Taxonomie einen anderen Titel. Bei einer hierarchischen Dropdown-Liste enthält dasselbe Feld die Titel aller Ebenen; die Anleitung zum Filter nach Baujahr, Marke und Modell erklärt dieses Format.
Alle Attribute auf einmal: der Hook woof_filter_title
Bei zwanzig Attributen ist es mühsam, für jedes ein Label einzutippen, und jedes neue Attribut braucht es erneut. Jeder Blocktitel des Filters durchläuft den Hook woof_filter_title, sodass ein einziges Snippet den Namen „Product ...“ jedes Attributs durch seinen Singular-Namen ersetzen kann:
/*
* HUSKY: show "Color" instead of "Product Color" in attribute filter titles.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
if (is_object($taxonomy_info)
&& isset($taxonomy_info->name, $taxonomy_info->labels->name, $taxonomy_info->labels->singular_name)
&& 0 === strpos($taxonomy_info->name, 'pa_')
&& $title === $taxonomy_info->labels->name) {
// No custom label is set: use the attribute name without the prefix
return $taxonomy_info->labels->singular_name;
}
return $title;
}, 10, 3);
Die Prüfung $title === $taxonomy_info->labels->name lässt jedes von Ihnen gesetzte Individuelle Taxonomie-Label (Taxonomy custom label) unberührt: Das Snippet ändert nur Titel, die noch dem Namen von WooCommerce entsprechen. Außerhalb des Filters ändert es nichts. Der Hook erhält außerdem einige Button-Texte mit leerem $taxonomy_info, weshalb das Snippet zuerst is_object() prüft.
Überall auf der Website: den WooCommerce-String ändern
Soll das Präfix an jeder Stelle verschwinden, die Namen von Attribut-Taxonomien zeigt, auch in anderen Widgets und Admin-Bildschirmen, ändern Sie den WooCommerce-String selbst. Das Präfix stammt aus _x( 'Product %s', 'Product Attribute', 'woocommerce' ), sodass ein Übersetzungsfilter allein den Namen zurückgeben kann:
/*
* Remove the "Product" prefix from WooCommerce attribute names site-wide.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('gettext_with_context', function ($translation, $text, $context, $domain) {
if ('woocommerce' === $domain && 'Product Attribute' === $context && 'Product %s' === $text) {
return '%s';
}
return $translation;
}, 10, 4);
Dasselbe Ergebnis erreichen Sie mit Loco Translate, indem Sie Product %s in der Text Domain von WooCommerce zu %s übersetzen; speichern Sie die Datei im benutzerdefinierten Speicherort von Loco, damit ein WooCommerce-Update sie nicht überschreibt. Auf einer Website in einer anderen Sprache sehen Sie den übersetzten String (zum Beispiel „Produit %s“), das Snippet vergleicht aber den englischen Originaltext und funktioniert deshalb in jeder Website-Sprache.
Eine Nebenwirkung jeder Umbenennungsmethode: Jeder Block erhält auch eine CSS-Klasse, die aus seinem Titel gebildet wird, etwa woof_container_productcolor. Nach der Umbenennung wird daraus woof_container_color. Zielt Ihr eigenes CSS auf die alte Klasse, stellen Sie es auf die Klasse um, die auf dem Slug beruht, woof_container_pa_color; sie ändert sich nie.
Filtertitel und Widget-Überschrift ändern oder ausblenden
Der Text „HUSKY Filter“ über dem gesamten Filter ist keine Plugin-Einstellung: Er ist der Titel des Widgets. Öffnen Sie Design > Widgets (Appearance > Widgets) (oder den Block-Widget-Editor), öffnen Sie das HUSKY-Widget und ändern Sie sein Feld Überschrift (Title) oder leeren Sie es. Ein leerer Titel gibt nichts aus. Ein Filter, der mit dem Shortcode [woof] platziert wird, hat gar keine solche Überschrift.
Um den Titel eines einzelnen Blocks auszublenden, setzen Sie in dessen Zusatzoptionen Titel-Label anzeigen (Show title label) auf Nein (No). Das ist bei Dropdown-Listen üblich, wo die erste Option bereits sagt, worum es sich handelt. Der Preisfilter hat ein eigenes Feld: Öffnen Sie die Zusatzoptionen von Suche nach Preis (Search by Price) und füllen Sie Text der Überschrift (Title text) aus; ist es leer, hat der Preisblock keinen Titel. Bei einem Dropdown-Preisfilter legt Dropdown-Preisfiltertext (Drop-down price filter text) im selben Popup seine erste Option fest.
Eine Taxonomie hat einen Titel für den ganzen Shop. Braucht eine Kategorie einen anderen Titel, zum Beispiel „Shoe size“ in der Kategorie Shoes, behandelt das die FAQ zum Label pro Kategorie; am einfachsten ist im Code eine Bedingung innerhalb von woof_filter_title:
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
if (is_object($taxonomy_info) && 'pa_size' === $taxonomy_info->name && is_product_category('shoes')) {
return 'Shoe size';
}
return $title;
}, 10, 3);
Das funktioniert, wenn die Seite nach jeder Filteränderung neu geladen wird. Im AJAX-Modus wird das Filterformular durch eine Hintergrundanfrage neu aufgebaut, bei der is_product_category() false ist, sodass der Titel nach der ersten Auswahl auf den Standard zurückfällt.
Den Platzhaltertext der Dropdown-Liste ändern
Die erste Option einer Taxonomie-Dropdown-Liste, die „nichts ausgewählt“ bedeutet, gibt denselben Text aus wie der Blocktitel. Ein individuelles Label ändert deshalb beides. Sollen sich beide unterscheiden, zum Beispiel der Titel Farbe und die erste Option Beliebige Farbe, verwenden Sie eine Kopie der Dropdown-Vorlage. Das Plugin lädt sie über den Hook woof_html_types_view_select, sodass die Kopie in Ihrem Child-Theme liegen kann und Plugin-Updates übersteht.
- Kopieren Sie
wp-content/plugins/woocommerce-products-filter/views/html_types/select.phpnachwp-content/themes/your-child-theme/husky/select.php. - Weisen Sie das Plugin an, die Kopie zu verwenden:
/* * HUSKY: load the drop-down template from the child theme. * Child theme functions.php. */ add_filter('woof_html_types_view_select', function ($path) { $custom = get_stylesheet_directory() . '/husky/select.php'; return file_exists($custom) ? $custom : $path; }); - Suchen Sie in der Kopie die Zeile
<option value="0">und ersetzen Sie sie durch Ihren eigenen Text.$tax_slugsteht dort zur Verfügung, sodass eine Vorlage jede Dropdown-Liste bedienen kann:<option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>
Mehrfachauswahl-Blöcke zeigen den Titel als Platzhalter; ihre Vorlage ist views/html_types/mselect.php, die auf dieselbe Weise über woof_html_types_view_mselect geladen wird. Vergleichen Sie Ihre Kopie nach einem Plugin-Update mit dem neuen Original und übernehmen Sie Änderungen.
Alle bereinigen, Zurücksetzen, Filtern und andere integrierte Texte ändern
Die plugineigenen Texte fallen in drei Gruppen.
Optionen. Auf dem Tab Optionen (Options) legen Text für Filter-Button (Filter button text) und Text für Zurücksetzen-Button (Reset button text) die beiden Buttons des Formulars fest; schreiben Sie none in Text für Zurücksetzen-Button (Reset button text), um diesen Button auszublenden. In der kostenlosen Version werden beide Felder ignoriert und die Standardwörter angezeigt; ändern Sie sie mit dem Übersetzungs-Snippet weiter unten. Auf dem Tab Design finden Sie Text für Block mehr/weniger geöffnet (Text for block more/less opened) und Text für Block mehr/weniger geschlossen (Text for block more/less closed) (standardmäßig Weitere Produkte (Show more) und Zeige weniger (Show less), verwendet, wenn bei einem Block Nicht umgeschaltete Begriffe zählen (Not toggled terms count) gesetzt ist), außerdem Text für mobilen Filter-Button (Text for mobile filter button) und Text zum Schließen des mobilen Filters (Text to close mobile filter).
Hooks. Alle bereinigen (Clear All) im Panel der aktiven Filter hat einen eigenen Hook, woof_clear_all_text, und die Checkbox-Erweiterungen haben die Hooks woof_ext_custom_title_*: woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder und woof_ext_custom_title_stock_quantity.
/*
* HUSKY: rename built-in texts. Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_clear_all_text', function ($text) {
return 'Remove all filters';
});
add_filter('woof_ext_custom_title_by_instock', function ($title) {
return 'Only products in stock';
});
add_filter('woof_ext_custom_title_by_onsales', function ($title) {
return 'Discounted products';
});
Der Text Alle bereinigen (Clear All) wird in einen JavaScript-String in doppelten Anführungszeichen geschrieben, verwenden Sie darin also keine doppelten Anführungszeichen.
Übersetzung. Alles andere, etwa die Labels Bestellung über (orderby), pro Seite (per page) und Preisbereich (price range) des Panels der aktiven Filter sowie die Sortierwerte wie Beliebtheit (popularity), ist ein übersetzbarer String der Text Domain woocommerce-products-filter. In einem einsprachigen Shop ist das einfachste Werkzeug ein gettext-Filter mit einer Liste exakter Strings:
/*
* HUSKY: replace front-end strings. Child theme functions.php or a code snippets plugin.
*/
add_filter('gettext', function ($translation, $text, $domain) {
if ('woocommerce-products-filter' !== $domain || (is_admin() && ! wp_doing_ajax())) {
return $translation;
}
$texts = array(
'Filter' => 'Show products',
'Reset' => 'Start over',
'orderby' => 'Sort by',
'popularity' => 'Popularity',
'rating' => 'Rating',
);
return isset($texts[$text]) ? $texts[$text] : $translation;
}, 20, 3);
Die Strings müssen exakt übereinstimmen, einschließlich der Groß- und Kleinschreibung: Der Standardtext des Buttons ist Clear All, nicht „Clear all“. Die Bedingung is_admin() belässt die Einstellungsseiten des Plugins in ihrem ursprünglichen Wortlaut und deckt dennoch die AJAX-Anfragen ab, die den Filter neu zeichnen. Ein ersetzter String ändert sich überall, wo das Plugin ihn ausgibt: Filter ist auch der Button des Preisreglers im WooCommerce-Stil und der Standardtext des ausfahrbaren Tabs. Loco Translate leistet dasselbe ohne Code. Den Filter in mehrere Sprachen zu übersetzen ist eine andere Aufgabe, die unter Filter-Labels mit WPML, Polylang oder Loco Translate übersetzen behandelt wird.
Einen Begriff nur innerhalb des Filters umbenennen
Manchmal soll eine Kategorie oder ein Attributwert im Filter anders lauten als auf der Produktseite, zum Beispiel ein langer Kategoriename, der das Layout der Seitenleiste sprengt. Jede Begriffsliste durchläuft woof_sort_terms_before_out, bevor sie ausgegeben wird, gleichermaßen für Checkboxen, Radiobuttons, Dropdown-Listen, Labels, Farben und Bilder:
/*
* HUSKY: show other names for some terms in the filter only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_sort_terms_before_out', function ($terms, $type) {
$new_names = array(
1019 => 'Garden tools', // term ID => name shown in the filter
1697 => 'Kids (4-12)',
);
foreach ($terms as $key => $term) {
if (isset($term['term_id'], $new_names[$term['term_id']])) {
$terms[$key]['name'] = $new_names[$term['term_id']];
}
}
return $terms; // always return the whole array
}, 99, 2);
Die ID eines Begriffs finden Sie, indem Sie in Produkte > Kategorien (Products > Categories) oder auf dem Bildschirm Begriffe konfigurieren (Configure terms) des Attributs mit der Maus über den Begriff fahren: Sie ist die tag_ID im Link. Der Hook läuft auch für untergeordnete Begriffe, sodass Unterkategorien auf dieselbe Weise umbenannt werden können. Die Liste ist bei Priorität 99 bereits sortiert, ein umbenannter Begriff behält also die Position seines ursprünglichen Namens. Geben Sie immer das vollständige Array zurück: Wenn Sie nur die geänderten Begriffe zurückgeben, verschwinden alle anderen aus dem Filter.
Wenn der neue Name nicht erscheint
- Nicht gespeichert. Übernehmen (Apply) im Popup der Zusatzoptionen füllt nur das Formular aus; das Label wird gespeichert, wenn Sie auf der Einstellungsseite auf Änderungen speichern (Save changes) klicken.
- Begriffs-Cache. Ist Cache-Begriffe (Cache terms) unter Erweitert > Optionen (Advanced > Options) aktiviert, behält der Filter die Begriffsnamen, die er zwischengespeichert hat. Ein in WooCommerce umbenannter Begriff zeigt seinen alten Namen, bis Sie auf Begriffs-Cache löschen (clear terms cache) klicken oder der Auto-Clean-Zeitraum abläuft.
- Seitencache. Zwischengespeicherte Seiten behalten das alte HTML. Leeren Sie den Cache Ihres Caching-Plugins, Servers oder CDN und testen Sie in einem privaten Fenster.
- Snippet läuft nicht. Stellen Sie sicher, dass der Code in der
functions.phpdes aktiven (Child-)Themes oder in einem aktiven Snippet steht und dass Filtername, Anzahl der Argumente und Strings genau wie oben angegeben sind.
Wenn ein Text in Ihrem Filter hier nicht behandelt wird, fragen Sie im HUSKY-Support-Forum nach und geben Sie den genauen Text an und wo er erscheint.