HUSKY - Products Filter Professional for WooCommerce
CODEX

Shortcodes, Hooks & Extensions

Полный справочник по HUSKY – профессиональному фильтру товаров WooCommerce

  1. SC [[woof]] Главный шорткод для WooCommerce Products Filter. Генерирует форму поиска. Концепция: 1 страница - 1 фильтр, нельзя размещать несколько фильтров на одной…
  2. SC [[woof_author_filter]] Фильтр по ID авторов, отображается как выпадающий список на фронтенде сайта. Для использования этого шорткода должно быть активировано расширение Searching by Author placeholder …
  3. SC [[woof_btn]] Позволяет создать специальную кнопку для показа/скрытия формы поиска. Отображает кнопку для скрытия фильтра. Работает на основе атрибута шорткода 'autohide'. Пример использования:…
  4. SC [[woof_found_count]] Показывает количество найденных товаров. Вставьте его в обычный текстовый виджет с любым нужным текстом или используйте в хуке woof_print_content_before_search_form. С версии: v.2.1.6  
  5. SC [[woof_front_builder]] С версии v.2.3.4/1.3.4 Этот шорткод позволяет создавать форму фильтра прямо на фронтенде сайта с помощью специального конструктора. Вот демо-страница, где можно…
  6. SC [[woof_mobile]] Этот шорткод добавляет контейнер, в который вставляется мобильная кнопка. Мобильная кнопка появляется на мобильных устройствах для вызова скрытой формы фильтра WOOF и отображает…
  7. SC [[woof_price_filter]] Фильтр по цене в виде выпадающего списка ИЛИ слайдера. У этого шорткода 3 опциональных атрибута type - slider, select,text additional_taxes - Пример -> product_cat:9 - это особое…
  8. SC [[woof_products]] Второй главный шорткод плагина. Позволяет выводить товары на страницах сайта. Все атрибуты шорткода опциональны. per_page - товаров на странице…
  9. SC [[woof_products_messenger]] Без атрибутов. Описание здесь.  
  10. SC [[woof_quick_search]] Должно быть активировано расширение: Quick Search preload - (1/0)если 1, файл данных загружается сразу после загрузки страницы, если 0 - только после того, как…
  11. SC [[woof_quick_search_results]] Должно быть активировано расширение: Quick Search per_page - товаров на странице template_result - должен быть указан, есть 5 предустановленных шаблонов: list_1 | list_2 |…
  12. SC [[woof_save_query]] Назначение: Позволяет авторизованным пользователям сохранять текущие выбранные параметры фильтра для быстрого доступа в будущем. Описание Этот шорткод отображает виджет, в котором пользователи могут сохранять…
  13. SC [[woof_search_options]] Генерирует навигацию поиска, если поиск выполняется (красные кнопки). Без опций.  
  14. SC [[woof_sku_filter]] Генерирует текстовое поле на сайте. Имеет только один опциональный атрибут. Условия поиска задаются на странице настроек плагина, доступной после активации…
  15. SC [[woof_step]] Этот шорткод позволяет создать пошаговый мастер фильтрации для ваших покупателей. Атрибуты: by_step - главный атрибут этого шорткода, в котором указываются ключи…
  16. SC [[woof_text_filter]] Генерирует текстовое поле в магазине для поиска товаров WooCommerce по тексту. Кодовое название - HUSKY. Может искать по: заголовку содержимому краткому описанию метаполям таксономиям…
  1. 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  
  2. 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  
  3. do_action woof_exclude_existing_variations С версии v.2.2.6 Улучшает поиск по наличию. Нужен потому, что не всем нужны вариации в результатах поиска, а также позволяет избежать лишних запросов. По умолчанию…
  4. do_action woof_image_allow_term_desc С версии v.2.2.6 По умолчанию для картинок добавляется описание термина, теперь это можно отключить. По умолчанию true. Пример: add_filter('woof_image_allow_term_desc',…
  5. do_action woof_meta_options_separator С версии v.2.2.6 Нужен для замены разделителя-запятой в опциях, полезно, если метаполе содержит запятую как часть значения, пример: add_filter('woof_meta_options_separator', function ($sep)…
  6. do_action woof_mobile_btn_place_container С версии v.2.2.6 Позволяет переопределить селектор, в котором должна появляться мобильная кнопка фильтра. По умолчанию это css-класс '.woocommerce-products-header'. Пример кода: add_filter('woof_mobile_btn_place_container', function ($selector)…
  7. do_action woof_override_seo_request_uri С версии v.2.2.6/1.2.6 Используется для расширения 'SEO URL request' — передаёт текущий URL. Нужен для адаптации к разным серверам при необходимости
  8. 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;…
  9. 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…
  10. do_action woof_print_html_type_{type} Используется расширениями для отрисовки себя на фронтенде Достаточно просто в init расширения написать следующий код: add_action('woof_print_html_type_' . $this->html_type, array($this, 'print_html_type'),…
  11. 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,…
  12. do_action woof_seo_request_literals С версии v.2.2.6/1.2.6 Используется для расширения 'SEO URL request' — позволяет добавлять возможные литеральные переменные, которые можно вставлять в поля SEO-правил. Пример…
  13. 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'));…
  14. do_action woof_wp_load_js Этот хук позволяет добавлять собственные JavaScript-переменные на фронтенд сайта при необходимости add_action('woof_wp_load_js', function ($str) { $str .= ';var my_var1="Hello";'; $str .= 'var…
  1. 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) {…
  2. 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[]…
  3. 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"…
  4. apply_filters woof_block_toggle_state Позволяет управлять состоянием сворачивания блоков таксономий, например делать их закрытыми на мобильных устройствах: add_filter('woof_block_toggle_state', function($block_is_closed) { if (wp_is_mobile()) { $block_is_closed = true; }…
  5. 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…
  6. apply_filters woof_counter_method Для экспериментов разработчиков с перегрузкой памяти в Dynamic recount. Этот хук используется в файле: wp-content\plugins\woocommerce-products-filter\classes\counter.php В __constructor класса WP_QueryWoofCounter Когда этот хук возвращает TRUE, в…
  7. apply_filters woof_custom_filter_items_order Хук woof_custom_filter_items_order позволяет изменить порядок элементов фильтра, передаёт массив ключей фильтров (ключ секции фильтра можно найти, нажав на…
  8. 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  
  9. apply_filters woof_disable_filter Назначение: Отключить плагин WOOF на определённых страницах или при определённых условиях. Этот хук позволяет полностью отключить функциональность плагина WOOF на определённых страницах, типах записей или…
  10. apply_filters woof_ext_custom_title_by_instock Позволяет задать собственный заголовок для чекбокса 'In stock' в форме фильтра. Также можно перевести его с помощью плагина Loco Translate  
  11. 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  
  12. apply_filters woof_filter_shortcode_args Хук для шорткода [woof], позволяющий изменять аргументы шорткода на лету в зависимости от бизнес-условий add_filter('woof_filter_shortcode_args', function($args) { //do smth with $args here return $args;…
  13. apply_filters woof_filter_title Хук woof_filter_title (с версии v.3.3.6) — через этот фильтр проходят все заголовки как таксономических, так и метафильтров, поэтому можно переводить заголовки по-своему,…
  14. apply_filters woof_get_filtered_price_query С версии ver.2.2.4/1.2.4 Этот хук добавлен для совместимости с другими плагинами. файл: \classes\helper.php public static function get_filtered_price
  15. 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  
  16. apply_filters woof_get_more_less_button_XXXX Используйте этот хук для управления видом кнопки для функции "Not toggled terms count" на фронтенде сайта. XXXX — можно заменить на…
  17. apply_filters woof_get_request_data Используется в функции-шлюзе данных плагина: index.php -> public function get_request_data() — это первая функция в плагине, которая получает данные поискового запроса Может…
  18. 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');…
  19. apply_filters woof_get_terms_args С версии ver.2.2.4/1.2.4 Этот хук добавлен для совместимости с другими плагинами. файл: \classes\helper.php public static function get_terms
  20. 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')…
  21. 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') {…
  22. apply_filters woof_html_types_view_checkbox С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\checkbox.php  
  23. apply_filters woof_html_types_view_mselect С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\mselect.php  
  24. apply_filters woof_html_types_view_radio С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\radio.php  
  25. apply_filters woof_html_types_view_select С версии ver.2.2.4/1.2.4 С помощью этого хука можно переопределить вид файла: \views\html_types\select.php  
  26. apply_filters woof_husky_query_post__in С версии v.2.2.9/v.1.2.9 Есть два режима фильтра Husky: добавление результата поиска через post__in (включён по умолчанию). Преимущество этого режима — надёжность, так как…
  27. apply_filters woof_husky_query_post__in Позволяет управлять текстовой фильтрацией с использованием id записей, запрошено в тикете https://pluginus.net/support/topic/filter-on-title-description-separate-sku-filter/
  28. 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"…
  29. apply_filters woof_init_archive_by_default Позволяет отключить 'Enable archives' для атрибутов товара программно на лету при необходимости add_filter('woof_init_archive_by_default', function($is) { return false; }, 99, 1);…
  30. 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');…
  31. apply_filters woof_max_price_filter Этот хук позволяет задать максимальную цену для фильтра цены HUSKY по своей логике Используйте следующий код в файле functions.php текущей темы…
  32. apply_filters woof_min_price_filter Этот хук позволяет задать минимальную цену для фильтра цены HUSKY по своей логике Используйте следующий код в файле functions.php текущей темы…
  33. apply_filters woof_not_sort_checked_terms Этот хук размещён в index.php плагина в public function woof_sort_terms_is_checked и позволяет исключать html-типы из влияния опции "Lets checked terms…
  34. apply_filters woof_order_catalog С версии v.2.2.4/1.2.4 Позволяет добавить пользовательскую сортировку для каталога
  35. 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);
  36. apply_filters woof_print_content_before_redraw_zone С версии v.2.2.4/1.2.4 Позволяет разместить над товарами произвольное бизнес-html-сообщение, которое не перерисовывается AJAX  
  37. 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…
  38. 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']}'"; });  
  39. 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,…
  40. apply_filters woof_products_top_panel_content С версии ver.2.2.4/1.2.4 Для отображения любого бизнес-контента над результатами фильтрации  
  41. 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…
  42. apply_filters woof_qs_shortcode_data Для расширения: Quick Search Нужен, чтобы изменить параметры шаблона перед загрузкой страницы — например, в зависимости от устройства. [inpost_fancy thumb_width="200" thumb_height="200"…
  43. apply_filters woof_qs_sort_select_data Для расширения: Quick Search Позволяет изменить заголовки сортировки таблицы (когда сортировка в форме представлена выпадающим списком) add_filter('woof_qs_sort_select_data', 'change_title'); function change_title($data) { if…
  44. apply_filters woof_quick_search_products_limit По умолчанию количество товаров ограничено 10 000. Но это значение можно увеличить: add_filter('woof_quick_search_products_limit', function($count){ return 30000; }); Но помните — больше товаров…
  45. 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 =…
  46. apply_filters woof_seo_do_index Хук woof_seo_do_index предназначен для расширения SEO URL. Это для более гибкого управления индексацией. Например, пользователь не хочет индексировать только…
  47. apply_filters woof_seo_meta_description Назначение: Изменить тег meta description для страниц с отфильтрованными товарами. Этот хук позволяет настроить содержимое <meta name="description"> для страниц с активными WOOF…
  48. 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…
  49. 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…
  50. 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
  51. apply_filters woof_sort_terms_checked
  52. 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  
  53. 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…
  54. apply_filters woof_taxonomy_image Позволяет переопределять изображения термина фильтра-изображения на лету в зависимости от текущей ситуации add_filter('woof_taxonomy_image', function($image, $term) { //change images on the…
  55. 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)"…
  56. 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,…
  57. apply_filters woof_term_count_format Позволяет изменить формат счётчика — по умолчанию передаётся '(%d)' Пример: add_filter('woof_term_count_format', function ($format, $tax_slug) { $format = '|%d|'; return $format;…
  58. apply_filters woof_text_autocomplete_items Сколько записей должна возвращать функция автозаполнения для текстового поля Text add_filter('woof_text_autocomplete_items', function($count){ return 5; });
  59. apply_filters woof_text_search_like_option Этот хук регулирует поведение текстового поиска и по умолчанию возвращает FALSE. Если вернуть TRUE, текстовый поиск будет работать без учёта специальных…
  60. 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,…
  61. apply_filters woof_title_tag Используйте хук woof_title_tag, если хотите изменить тег заголовка H4 для каждого блока таксономии на любой другой HTML-тег. Пример: add_filter('woof_title_tag', function($tag){ return 'h5'; });…
  62. 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'…
  63. apply_filters woof_use_wp_cache Хук woof_use_wp_cache включает объектный кэш wp-cache, который более оптимизирован. Показал хорошие результаты в тестах. ВНИМАНИЕ: обязательно должен быть установлен…
  64. apply_filters woof_widget_title_tag Используйте хук woof_widget_title_tag, если хотите изменить тег заголовка H3 для заголовка виджета WOOF на любой другой HTML-тег. Пример: add_filter('woof_widget_title_tag', function($tag){ return 'h4'; });