HUSKY - WooCommerce Product Filter Professional

Как убрать префикс 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

Есть три способа — от самого узкого по действию до самого широкого. Выберите один; все сразу не нужны.

Один блок за раз: пользовательская подпись таксономии

  1. Откройте WooCommerce > Настройки > Фильтр товаров (WooCommerce > Settings > Products Filter), вкладка Структура (Structure).
  2. В строке атрибута (например, pa_color) нажмите на значок шестеренки — дополнительные опции (additional options).
  3. Введите нужный заголовок в поле Пользовательская подпись таксономии (Taxonomy custom label), например Color. Оставьте поле пустым, чтобы вернуться к названию WooCommerce.
  4. Нажмите Применить (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, поэтому копия может находиться в вашей дочерней теме и переживает обновления плагина.

  1. Скопируйте wp-content/plugins/woocommerce-products-filter/views/html_types/select.php в wp-content/themes/your-child-theme/husky/select.php.
  2. Сообщите плагину, что нужно использовать копию:
    /*
     * 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;
    });
  3. В копии найдите строку <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 и укажите точный текст и место, где он появляется.