Usuń prefiks Product i zmień nazwy tytułów filtra WooCommerce
Product Color, Product Size, Product Material: gdy każdy blok atrybutu w filtrze Twojego sklepu zaczyna się od tego samego słowa, filtr po prostu wyświetla nazwę, którą WooCommerce nadał atrybutowi. Aby usunąć prefiks Product z tytułów filtra WooCommerce, nadajesz blokowi własny tytuł: pojedynczo w ustawieniach filtra albo dla wszystkich atrybutów naraz kilkoma wierszami kodu. Te same miejsca kontrolują pozostałe teksty filtra: tytuły bloków, pierwszą opcję listy rozwijanej, Wyczyść wszystko (Clear All), Resetuj (Reset), Filtr (Filter), Pokaż więcej (Show more), a nawet nazwy pojedynczych terminów. Wszystkie można zmienić bez edytowania plików wtyczki.
Skąd pochodzi każdy tekst w filtrze
HUSKY nie przechowuje własnej nazwy taksonomii. Pyta WordPress o jej nazwę w liczbie mnogiej i ją wyświetla, chyba że ustawisz własną etykietę. WooCommerce rejestruje każdy atrybut globalny z nazwą w liczbie mnogiej Product %s, więc atrybut Kolor (Color) staje się taksonomią o nazwie "Product Color", a jego nazwa w liczbie pojedynczej pozostaje "Color". Kategorie i tagi działają tak samo: ich nazwy w liczbie mnogiej to "Product categories" i "Product tags". Tabela pokazuje, skąd pochodzi każdy widoczny tekst i gdzie go zmienić.
| Tekst na stronie | Skąd pochodzi | Gdzie go zmienić |
|---|---|---|
| Nagłówek nad całym filtrem ("HUSKY Filter") | Tytuł widżetu | Pole Tytuł (Title) widżetu |
| Tytuł bloku (Product Color, Product categories) | Nazwa taksonomii | Własna etykieta taksonomii (Taxonomy custom label) lub hook woof_filter_title |
| Pierwsza opcja listy rozwijanej | Ta sama nazwa taksonomii | Tytuł bloku lub kopia szablonu listy rozwijanej |
| Tytuł filtra cen | Tekst tytułu (Title text) filtra cen | Dodatkowe opcje Wyszukaj wg Ceny (Search by Price) |
| Na stanie (In stock), Promocja (On sale), Polecane produkty (Featured products) | Teksty rozszerzeń | Hooki woof_ext_custom_title_* |
| Wyczyść wszystko (Clear All) w panelu aktywnych filtrów | Ciąg wtyczki | Hook woof_clear_all_text |
| Przyciski Filtr (Filter) i Resetuj (Reset), etykieta sortujwg (orderby) | Ciągi i opcje wtyczki | Karta Opcje lub tłumaczenie |
| Pokaż więcej (Show more) / Pokaż mniej (Show less), mobilne Otwórz filtr (Open filter) / Zamknij filtr (Close filter) | Opcje karty Wygląd | Karta Wygląd |
| Nazwa pojedynczego terminu | Sam termin | Hook woof_sort_terms_before_out |
Usuń prefiks Product z tytułów filtra WooCommerce
Są trzy sposoby, od najwęższego do najszerszego zasięgu. Wybierz jeden; nie potrzebujesz wszystkich.
Jeden blok naraz: Własna etykieta taksonomii
- Otwórz WooCommerce > Ustawienia > Products Filter (WooCommerce > Settings > Products Filter), kartę Struktura (Structure).
- W wierszu atrybutu (na przykład
pa_color) kliknij ikonę koła zębatego, dodatkowe opcje (additional options). - Wpisz żądany tytuł w Własna etykieta taksonomii (Taxonomy custom label), na przykład
Color. Zostaw pole puste, aby wrócić do nazwy z WooCommerce. - Kliknij Zastosuj (Apply) w oknie, a potem Zapisz zmiany (Save changes) na dole strony ustawień.
Własna etykieta zastępuje nazwę taksonomii wszędzie, gdzie filtr jej używa: w tytule bloku, w pierwszej opcji listy rozwijanej, w tekście zastępczym listy wielokrotnego wyboru i w etykiecie wybranej wartości w panelu aktywnych filtrów. W ten sposób zmienisz też "Product categories" na "Categories" lub "Shop by type" albo nadasz taksonomii marek inny tytuł. Dla hierarchicznej listy rozwijanej to samo pole zawiera tytuły wszystkich poziomów; ten format wyjaśnia poradnik o filtrze rocznik, marka i model.
Wszystkie atrybuty naraz: hook woof_filter_title
Przy dwudziestu atrybutach wpisywanie etykiety dla każdego z nich jest żmudne, a każdy nowy atrybut wymaga tego od nowa. Każdy tytuł bloku filtra przechodzi przez hook woof_filter_title, więc jeden fragment kodu może zastąpić nazwę "Product ..." każdego atrybutu jego nazwą w liczbie pojedynczej:
/*
* 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);
Warunek $title === $taxonomy_info->labels->name zachowuje każdą ustawioną przez Ciebie Własna etykieta taksonomii (Taxonomy custom label): fragment zmienia tylko tytuły, które nadal są nazwą z WooCommerce. Nic nie zmienia poza filtrem. Hook otrzymuje też niektóre teksty przycisków z pustym $taxonomy_info, dlatego fragment najpierw sprawdza is_object().
Wszędzie w witrynie: zmień ciąg WooCommerce
Jeśli chcesz, aby prefiks zniknął we wszystkich miejscach pokazujących nazwy taksonomii atrybutów, łącznie z innymi widżetami i ekranami administracji, zmień sam ciąg WooCommerce. Prefiks pochodzi z _x( 'Product %s', 'Product Attribute', 'woocommerce' ), więc filtr tłumaczeń może zwrócić samą nazwę:
/*
* 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);
Ten sam efekt można uzyskać w Loco Translate, tłumacząc Product %s na %s w domenie tekstowej WooCommerce; zapisz plik w niestandardowej lokalizacji Loco, aby aktualizacja WooCommerce go nie nadpisała. W witrynie w innym języku widać przetłumaczony ciąg (na przykład "Produkt %s"), ale fragment porównuje oryginalny angielski tekst, więc działa dla dowolnego języka witryny.
Jeden skutek uboczny każdej metody zmiany nazwy: każdy blok dostaje też klasę CSS zbudowaną z jego tytułu, taką jak woof_container_productcolor. Po zmianie nazwy staje się ona woof_container_color. Jeśli Twój własny CSS wskazuje starą klasę, przełącz go na klasę opartą na slugu woof_container_pa_color, która nigdy się nie zmienia.
Zmień lub ukryj tytuł filtra i nagłówek widżetu
Tekst "HUSKY Filter" nad całym filtrem nie jest ustawieniem wtyczki: to tytuł widżetu. Otwórz Wygląd > Widżety (Appearance > Widgets) (lub edytor widżetów blokowych), otwórz widżet HUSKY i zmień jego pole Tytuł (Title) albo je opróżnij. Pusty tytuł nie wyświetla niczego. Filtr umieszczony shortcode'em [woof] nie ma takiego nagłówka w ogóle.
Aby ukryć tytuł jednego bloku, ustaw Pokaż etykietę tytułu (Show title label) na Nie (No) w jego dodatkowych opcjach. Jest to częste w przypadku list rozwijanych, gdzie pierwsza opcja już mówi, czym jest lista. Filtr cen ma własne pole: otwórz dodatkowe opcje Wyszukaj wg Ceny (Search by Price) i wypełnij Tekst tytułu (Title text); gdy jest puste, blok cen nie ma tytułu. Dla filtra cen w postaci listy rozwijanej Teks filtra cen listy rozwijanej (Drop-down price filter text) w tym samym oknie ustawia jego pierwszą opcję.
Taksonomia ma jeden tytuł dla całego sklepu. Jeśli jedna kategoria potrzebuje innego tytułu, na przykład "Shoe size" w kategorii Shoes, zajmuje się tym FAQ o etykiecie dla poszczególnych kategorii; najprostszy kod to warunek wewnątrz 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);
Działa to, gdy strona przeładowuje się po każdej zmianie filtra. W trybie AJAX formularz filtra jest odbudowywany przez żądanie w tle, w którym is_product_category() zwraca false, więc po pierwszym wyborze tytuł wraca do domyślnego.
Zmień tekst zastępczy listy rozwijanej
Pierwsza opcja listy rozwijanej taksonomii, ta oznaczająca "nic nie wybrano", wyświetla ten sam tekst co tytuł bloku. Własna etykieta zmienia więc oba. Jeśli mają się różnić, na przykład tytuł Kolor (Color) i pierwsza opcja Dowolny kolor (Any colour), użyj kopii szablonu listy rozwijanej. Wtyczka wczytuje go przez hook woof_html_types_view_select, więc kopia może leżeć w Twoim motywie potomnym i przetrwa aktualizacje wtyczki.
- Skopiuj
wp-content/plugins/woocommerce-products-filter/views/html_types/select.phpdowp-content/themes/your-child-theme/husky/select.php. - Powiedz wtyczce, aby używała kopii:
/* * 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; }); - W kopii znajdź wiersz
<option value="0">i zastąp go własnym tekstem. Dostępne jest tam$tax_slug, więc jeden szablon może obsłużyć każdą listę rozwijaną:<option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>
Bloki wielokrotnego wyboru pokazują tytuł jako tekst zastępczy; ich szablon to views/html_types/mselect.php, wczytywany w ten sam sposób przez woof_html_types_view_mselect. Po aktualizacji wtyczki porównaj swoją kopię z nowym oryginałem i przenieś wszelkie zmiany.
Zmień Clear All, Reset, Filter i inne wbudowane teksty
Własne teksty wtyczki dzielą się na trzy grupy.
Opcje. Na karcie Opcje (Options) pola Tekst przycisku filtra (Filter button text) i Tekst przycisku resetowania (Reset button text) ustawiają dwa przyciski formularza; wpisanie none w Tekst przycisku resetowania (Reset button text) ukrywa ten przycisk. W wersji darmowej oba pola są ignorowane i wyświetlane są słowa domyślne; zmień je za pomocą fragmentu tłumaczenia poniżej. Na karcie Wygląd (Design) znajdziesz Tekst dla otwartego bloku więcej/mniej (Text for block more/less opened) i Tekst dla zamkniętego bloku więcej/mniej (Text for block more/less closed) (domyślnie Pokaż więcej (Show more) i Pokaż mniej (Show less), używane, gdy blok ma ustawione Ilość nie przełączanych określeń (Not toggled terms count)), a także Tekst przycisku filtra mobilnego (Text for mobile filter button) i Tekst zamykający filtr mobilny (Text to close mobile filter).
Hooki. Wyczyść wszystko (Clear All) w panelu aktywnych filtrów ma własny hook woof_clear_all_text, a rozszerzenia z polami wyboru mają hooki woof_ext_custom_title_*: woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder i 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';
});
Tekst Wyczyść wszystko (Clear All) jest zapisywany w ciągu JavaScript w podwójnych cudzysłowach, więc nie używaj w nim podwójnych cudzysłowów.
Tłumaczenie. Wszystko inne, jak etykiety sortujwg (orderby), na stronę (per page) i zakres cen (price range) w panelu aktywnych filtrów oraz wartości sortowania takie jak popularność (popularity), to tłumaczalny ciąg domeny tekstowej woocommerce-products-filter. W sklepie jednojęzycznym najprostszym narzędziem jest filtr gettext z listą dokładnych ciągów:
/*
* 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);
Ciągi muszą pasować dokładnie, łącznie z wielkością liter: domyślny tekst przycisku to Clear All, a nie "Clear all". Warunek is_admin() zachowuje strony ustawień wtyczki w oryginalnym brzmieniu, a jednocześnie obejmuje żądania AJAX, które przerysowują filtr. Zastąpiony ciąg zmienia się wszędzie, gdzie wtyczka go wyświetla: Filter to także przycisk suwaka cen w stylu WooCommerce i domyślny tekst wysuwanej zakładki. Loco Translate robi to samo bez kodu. Tłumaczenie filtra na kilka języków to inne zadanie, opisane w tłumaczeniu etykiet filtra w WPML, Polylang lub Loco Translate.
Zmień nazwę terminu tylko w filtrze
Czasem kategoria lub wartość atrybutu powinna w filtrze brzmieć inaczej niż na stronie produktu, na przykład długa nazwa kategorii psuje układ paska bocznego. Każda lista terminów przechodzi przez woof_sort_terms_before_out przed wyświetleniem, dla pól wyboru, przycisków radio, list rozwijanych, etykiet, kolorów i obrazów jednakowo:
/*
* 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);
Identyfikator terminu znajdziesz, najeżdżając kursorem na termin w Produkty > Kategorie (Products > Categories) lub na ekranie atrybutu Konfiguruj terminy (Configure terms): to tag_ID w linku. Hook działa także dla terminów podrzędnych, więc podkategorie można zmieniać tak samo. Lista jest już posortowana, gdy działa priorytet 99, więc zmieniony termin zachowuje pozycję swojej pierwotnej nazwy. Zawsze zwracaj całą tablicę: zwrócenie tylko zmienionych terminów usuwa z filtra wszystkie pozostałe.
Jeśli nowa nazwa się nie pojawia
- Nie zapisano. Zastosuj (Apply) w oknie dodatkowych opcji tylko wypełnia formularz; etykieta jest zapisywana po kliknięciu Zapisz zmiany (Save changes) na stronie ustawień.
- Pamięć podręczna terminów. Jeśli Określenia cache (Cache terms) jest włączone w Zaawansowane > Opcje (Advanced > Options), filtr zachowuje zapisane w pamięci nazwy terminów. Termin zmieniony w WooCommerce pokazuje starą nazwę, dopóki nie klikniesz wyczyść pamięć podręczną okresleń (clear terms cache) lub nie minie okres automatycznego czyszczenia.
- Pamięć podręczna stron. Strony z pamięci podręcznej zachowują stary kod HTML. Wyczyść pamięć podręczną wtyczki cache, serwera lub CDN i testuj w oknie prywatnym.
- Fragment kodu nie działa. Upewnij się, że kod jest w pliku
functions.phpaktywnego motywu (potomnego) lub w aktywnym fragmencie oraz że nazwa filtra, liczba argumentów i ciągi są dokładnie takie jak powyżej.
Jeśli tekst w Twoim filtrze nie jest tu opisany, zapytaj na forum wsparcia HUSKY, podając dokładny tekst i miejsce, w którym się pojawia.