Як прибрати префікс Product і перейменувати заголовки фільтра WooCommerce
Product Color, Product Size, Product Material: коли кожен блок атрибута у фільтрі магазину починається з того самого слова, фільтр лише виводить назву, яку WooCommerce дав атрибуту. Щоб прибрати префікс Product із заголовків фільтра WooCommerce, ви задаєте блоку власний заголовок — або по одному в налаштуваннях фільтра, або для всіх атрибутів одразу кількома рядками коду. Ті самі місця керують й іншими текстами фільтра: заголовками блоків, першим пунктом випадаючого списку, Очистити все (Clear All), Скинути (Reset), Фільтр (Filter), Показати більше (Show more) і навіть назвами окремих термінів. Усе це можна змінити, не редагуючи файли плагіна.
Звідки береться кожен текст у фільтрі
HUSKY не зберігає власної назви таксономії. Він запитує у WordPress назву таксономії у множині та виводить її, якщо ви не задали власний напис. WooCommerce реєструє кожен глобальний атрибут із назвою в множині Product %s, тож атрибут Колір (Color) стає таксономією з назвою «Product Color», тоді як назва в однині залишається «Color». Категорії та мітки працюють так само: їхні назви в множині — «Product categories» і «Product tags». Таблиця показує, звідки береться кожен видимий текст і де його змінити.
| Текст на сторінці | Звідки він береться | Де його змінити |
|---|---|---|
| Заголовок над усім фільтром («HUSKY Filter») | Заголовок віджета | Поле Заголовок (Title) віджета |
| Заголовок блоку (Product Color, Product categories) | Назва таксономії | Власний напис таксономії (Taxonomy custom label) або хук woof_filter_title |
| Перший пункт випадаючого списку | Та сама назва таксономії | Заголовок блоку або копія шаблону випадаючого списку |
| Заголовок фільтра за ціною | Текст заголовка (Title text) фільтра за ціною | Додаткові параметри Пошук за ціною (Search by Price) |
| В наявності (In stock), Зі знижкою (On sale), Рекомендовані товари (Featured products) | Тексти розширень | Хуки woof_ext_custom_title_* |
| Очистити все (Clear All) на панелі активних фільтрів | Рядок плагіна | Хук woof_clear_all_text |
| Кнопки Фільтр (Filter) і Скинути (Reset), напис orderby | Рядки та параметри плагіна | Вкладка Options або переклад |
| Показати більше (Show more) / Показати менше (Show less), мобільні Відкрити фільтр (Open filter) / Закрити фільтр (Close filter) | Параметри вкладки Design | Вкладка Design |
| Назва окремого терміна | Сам термін | Хук woof_sort_terms_before_out |
Як прибрати префікс Product із заголовків фільтра WooCommerce
Є три способи — від найвужчого до найширшого за впливом. Виберіть один; усі разом вони не потрібні.
По одному блоку: Власний напис таксономії
- Відкрийте WooCommerce > Налаштування > Products Filter (WooCommerce > Settings > Products Filter), вкладка Структура (Structure).
- У рядку атрибута (наприклад,
pa_color) натисніть значок шестерні, додаткові параметри (additional options). - Введіть потрібний заголовок у Власний напис таксономії (Taxonomy custom label), наприклад
Color. Залиште поле порожнім, щоб повернутися до назви WooCommerce. - Натисніть Застосувати (Apply) у вікні, потім Зберегти зміни (Save changes) унизу сторінки налаштувань.
Власний напис замінює назву таксономії всюди, де її використовує фільтр: заголовок блоку, перший пункт випадаючого списку, плейсхолдер списку з множинним вибором і підпис вибраного значення на панелі активних фільтрів. Так само «Product categories» перейменовують на «Categories» або «Shop by type», а таксономії брендів дають інший заголовок. Для ієрархічного випадаючого списку це саме поле містить заголовки всіх рівнів; цей формат пояснює посібник про фільтр за роком, маркою та моделлю.
Усі атрибути одразу: хук woof_filter_title
Коли атрибутів двадцять, вводити напис для кожного втомливо, а кожен новий атрибут потребує цього знову. Кожен заголовок блоку фільтра проходить через хук woof_filter_title, тож один фрагмент коду може замінити назву «Product ...» кожного атрибута його назвою в однині:
/*
* 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);
Перевірка $title === $taxonomy_info->labels->name зберігає будь-який Власний напис таксономії (Taxonomy custom label), який ви задали: фрагмент змінює лише заголовки, що все ще є назвою WooCommerce. Він нічого не змінює поза фільтром. Хук також отримує деякі тексти кнопок із порожнім $taxonomy_info, тому фрагмент спершу перевіряє is_object().
Усюди на сайті: змініть рядок WooCommerce
Якщо ви хочете прибрати префікс у кожному місці, де показуються назви таксономій атрибутів, зокрема в інших віджетах і екранах адмінки, змініть сам рядок WooCommerce. Префікс походить із _x( 'Product %s', 'Product Attribute', 'woocommerce' ), тож фільтр перекладу може повернути саму назву:
/*
* 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);
Того самого результату можна досягти й через Loco Translate, переклавши Product %s як %s у домені тексту WooCommerce; збережіть файл у власному розташуванні Loco, щоб оновлення WooCommerce його не перезаписало. На сайті іншою мовою ви бачите перекладений рядок (наприклад, «Produkt %s»), але фрагмент порівнює оригінальний англійський текст, тому працює для будь-якої мови сайту.
Один побічний ефект будь-якого способу перейменування: кожен блок також отримує CSS-клас, утворений із його заголовка, наприклад woof_container_productcolor. Після перейменування він стає woof_container_color. Якщо ваш власний CSS звертається до старого класу, перейдіть на клас на основі слага woof_container_pa_color, який ніколи не змінюється.
Змінити або приховати заголовок фільтра й заголовок віджета
Текст «HUSKY Filter» над усім фільтром не є налаштуванням плагіна: це заголовок віджета. Відкрийте Вигляд > Віджети (Appearance > Widgets) (або блоковий редактор віджетів), відкрийте віджет HUSKY і змініть його поле Заголовок (Title) або очистіть його. Порожній заголовок нічого не виводить. Фільтр, розміщений шорткодом [woof], такого заголовка не має взагалі.
Щоб приховати заголовок одного блоку, встановіть Показувати заголовок (Show title label) у значення Ні (No) у його додаткових параметрах. Це поширено для випадаючих списків, де перший пункт уже говорить, що це за список. Фільтр за ціною має власне поле: відкрийте додаткові параметри Пошук за ціною (Search by Price) і заповніть Текст заголовка (Title text); коли воно порожнє, блок ціни не має заголовка. Для випадаючого фільтра за ціною Текст випадаючого фільтра за ціною (Drop-down price filter text) у тому самому вікні задає його перший пункт.
Таксономія має один заголовок для всього магазину. Якщо одній категорії потрібен інший заголовок, наприклад «Shoe size» для категорії Shoes, це розглядають поширені запитання про напис для окремої категорії; найпростіший код — умова всередині 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);
Це працює, коли сторінка перезавантажується після кожної зміни фільтра. У режимі AJAX форма фільтра перебудовується фоновим запитом, у якому is_product_category() має значення false, тому після першого вибору заголовок повертається до типового.
Змінити текст плейсхолдера випадаючого списку
Перший пункт випадаючого списку таксономії, який означає «нічого не вибрано», виводить той самий текст, що й заголовок блоку. Тому власний напис змінює обидва. Якщо ви хочете, щоб вони відрізнялися, наприклад заголовок Колір (Color) і перший пункт Будь-який колір, використайте копію шаблону випадаючого списку. Плагін завантажує його через хук woof_html_types_view_select, тож копія може лежати у вашій дочірній темі та пережити оновлення плагіна.
- Скопіюйте
wp-content/plugins/woocommerce-products-filter/views/html_types/select.phpдоwp-content/themes/your-child-theme/husky/select.php. - Скажіть плагіну використовувати копію:
/* * 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; }); - У копії знайдіть рядок
<option value="0">і замініть його власним текстом. Там доступна змінна$tax_slug, тож один шаблон може обслуговувати кожен випадаючий список:<option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>
Блоки з множинним вибором показують заголовок як плейсхолдер; їхній шаблон — views/html_types/mselect.php, який так само завантажується через woof_html_types_view_mselect. Після оновлення плагіна порівняйте свою копію з новим оригіналом і перенесіть будь-які зміни.
Змінити Clear All, Reset, Filter та інші вбудовані тексти
Власні тексти плагіна поділяються на три групи.
Параметри. На вкладці Опції (Options) Текст кнопки фільтра (Filter button text) і Текст кнопки скидання (Reset button text) задають дві кнопки форми; запис none у Текст кнопки скидання (Reset button text) приховує цю кнопку. У безкоштовній версії обидва поля ігноруються та показуються типові слова; змініть їх фрагментом перекладу нижче. На вкладці Дизайн (Design) ви знайдете Текст для блоку більше/менше відкритий (Text for block more/less opened) і Текст для блоку більше/менше закритий (Text for block more/less closed) (типово Показати більше (Show more) і Показати менше (Show less), використовуються, коли для блоку задано Кількість термінів без згортання (Not toggled terms count)), а також Текст для мобільної кнопки фільтра (Text for mobile filter button) і Текст для закриття мобільного фільтра (Text to close mobile filter).
Хуки. Очистити все (Clear All) на панелі активних фільтрів має власний хук woof_clear_all_text, а розширення з прапорцями мають хуки woof_ext_custom_title_*: woof_ext_custom_title_by_instock, _by_onsales, _by_featured, _by_backorder і 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';
});
Текст Очистити все (Clear All) записується в рядок JavaScript у подвійних лапках, тому не використовуйте в ньому подвійних лапок.
Переклад. Усе інше, як-от написи orderby, per page і діапазон цін (price range) на панелі активних фільтрів та значення сортування на кшталт popularity, — це рядки домену тексту woocommerce-products-filter, які можна перекладати. В одномовному магазині найпростіший інструмент — фільтр gettext зі списком точних рядків:
/*
* 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);
Рядки мають збігатися точно, враховуючи регістр: типовий текст кнопки — Clear All, а не «Clear all». Умова is_admin() залишає сторінки налаштувань плагіна з їхнім початковим формулюванням і водночас охоплює AJAX-запити, що перемальовують фільтр. Замінений рядок змінюється всюди, де його виводить плагін: Filter — це також кнопка повзунка ціни в стилі WooCommerce і типовий текст висувної вкладки. Loco Translate робить те саме без коду. Переклад фільтра кількома мовами — це інше завдання, про яке йдеться в статті переклад написів фільтра за допомогою WPML, Polylang або Loco Translate.
Перейменувати термін лише всередині фільтра
Іноді категорія чи значення атрибута мають звучати у фільтрі інакше, ніж на сторінці товару, наприклад довга назва категорії, що ламає розмітку бічної панелі. Кожен список термінів проходить через woof_sort_terms_before_out перед виведенням — для прапорців, перемикачів, випадаючих списків, написів, кольорів і зображень однаково:
/*
* 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);
Знайдіть ID терміна, навівши курсор на термін у Товари > Категорії (Products > Categories) або на екрані Налаштувати терміни (Configure terms) атрибута: це tag_ID у посиланні. Хук запускається й для дочірніх термінів, тож підкатегорії можна перейменувати так само. Коли спрацьовує пріоритет 99, список уже відсортований, тому перейменований термін зберігає позицію своєї початкової назви. Завжди повертайте весь масив: якщо повернути лише змінені терміни, усі інші зникнуть із фільтра.
Якщо нова назва не з’являється
- Не збережено. Застосувати (Apply) у вікні додаткових параметрів лише заповнює форму; напис зберігається, коли ви натискаєте Зберегти зміни (Save changes) на сторінці налаштувань.
- Кеш термінів. Якщо Кешувати терміни (Cache terms) увімкнено в розділі Додатково > Опції (Advanced > Options), фільтр зберігає закешовані назви термінів. Термін, перейменований у WooCommerce, показує стару назву, доки ви не натиснете очистити кеш термінів (clear terms cache) або не мине період автоочищення.
- Кеш сторінок. Кешовані сторінки зберігають старий HTML. Очистіть кеш вашого плагіна кешування, сервера або CDN і перевірте у приватному вікні.
- Фрагмент не виконується. Переконайтеся, що код міститься в
functions.phpактивної (дочірньої) теми або в активному фрагменті, а назва фільтра, кількість аргументів і рядки точно такі, як вище.
Якщо потрібного вам тексту фільтра тут немає, запитайте на форумі підтримки HUSKY і вкажіть точний текст та місце, де він з’являється.