CODEX
Shortcodes, Hooks & Extensions
Полный справочник по HUSKY – профессиональному фильтру товаров WooCommerce
- SC [[woof]] Главный шорткод для WooCommerce Products Filter. Генерирует форму поиска. Концепция: 1 страница - 1 фильтр, нельзя размещать несколько фильтров на одной… →
- SC [[woof_author_filter]] Фильтр по ID авторов, отображается как выпадающий список на фронтенде сайта. Для использования этого шорткода должно быть активировано расширение Searching by Author placeholder … →
- SC [[woof_btn]] Позволяет создать специальную кнопку для показа/скрытия формы поиска. Отображает кнопку для скрытия фильтра. Работает на основе атрибута шорткода 'autohide'. Пример использования:… →
- SC [[woof_found_count]] Показывает количество найденных товаров. Вставьте его в обычный текстовый виджет с любым нужным текстом или используйте в хуке woof_print_content_before_search_form. С версии: v.2.1.6 →
- SC [[woof_front_builder]] С версии v.2.3.4/1.3.4 Этот шорткод позволяет создавать форму фильтра прямо на фронтенде сайта с помощью специального конструктора. Вот демо-страница, где можно… →
- SC [[woof_mobile]] Этот шорткод добавляет контейнер, в который вставляется мобильная кнопка. Мобильная кнопка появляется на мобильных устройствах для вызова скрытой формы фильтра WOOF и отображает… →
- SC [[woof_price_filter]] Фильтр по цене в виде выпадающего списка ИЛИ слайдера. У этого шорткода 3 опциональных атрибута type - slider, select,text additional_taxes - Пример -> product_cat:9 - это особое… →
- SC [[woof_products]] Второй главный шорткод плагина. Позволяет выводить товары на страницах сайта. Все атрибуты шорткода опциональны. per_page - товаров на странице… →
- SC [[woof_products_messenger]] Без атрибутов. Описание здесь. →
- SC [[woof_quick_search]] Должно быть активировано расширение: Quick Search preload - (1/0)если 1, файл данных загружается сразу после загрузки страницы, если 0 - только после того, как… →
- SC [[woof_quick_search_results]] Должно быть активировано расширение: Quick Search per_page - товаров на странице template_result - должен быть указан, есть 5 предустановленных шаблонов: list_1 | list_2 |… →
- SC [[woof_save_query]] Назначение: Позволяет авторизованным пользователям сохранять текущие выбранные параметры фильтра для быстрого доступа в будущем. Описание Этот шорткод отображает виджет, в котором пользователи могут сохранять… →
- SC [[woof_search_options]] Генерирует навигацию поиска, если поиск выполняется (красные кнопки). Без опций. →
- SC [[woof_sku_filter]] Генерирует текстовое поле на сайте. Имеет только один опциональный атрибут. Условия поиска задаются на странице настроек плагина, доступной после активации… →
- SC [[woof_step]] Этот шорткод позволяет создать пошаговый мастер фильтрации для ваших покупателей. Атрибуты: by_step - главный атрибут этого шорткода, в котором указываются ключи… →
- SC [[woof_text_filter]] Генерирует текстовое поле в магазине для поиска товаров WooCommerce по тексту. Кодовое название - HUSKY. Может искать по: заголовку содержимому краткому описанию метаполям таксономиям… →
Шаблоны расширений можно переопределить. Папка должна быть размещена в папке текущей темы WordPress и иметь такую же структуру файлов, как и оригинальное расширение. Пример: wp-content/themes/my_child_theme/woof/ext/image/views/woof.php
1.
ACF
View info →
2.
Advanced search by Text
View info →
3.
By rating
View info →
4.
Color
View info →
5.
Conditionals
View info →
6.
Essential Grid
View info →
7.
Exclude backordered products
View info →
8.
Featured products
View info →
9.
Filter form Front Builder
View info →
10.
Hierarchy drop-down
View info →
11.
Image
View info →
12.
Import/Export
View info →
13.
In stock checkbox
View info →
14.
Labels
View info →
15.
Meta fields
View info →
16.
On sale checkbox
View info →
17.
Products Messenger
View info →
18.
Quick Search
View info →
19.
Radio or checkbox in drop-down
View info →
20.
Saver of Search Query
View info →
21.
Searching by Author
View info →
22.
Searching by SKU
View info →
23.
Sections
View info →
24.
SEO URL request
View info →
25.
Slideout shortcode
View info →
26.
Slider
View info →
27.
Smart Designer
View info →
28.
Statistic
View info →
29.
Step by step filter
View info →
30.
Stock Quantity Slider
View info →
31.
Template 1
View info →
32.
Turbo Mode
View info →
33.
WooCommerce Product Table
View info →
- do_action woof_after_draw_filter Срабатывает после вывода каждого элемента фильтра в форме поиска WOOF. add_action('woof_after_draw_filter', function($key, $shortcode_atts) { //do smth here }, 99, 2); С версии v.2.2.5/1.2.5 →
- do_action woof_before_draw_filter Срабатывает перед выводом каждого элемента фильтра в форме поиска WOOF. add_action('woof_before_draw_filter', function($key, $shortcode_atts) { //do here }, 99, 2); С версии v.2.2.5/1.2.5 →
- do_action woof_exclude_existing_variations С версии v.2.2.6 Улучшает поиск по наличию. Нужен потому, что не всем нужны вариации в результатах поиска, а также позволяет избежать лишних запросов. По умолчанию… →
- do_action woof_image_allow_term_desc С версии v.2.2.6 По умолчанию для картинок добавляется описание термина, теперь это можно отключить. По умолчанию true. Пример: add_filter('woof_image_allow_term_desc',… →
- do_action woof_meta_options_separator С версии v.2.2.6 Нужен для замены разделителя-запятой в опциях, полезно, если метаполе содержит запятую как часть значения, пример: add_filter('woof_meta_options_separator', function ($sep)… →
- do_action woof_mobile_btn_place_container С версии v.2.2.6 Позволяет переопределить селектор, в котором должна появляться мобильная кнопка фильтра. По умолчанию это css-класс '.woocommerce-products-header'. Пример кода: add_filter('woof_mobile_btn_place_container', function ($selector)… →
- do_action woof_override_seo_request_uri С версии v.2.2.6/1.2.6 Используется для расширения 'SEO URL request' — передаёт текущий URL. Нужен для адаптации к разным серверам при необходимости →
- do_action woof_print_design_additional_options Используется в расширениях для добавления дополнительных опций на вкладке Design, если необходимо. Пример: add_action('woof_print_design_additional_options', array($this, 'my_design_additional_options'), 10, 1); public function my_design_additional_options() { global $WOOF;… →
- do_action woof_print_html_type_options_{type} Используется всеми расширениями для отрисовки блока настроек на вкладке Settings страницы настроек плагина [inpost_fancy thumb_width="200" thumb_height="200" post_id="279" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0 1px… →
- do_action woof_print_html_type_{type} Используется расширениями для отрисовки себя на фронтенде Достаточно просто в init расширения написать следующий код: add_action('woof_print_html_type_' . $this->html_type, array($this, 'print_html_type'),… →
- do_action woof_print_tax_additional_options_{type} Используется в расширении для вывода дополнительных опций под кнопкой 'additional options', как в color: [inpost_fancy thumb_width="200" thumb_height="200" post_id="281" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0 1px 4px rgba(0,… →
- do_action woof_seo_request_literals С версии v.2.2.6/1.2.6 Используется для расширения 'SEO URL request' — позволяет добавлять возможные литеральные переменные, которые можно вставлять в поля SEO-правил. Пример… →
- do_action woof_seo_rules_langs С версии v.2.2.6/1.2.6 Используется для расширения 'SEO URL request' и позволяет добавлять дополнительные языки для плагинов типа Polylang Пример: add_filter('woof_seo_rules_langs',function($langs){ $langs = array_merge($langs, array('en_US', 'es_ES'));… →
- do_action woof_wp_load_js Этот хук позволяет добавлять собственные JavaScript-переменные на фронтенд сайта при необходимости add_action('woof_wp_load_js', function ($str) { $str .= ';var my_var1="Hello";'; $str .= 'var… →
- apply_filters woof_add_html_types Используется в расширениях типов таксономий для добавления своих ключей в систему, чтобы сделать расширение видимым Пример: add_filter('woof_add_html_types', array($this, 'woof_add_html_types')); public function woof_add_html_types($types) {… →
- apply_filters woof_add_items_keys Используется в расширениях 'by_' для добавления своих ключей в систему, чтобы сделать расширение видимым Пример: add_filter('woof_add_items_keys', array($this, 'woof_add_items_keys')); public function woof_add_items_keys($keys) { $keys[]… →
- apply_filters woof_before_term_name Используется в html-типах: radio, checkbox, select, mselect для вывода символов или иконок перед его подписью [inpost_fancy thumb_width="200" thumb_height="200" post_id="275" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200"… →
- apply_filters woof_block_toggle_state Позволяет управлять состоянием сворачивания блоков таксономий, например делать их закрытыми на мобильных устройствах: add_filter('woof_block_toggle_state', function($block_is_closed) { if (wp_is_mobile()) { $block_is_closed = true; }… →
- apply_filters woof_clear_all_text Позволяет изменить текст кнопки 'Clear all' на панели навигации поиска add_filter('woof_clear_all_text', function($default_text) { return 'Clear the filter'; }, 99, 1); С версии v.2.2.5/1.2.5… →
- apply_filters woof_counter_method Для экспериментов разработчиков с перегрузкой памяти в Dynamic recount. Этот хук используется в файле: wp-content\plugins\woocommerce-products-filter\classes\counter.php В __constructor класса WP_QueryWoofCounter Когда этот хук возвращает TRUE, в… →
- apply_filters woof_custom_filter_items_order Хук woof_custom_filter_items_order позволяет изменить порядок элементов фильтра, передаёт массив ключей фильтров (ключ секции фильтра можно найти, нажав на… →
- apply_filters woof_delete_img_url Позволяет изменить url изображения для значка удаления. add_filter('woof_delete_img_url', function($current_img) { return 'https://my-site.com/wp-content/my-woof-del.png'; }, 10, 1); С версии v.2.2.5.6 →
- apply_filters woof_disable_filter Назначение: Отключить плагин WOOF на определённых страницах или при определённых условиях. Этот хук позволяет полностью отключить функциональность плагина WOOF на определённых страницах, типах записей или… →
- apply_filters woof_ext_custom_title_by_instock Позволяет задать собственный заголовок для чекбокса 'In stock' в форме фильтра. Также можно перевести его с помощью плагина Loco Translate →
- apply_filters woof_ext_custom_title_XXX Изменяет подпись чекбокса для 3 следующих расширений: In stock checkbox, Featured products, On sales checkbox. Вместо 'XXX' используйте: by_instock, by_featured, by_onsales С версии v.1.1.8/2.1.8 →
- apply_filters woof_filter_shortcode_args Хук для шорткода [woof], позволяющий изменять аргументы шорткода на лету в зависимости от бизнес-условий add_filter('woof_filter_shortcode_args', function($args) { //do smth with $args here return $args;… →
- apply_filters woof_filter_title Хук woof_filter_title (с версии v.3.3.6) — через этот фильтр проходят все заголовки как таксономических, так и метафильтров, поэтому можно переводить заголовки по-своему,… →
- apply_filters woof_get_filtered_price_query С версии ver.2.2.4/1.2.4 Этот хук добавлен для совместимости с другими плагинами. файл: \classes\helper.php public static function get_filtered_price →
- apply_filters woof_get_meta_query Этот хук позволяет манипулировать meta query в поисковом запросе WOOF: add_filter('woof_get_meta_query', function($meta_query) { //your code here return $meta_query; }); С версии v.2.2.1/1.2.1 →
- apply_filters woof_get_more_less_button_XXXX Используйте этот хук для управления видом кнопки для функции "Not toggled terms count" на фронтенде сайта. XXXX — можно заменить на… →
- apply_filters woof_get_request_data Используется в функции-шлюзе данных плагина: index.php -> public function get_request_data() — это первая функция в плагине, которая получает данные поискового запроса Может… →
- apply_filters woof_get_tax_query Полезен для манипуляций со связями таксономий, например для изменения связи с OR на AND. Не работает совместно с динамическим пересчётом. index.php private function get_tax_query add_filter('woof_get_tax_query', 'my_woof_get_tax_query');… →
- apply_filters woof_get_terms_args С версии ver.2.2.4/1.2.4 Этот хук добавлен для совместимости с другими плагинами. файл: \classes\helper.php public static function get_terms →
- apply_filters woof_get_terms_order Используется для сортировки терминов в форме поиска. classes/helper.php public static function get_terms Используется в паре с woof_get_terms_orderby add_filter('woof_get_terms_order', function($taxonomy) { if ($taxonomy == 'pa_size')… →
- apply_filters woof_get_terms_orderby Используется для сортировки терминов в форме поиска. classes/helper.php public static function get_terms Используется в паре с woof_get_terms_order add_filter('woof_get_terms_orderby', function($taxonomy) { if ($taxonomy == 'pa_size') {… →
- apply_filters woof_html_types_view_checkbox С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\checkbox.php →
- apply_filters woof_html_types_view_mselect С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\mselect.php →
- apply_filters woof_html_types_view_radio С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\radio.php →
- apply_filters woof_html_types_view_select С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\select.php →
- apply_filters woof_husky_query_post__in С версии v.2.2.9/v.1.2.9 Есть два режима фильтра Husky: добавление результата поиска через post__in (включён по умолчанию). Преимущество этого режима — надёжность, так как… →
- apply_filters woof_husky_query_post__in Позволяет управлять текстовой фильтрацией с использованием id записей, запрошено в тикете https://pluginus.net/support/topic/filter-on-title-description-separate-sku-filter/ →
- apply_filters woof_image_add_term_desc Для изображений фильтра (премиум-расширение) — позволяет скрыть/показать описание термина в подсказке. По умолчанию: true. add_filter('woof_image_add_term_desc', function($tax_slug) { return false; }, 10, 1); [inpost_fancy thumb_width="200" thumb_height="200"… →
- apply_filters woof_init_archive_by_default Позволяет отключить 'Enable archives' для атрибутов товара программно на лету при необходимости add_filter('woof_init_archive_by_default', function($is) { return false; }, 99, 1);… →
- apply_filters woof_main_query_tax_relations Этот хук позволяет задать логику 'AND' для любых таксономий в поисковом запросе WOOF. Используйте его в файле functions.php вашей текущей темы wp: add_filter('woof_main_query_tax_relations', 'my_woof_main_query_tax_relations');… →
- apply_filters woof_max_price_filter Этот хук позволяет задать максимальную цену для фильтра цены HUSKY по своей логике Используйте следующий код в файле functions.php текущей темы… →
- apply_filters woof_min_price_filter Этот хук позволяет задать минимальную цену для фильтра цены HUSKY по своей логике Используйте следующий код в файле functions.php текущей темы… →
- apply_filters woof_not_sort_checked_terms Этот хук размещён в index.php плагина в public function woof_sort_terms_is_checked и позволяет исключать html-типы из влияния опции "Lets checked terms… →
- apply_filters woof_order_catalog С версии v.2.2.4/1.2.4 Позволяет добавить пользовательскую сортировку для каталога →
- apply_filters woof_price_slider_html Если по какой-то причине вы хотите переделать стандартный слайдер цены woo в форме поиска WOOF. classes/helper.php public static function price_filter apply_filters('woof_price_slider_html', $price_slider_html, $price_slider_data); →
- apply_filters woof_print_content_before_redraw_zone С версии v.2.2.4/1.2.4 Позволяет разместить над товарами произвольное бизнес-html-сообщение, которое не перерисовывается AJAX →
- apply_filters woof_print_content_before_search_form Этот хук позволяет выводить любой контент перед элементами формы поиска WOOF. Пример: add_filter('woof_print_content_before_search_form', function($content) { global $WOOF; if ($WOOF AND woof()->is_isset_in_request_data(woof()->get_swoof_search_slug())) { return… →
- apply_filters woof_print_label_attributes Позволяет добавлять в теги label чекбоксов и радиокнопок пользовательские атрибуты, запрошено в тикете https://pluginus.net/support/topic/aria-describedby/#postid-82977 Пример: add_action('woof_print_label_attributes', function ($term) { echo"aria-descrybedby aria-name='{$term['name']}'"; }); →
- apply_filters woof_products_query Используется только 1 раз в шорткоде [woof_products]. Нужен для любых пользовательских манипуляций. [inpost_fancy thumb_width="200" thumb_height="200" post_id="267" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0 1px 4px rgba(0, 0, 0,… →
- apply_filters woof_products_top_panel_content С версии ver.2.2.4/1.2.4 Для отображения любого бизнес-контента над результатами фильтрации →
- apply_filters woof_qs_get_template_structure Для расширения: Quick Search Позволяет изменить заголовок столбца таблицы. Пример: add_filter('woof_qs_get_template_structure', 'change_title'); function change_title($data) { if (isset($data['price'])) { $data['price']['title'] = "Price of… →
- apply_filters woof_qs_shortcode_data Для расширения: Quick Search Нужен, чтобы изменить параметры шаблона перед загрузкой страницы — например, в зависимости от устройства. [inpost_fancy thumb_width="200" thumb_height="200"… →
- apply_filters woof_qs_sort_select_data Для расширения: Quick Search Позволяет изменить заголовки сортировки таблицы (когда сортировка в форме представлена выпадающим списком) add_filter('woof_qs_sort_select_data', 'change_title'); function change_title($data) { if… →
- apply_filters woof_quick_search_products_limit По умолчанию количество товаров ограничено 10 000. Но это значение можно увеличить: add_filter('woof_quick_search_products_limit', function($count){ return 30000; }); Но помните — больше товаров… →
- apply_filters woof_redraw_elements_after_ajax Позволяет добавлять любые сообщения во время фильтрации пользователем в режиме AJAX. Пример: add_filter('woof_redraw_elements_after_ajax', function($fields, $query) { ob_start(); if (isset($query->query['tax_query']) AND $query->query['tax_query']) { $html =… →
- apply_filters woof_seo_do_index Хук woof_seo_do_index предназначен для расширения SEO URL. Это для более гибкого управления индексацией. Например, пользователь не хочет индексировать только… →
- apply_filters woof_seo_meta_description Назначение: Изменить тег meta description для страниц с отфильтрованными товарами. Этот хук позволяет настроить содержимое <meta name="description"> для страниц с активными WOOF… →
- apply_filters woof_set_shortcode_taxonomyattr_behaviour Этот хук работает в index.php плагина в public function woof_shortcode и позволяет управлять 'additional_taxes'. [inpost_fancy thumb_width="200" thumb_height="200" post_id="1064" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0… →
- apply_filters woof_slider_meta_query_type Хук woof_slider_meta_query_type предназначен для типов значений слайдера метаполя, например для десятичных значений: add_filter('woof_slider_meta_query_type',function($type,$key){ return "DECIMAL(5,3)"; },2,10); [inpost_fancy thumb_width="200" thumb_height="200" post_id="1620" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0 1px… →
- apply_filters woof_sort_terms_before_out Используется в html-типах checkbox или radio для любых манипуляций с массивом терминов при необходимости $terms = apply_filters('woof_sort_terms_before_out', $terms, 'checkbox'); wp-content\plugins\woocommerce-products-filter\views\html_types\checkbox.php →
- apply_filters woof_sort_terms_checked →
- apply_filters woof_start_filtering_btn_txt Хук для кнопки "Show products filter form", которая появляется в шорткоде [woof start_filtering_btn=1] add_filter('woof_start_filtering_btn_txt', function($txt){ return "Load form!!"; }); С версии: v.2.1.6 →
- apply_filters woof_step_filter_img_size С версии v.2.2.4/1.2.4 Для изменения размера изображений в пошаговом фильтре woof step. add_filter('woof_step_filter_img_size', function($size) { $size = 'large'; //thumbnail, medium, large, full, array(200, 200) //woocommerce_thumbnail ,woocommerce_single, woocommerce_gallery_thumbnail return… →
- apply_filters woof_taxonomy_image Позволяет переопределять изображения термина фильтра-изображения на лету в зависимости от текущей ситуации add_filter('woof_taxonomy_image', function($image, $term) { //change images on the… →
- apply_filters woof_template_part Позволяет изменять шаблон на лету в шорткоде [woof_products] [inpost_fancy thumb_width="200" thumb_height="200" post_id="1235" thumb_margin_left="5" thumb_margin_bottom="5" thumb_border_radius="200" thumb_shadow="0 1px 4px rgba(0, 0, 0, 0.2)"… →
- apply_filters woof_terms_where_hidden_childs Используется для любого термина с дочерними терминами, когда нужно полностью скрыть эти дочерние термины в: checkboxes, radio,select,mselect,labels. add_filter('woof_terms_where_hidden_childs', function($term_id) { $hide_array=array(11,22,33,44,55,66,77); if (in_array($term_id,… →
- apply_filters woof_term_count_format Позволяет изменить формат счётчика — по умолчанию передаётся '(%d)' Пример: add_filter('woof_term_count_format', function ($format, $tax_slug) { $format = '|%d|'; return $format;… →
- apply_filters woof_text_autocomplete_items Сколько записей должна возвращать функция автозаполнения для текстового поля Text add_filter('woof_text_autocomplete_items', function($count){ return 5; }); →
- apply_filters woof_text_search_like_option Этот хук регулирует поведение текстового поиска и по умолчанию возвращает FALSE. Если вернуть TRUE, текстовый поиск будет работать без учёта специальных… →
- apply_filters woof_text_search_query Позволяет переопределить SQL-запрос текстового поиска на лету add_filter('woof_text_search_query', function($where, $woof_text) { global $wpdb; $where .= "AND $wpdb->posts.ID IN(15,39,121)"; return $where; }, 99,… →
- apply_filters woof_title_tag Используйте хук woof_title_tag, если хотите изменить тег заголовка H4 для каждого блока таксономии на любой другой HTML-тег. Пример: add_filter('woof_title_tag', function($tag){ return 'h5'; });… →
- apply_filters woof_turbo_mode_schedules Хук woof_turbo_mode_schedules (с версии v.3.3.6) позволяет добавлять собственные периоды обновления параметров товаров в turbo mode, пример кода: add_filter('woof_turbo_mode_schedules', function($schedules) { $schedules['your_custom_period_key'] = array( 'name'… →
- apply_filters woof_use_wp_cache Хук woof_use_wp_cache включает объектный кэш wp-cache, который более оптимизирован. Показал хорошие результаты в тестах. ВНИМАНИЕ: обязательно должен быть установлен… →
- apply_filters woof_widget_title_tag Используйте хук woof_widget_title_tag, если хотите изменить тег заголовка H3 для заголовка виджета WOOF на любой другой HTML-тег. Пример: add_filter('woof_widget_title_tag', function($tag){ return 'h4'; }); →
- fn() is_woof_search_going() С версии: v.3.3.7.5/1.3.7.5 Определяет, выполняется ли в данный момент поиск WOOF в режиме redirect →
- fn() woof_is_mobile JavaScript-переменная. Если нужно работать с отображением (html/css) или функциональностью плагина или чем-то другим для мобильных устройств, есть JavaScript-переменная… →