Как убрать префикс 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 | Строки и опции плагина | Вкладка «Опции» или перевод |
| Показать больше (Show more) / Показать меньше (Show less), мобильные Открыть фильтр (Open filter) / Закрыть фильтр (Close filter) | Опции вкладки «Дизайн» | Вкладка «Дизайн» |
| Название отдельного термина | Сам термин | Хук woof_sort_terms_before_out |
Как убрать префикс Product из заголовков фильтра WooCommerce
Есть три способа — от самого узкого по действию до самого широкого. Выберите один; все сразу не нужны.
Один блок за раз: пользовательская подпись таксономии
- Откройте WooCommerce > Настройки > Фильтр товаров (WooCommerce > Settings > Products Filter), вкладка Структура (Structure).
- В строке атрибута (например,
pa_color) нажмите на значок шестеренки — дополнительные опции (additional options). - Введите нужный заголовок в поле Пользовательская подпись таксономии (Taxonomy custom label), например
Color. Оставьте поле пустым, чтобы вернуться к названию WooCommerce. - Нажмите Применить (Apply) во всплывающем окне, затем Сохранить изменения (Save changes) внизу страницы настроек.
Пользовательская подпись заменяет название таксономии везде, где его использует фильтр: в заголовке блока, в первом пункте выпадающего списка, в плейсхолдере множественного выбора и в подписи выбранного значения в панели активных фильтров. Именно так «Product categories» можно переименовать в «Категории» или «Купить по типу», а таксономии брендов дать другой заголовок. Для иерархического выпадающего списка то же поле содержит заголовки каждого уровня; этот формат объясняет руководство по фильтру год, марка и модель.
Все атрибуты сразу: хук 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, это описано в FAQ о подписи для отдельных категорий; самый простой код — условие внутри 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) и первый пункт Любой цвет (Any colour), используйте копию шаблона выпадающего списка. Плагин загружает его через хук 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 таким же образом. После обновления плагина сравните свою копию с новым оригиналом и перенесите все изменения.
Как изменить «Очистить все», «Сбросить», «Фильтр» и другие встроенные тексты
Собственные тексты плагина делятся на три группы.
Опции. На вкладке Опции (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 и укажите точный текст и место, где он появляется.