WooCommerce AJAX Products Filter

1. Скопируйте ключ аккаунта с сайта BeRocket
2. Вставьте этот ключ в поле Ключ учетной записи
3. Нажмите кнопку Test
4. Если Вы используете правильный ключ аккаунта, Вы увидите
5. Нажмите кнопку Сохранить изменения

1. Скопируйте ключ плагина с сайта BeRocket
2. Вставьте этот ключ в поле WooCommerce AJAX Products Filter
3. Нажмите кнопку Test
4. Если Вы используете правильный ключ плагина, Вы увидите
5. Нажмите кнопку Сохранить изменения

• Продукты на странице – можно установить количество продуктов на странице
• Количество Значений Атрибута – количество атрибутов которые будут отображаться в виджете, остальные атрибуты можно увидеть нажав на кнопку “Показать значение(я)”. Настройка Скрыть кнопку “Показать/Скрыть значение(я)” должна быть отключена
• Прокрутить страницу наверх – после фильтрации будет страницу скролить в верх с отступом в пикселях указанных в поле
• Пересчет и вывод значений – вариант пересчета и вывода значений категорий/атрибутов/тегов/и т.д. для виджетов фильтров
  • Отображаются все непустые значения и будет использоваться стандартный пересчет
  • Удаляются пустые значения на основных страницах(категорий/тегов/и т. д.)
  • Отображаются все непустые значения и учитываются фильтры при пересчете значений атрибутов
  • Удаляются пустые значения на основных страницах (категорий/тегов/и т. д.). Фильтры учитываются при пересчете значений атрибутов, а пустые значения после фильтрации будут скрыты
  • Фильтры учитываются при пересчете значений атрибутов. Пустые значения удаляются на стороне сервера
• Скрыть значения
  • Скрыть значения без продуктов – будут скрываться значения атрибутов/категорий в фильтрах у которых нет продуктов, после фильтрации(будет выведена кнопка “Показать/Скрыть значение(я)”, при нажатии на которую будут показаны “Скрытые значения без продуктов”)
  • Скрыть выбранные значения – будут скрываться значения атрибутов/категорий в виджетах фильтров по которым была произведена фильтрация(будет выведена кнопка “Показать/Скрыть значение(я)”, при нажатии на которую будут показаны “Скрытые выбранные значения”)
  • Скрыть пустые виджеты – будут скрываться виджеты после фильтрации если нет продуктов с такими атрибутами/категориями в этом виджете
  • Скрыть кнопку “Показать/Скрыть значение(я)” в фильтрах – будет скрывать кнопку “Показать/Скрыть значение(я)” работает только при включенных опциях “Скрыть значения без продуктов” и “Скрыть выбранные значения”

Вариативные Продукты и Опции для Вариаций

• Скрыть вариации которых нет в наличии – Отключить, Включить, Включить если выбрано в фильтрах “Нет в наличии”
  • Скрывать вариации продуктов, если вариаций с выбранными фильтрами нет в наличии
    • Используйте для значений атрибутов, чтобы отобразить более правильный счет с опцией “Пересчет и вывод значений”
    • Исправление проблемы с запросом WPEngine (также может работать с другими хостингами, если они ограничивают размер запроса)
• Отображение данных вариаций
  • Картинки – после фильтрации отображать на вариативном продукте картинку вариации которая подходит по критериям фильтрации
  • Цена – отображать цену вариации, которая подходит по критериям фильтрации
• Запомнить выбор вариации – после фильтрации при открытии вариативного продукта будут выбранны атрибуты, по которым была произведенна фильтрация
• Поиск цены вариации – использовать цену вариации вместо цены товара. ВАЖНО! Это может замедлить фильтрацию по цене.

• Позиция элементов – расположение всех элементов, элементы выводятся используя хуки WooCommerce. Если нет хуков элементы могут не выводится.
  • Описание WooCommerce(в заголовке)
  • Перед WooCommerce Shop Loop – перед продуктами
  • После WooCommerce Shop Loop – после продуктов
• Отображать выбранные фильтры – показывать выбранные фильтры над продуктами
  • Скрыть область выбранных фильтров, если ничего не выбрано (влияет только на область над продуктами)
• Показывать количество продуктов до фильтрации – опция работает только при использовании “кнопки Фильтрации продуктов”. Выводится всплывающее окно в котором указано сколько будет продуктов после нажатия “кнопки Фильтрации продуктов”, можно отфильтровать при нажатии на “кнопку показать” в всплывающем окне. Нельзя использовать с включенной опцией “Скрыть выбранные значения”
  
• Элементы над продуктами – возможность добавить “Группы” фильтров над продуктами

• Получить селекторы автоматически – будет использоваться скрипт который автоматически будет искать селекторы в Вашей теме, после чего их автоматически установит в поля селекторов(можете работать не корректно с некоторыми темами). Для получения селекторов будет создано три продукта и одна категория, после завершения получения селекторов продукты и категория будут удалены.
• Селектор продуктов – селектор для тега, который содержит товары. Не меняйте это, если Вы не знаете, что это такое
• Селектор количества продуктов – селектор для тега с результатов количества продуктов(«Показано 1–8 из 61 результатов»). Не меняйте это, если Вы не знаете, что это такое
• Селектор для сортировки продуктов – селектор для блока сортировки. Не меняйте это, если Вы не знаете, что это такое
• Селектор пагинации продуктов – селектор для тега, который содержит товары. Не меняйте это, если Вы не знаете, что это такое

• Обновить URL при фильтрации – если эта настройка включена, URL будет изменен при выборе/изменении фильтра
  • Использовать ссылки для флажков и переключателей фильтров – в виджетах делает название категории/артибута ссылкой, эти ссылки могут индексировать поисковые боты
    • Используйте noindex для ссылок – в ссылки будет добавляться тег noindex
    • Используйте nofollow для ссылок – в ссылки будет добавляться тег nofollow
  • Используйте slug в URL – использовать slug атрибута вместо ID. Не используйте в slug символы “-“, “_”, “+”, “*”, “№” и т.п.
  • Хорошие URL – Работает только с SEO дружественными URL. Постоянные ссылки WordPress должны быть установлены на «Имя публикации» (пользовательская структура: /% postname% /)
  • Декодирование URL – расшифровывает символы в URL, чтобы избежать ошибок на стороне сервера
• Не отображать фильтры в Canonical – используйте канонический тег без фильтров на страницах WooCommerce

• SEO Мета, Заголовки –
  • SEO Элементы –
    
    • Название
    • Заголовок
    • Описание
  • SEO структура элементов – можно выбрать структуру построения выбранных фильтров
    • {title} with [attribute] [values] and [attribute] [values]
    • {title} [attribute]:[values];[attribute]:[values]
    • [attribute 1 values] {title} with [attribute] [values] and [attribute] [values]
    • {title} – [values] / [values]

• Продукты на странице – можно установить количество продуктов на странице
• Показывать продукты – отображать всегда продукты, когда выбраны фильтры. Используйте это, когда у Вас есть категории и подкатегории на страницах магазина, но Вы хотите отображать продукты при фильтрации
• Использование налогов в фильтрах цен – можно выбрать или использовать налоги в виджетах фильтров цен и диапазона цен. Работает только для “Стандартных ставок”
  
• Страница такая же как фильтр – на странице категории, тега, атрибута фильтра для него будет удалено значение или останется только одно значение
  • По умолчанию – будет выводится все значения в виджетах фильтров
  • Удалить значения – удаляет выбранные значения в виджете фильтров
  • Оставить только одно значения – убирает все значения в виджете фильтров кроме того, которого сейчас выбрано
• Кэш данных – можно выбрать вариант кэширования для фильтров
  • Выключено – выключено кэширование фильтров
  • WordPress Кэш – используется WordPress Кэширование
  • Плагины постоянного кэширования – используются другие плагины кэширования(примеры плагинов постоянного кэширования W3 Total Cache, WP Super Cache)

• Отключить все фильтры – если Вы хотите скрыть фильтры без потери текущей конфигурации, просто отключите их
• Отключить админ панель – отключить админ панель WordPress
• Очистить Кэш – очистить кэш атрибутов/пользовательских таксономий для плагина

• Стили отображения только для страниц с фильтрами – добавлять стили только на страницах где есть фильтры
• Исправление для сайтов с AJAX – исправление для сайтов использующих AJAX
• Исправление для страницы поиска – отключить пере направление, когда страница поиска возвращает только один продукт
• Ползунок имеет много значений – включите настройку, если ползунок имеет более 250 значений. Иерархическая таксономия может работать некорректно с ползунками
• Select2 CSS – исправленные стили CSS для Select2 (не включайте, если Select2 работает правильно. Опция может сломать Select2 в других плагинах или темах)
• Исправить проблему с запросом WPEngine – может также работать с другими хостингами, если они ограничивают размер запроса.

• Иконка загрузки продуктов – можно загрузить картинку для анимации загрузки
• Текст возле иконки загрузки – текста и его расположение при загрузке
  • Выше – над картинкой
  • Ниже – под картинкой
  • Перед – до картинки
  • После – после картинки
• Показать и скрыть описание – настройки для показать и скрыть описания
  • Показать при
    • Нажатии
    • Наведении на иконку
  • Скрывать при
    • Нажатии в любом месте
    • Курсор вне иконки
• Стиль для количества продуктов – стиль подсчета продуктов
• Вариант отступа для дерева дочерних
  • –
  • пробел
  • 2 пробела
  • таб

• Стиль кнопки «Свернуть» – выбор стиля кнопки открытия боковой панели/развертывания фильтров
• Стиль значка кнопки «Свернуть» – выбор значка для кнопки
• Тень Боковой Панели – выбор стиля тени при открытой боковой панели

• Описание Фильтров
• Имя Подсказки Цвета/Картинки
• Количество Продуктов Перед Обновлением – стиль подсказки с количеством продуктов перед фильтрацией

• Название – можно настроить стили отображения на страницах магазина для Названия фильтра
  
• Название при открытии – можно настроить стили отображения на страницах магазина для Названия фильтра когда он открыт
  
• Фильтр – можно настроить стили отображения на страницах магазина для фильтра, когда фильтр открыт
  

• Отключить Font Awesome – Не загружайте файл CSS для Font Awesome на сайт. Отключите его, только если Вы не используете иконки Font Awesome в виджетах или у Вас есть Font Awesome в Вашей теме.
• Версия Font Awesome – Версия Font Awesome, которая будет использоваться в настройках и на страницах магазина. Пожалуйста, выберите версию, которая в Вашей теме
• Перед обновлением – поле для выполнения JavaScript до фильтрации
• Во время обновления – поле для выполнения JavaScript во время фильтрации
• После обновления – поле для выполнения JavaScript после фильтрации
• Пользовательский стиль CSS – поле для пользовательского CSS

Дополнительные таблицы (БЕТА)

Условия после фильтрации (БЕТА)

Ссылка как у WooCommerce (БЕТА)

Пользовательская Боковая Панель

В Условиях для ID Страницы можно выбрать на каких страницах выводить виджеты фильтров.

Если будет выбрано значение Равно виджеты будут выводиться на выбранных страницах.
Если будет выбрано значение Не равно виджеты не будут выводиться на выбранных страницах.

В Условиях для Категории Продуктов можно выбрать для каких категорий выводить виджеты фильтров.

Если будет выбрано значение Равно виджеты будут выводиться на страницах выбранных категориях.
Если будет выбрано значение Не равно виджеты не будут выводиться на страницах выбранных категориях.

В Условиях для Атрибута Продукта можно выбрать для каких страниц, атрибутов или тегов выводить виджет

Если будет выбрано значение Равно виджеты будут выводиться на выбранных страницах атрибутов или тегов.
Если будет выбрано значение Не равно виджеты не будут выводиться на выбранных страницах атрибутов или тегов.

В Условиях для Поиска Продукта можно выбрать выводить фильтры после поиска или нет

Если будет выбрано значение Равно виджеты будут выводиться после поиска.
Если будет выбрано значение Не равно виджеты не будут выводиться после поиска.

Виджет Фильтр выводит фильтры по Атрибутам, Тегам, Подкатегориям продуктов, Пользовательские таксономии, Состояние на складе, Дате, Распродаже, Категориям продуктов, Рейтингу.

Фильтровать по

Оператор

Сортировка Значений

Тип сортировки

Виджет Кнопка Фильтрации Продуктов добавляет кнопку для фильтрации, до нажатия на кнопку фильтрация не будет выполняться

Виджет Кнопка Сброса фильтров – добавляет кнопку для сброса выбранных фильтров.

Скрыть кнопку – настройка для того что бы спрятать кнопку сброса

• Не прятать – кнопка сброса будет выводиться всегда
• Скрыть только когда нет фильтров на странице – кнопка сброса будет скрываться когда нет фильтров на странице.
• Скрыть, когда нет фильтров на странице или страница не отфильтрована

Виджет Область Выбранных Фильтров

• Показать если ничего не выбрано – показывать виджет без выбранных фильтров
• Скрыть стрелку для сворачивания виджета?
• Скрыть этот виджет при загрузке?

• Пользовательский CSS класс – можно установить пользовательский класс для группы
• Показывать группу фильтров над продуктами
• Вывод фильтров в линию
  • Максимальное количество фильтров в линию
• Вывод только заголовков – когда настройка включена, фильтры будут свернуты
  • Отображение при наведении курсора мыши и скрыть при убирание курсора
• Фильтры в группе – добавление фильтров в группу для вывода на страницах магазина

Для создания Блок Поиска Вам нужно:

• в группе добавить нужные фильтры для “Блок Поиска”
• включить настройку “Использовать группу как блок поиска” в блоке “Блок Поиска”
  
• выбрать нужные Вам настройки в блоке “Блок Поиска”
  • Ссылка для поиска – выбор на какую страницу будет производится переход после использования “Блок Поиска”
    • Страница магазина – переход на стандартную страницу магазина
    • Страница категории – переход на страницу категории
      • Категория – можно выбрать на страницу какой категории перейти
    • Ссылка – пользовательская ссылка
      • Ссылка для поиска – можно указать любую ссылку для перехода

Вызывается перед конвертацией данных в ссылке в необходимый формат для дальнейшего использования

Используется для отображения дополнительных настроек в группах фильтров

Параметры

• $filters – массив значений всех настроек группы
• $post_name – имя поля, которое используется для сохранения настроек
• $post – пост для которого эти настройки

Подключает все стили фильтров. Используется для получения информация о всех стилях и вывода всех стилей на странице создания фильтров. Можно подключать стили с других плагинов или темы.

Добавление новых стилей в тему

Плагин автоматически подключает все стили с темы, которые находятся в директории braapf-template-styles

Read More

Фильтрация элементов одного значения фильтров Checkbox, Select для построения HTML кода

Параметры

• $element – массив с элементами
• $term – значение атрибута для которого генерируется HTML
• $i – какой этот атрибут по счёту
• $berocket_query_var_title – все параметры для текущего фильтра

Фильтрация всех элементов одного фильтра для построения HTML кода

Параметры

• $template_content – массив с элементами фильтра
• $terms – все значения атрибута для этого фильтра
• $berocket_query_var_title – все параметры для текущего фильтра

Фильтрация элементов Update button, Reset button, Selected filters area для построителя HTML кода

Параметры

• $template_content – массив с элементами виджета
• $berocket_query_var_title – все параметры для этого виджета

Получить список всех стилей, которые были уже подключены

Параметры

• $custom_taxonomies_list – список таксономий с необходимыми данными

Все параметры для WordPress функции get_terms

Параметры:

• $args – массив с аргументами, которые будут использоваться для функции get_terms
• $filter_data – настройки фильтра, которые были установлены при его создании
• $widget_args – параметры виджета

Дополнительные параметры, которые используются для изменения значений полученных от WordPress функции get_terms

Параметры:

• $additional – массив с дополнительными параметрами
  • hierarchical(boolean) – отсортировать значения иерархически
  • depth(int) – все дочерние элементы которые по иерархии находятся дальше этого значения будут удалены, при установке значения в ноль ничего не удаляется
  • operator(string) – оператор который будет использоваться для подсчета продуктов в значениях, может быть OR, AND
  • recount_tax_query(array) – массив tax_query который будет использоваться для пересчета значений, по умолчанию берется с текущего запроса для продуктов
  • disable_recount(boolean) – выключить пересчет значений учитывая другие фильтры и вариации(зависит от глобальных настроек)
  • disable_hide_empty(boolean) – отключит удаление значений без продуктов для страницы. Если значение атрибута не используется ни в одном продукте(для всего магазина), то это значение в любом случае будет удалено
• $filter_data – настройки фильтра, которые были установлены при его создании
• $widget_args – параметры виджета
• $get_terms_args – параметры для WordPress функции get_terms

Проверка на то применены ли фильтры на текущей странице

Параметры

• $is_filtered – применяются фильтры или нет
• $place – название места где вызывается хук

Список значений для опции “Позиция выбранных фильтров” в настройках плагина вкладка SEO

Параметры

• $options – массив со значениями, где каждый элемент это массив с такой структурой: array(“value” => “function_name”, “text” => “Визуальное название в выпадающем списке”)

Функцию “function_name” можно объявить в файле function.php темы или в любом другом месте, где она будет общедоступна.

Параметры функции “function_name”

• $filters – текущий сформированный текст, обычно пустая строка
• $text – начальный текст для текущей секции
• $section – имя секции (header, title, description)
• $terms_filtered – массив текущих фильтров

Пропустить значение атрибута при составлении списка фильтров для отображения в title, header, description страницы

Параметры

• $skip – пропустить значение или нет (изначально false)
• $term_parsed – массив данных о значении атрибута (может различаться в зависимости от типа фильтра)

Изменить имя атрибута для использования в title, header, description блоках страницы.

Параметры

• $taxonomy_label – название атрибута
• $taxonomy – объект таксономии атрибута
• $term – текущее значение таксономии (может быть массивом значений)
• $term_parsed – массив данных о значении атрибута (может различаться в зависимости от типа фильтра)

Изменить имя значения атрибута для использования в title, header, description блоках страницы.

Параметры

• $term_name – название значения атрибута
• $term – текущее значение таксономии (может быть массивом значений)
• $taxonomy – объект таксономии атрибута
• $term_parsed – массив данных о значении атрибута (может различаться в зависимости от типа фильтра)

Изменить имя цены для использования в title, header, description блоках страницы.

Параметры:

• $price_name – название цены. Используется __(‘Price’, ‘woocommerce’)

Изменить текст значения цены для использования в title, header, description блоках страницы.

Параметры:

• $price_name – текст значения цены
• $price_data – все данные о цене которые есть при фильтрации
• $prices – массив с начальной ценой и конечной ценой

Замена текста для title, header, description блоков страницы. К этому хуку подключается функция, которая была выбрана в настройках.

Параметры:

• $text_return – текст который будет использоваться. Изначально пустая строка
• $text – оригинальный текст
• $section – название секции (title, header, description)
• $terms_filtered – массив с данными всех выбранных фильтров

Замена текста для title, header, description блоков страницы. Этот хук вызывается уже после замены и проверки и представляет готовый текст

Параметры:

• $text_return – текст который будет использоваться
• $text – оригинальный текст
• $section – название секции (title, header, description)
• $terms_filtered – массив с данными всех выбранных фильтров

Хук получения HTML кода для создания нового элемента для виджетов. Возможные значения $type: single, group

Параметры:

• $html – HTML код формы для создания нового элемента

Хук для сохранения нового элемента для виджетов. Возможные значения $type: single, group.

Параметры:

• $data – массив с данными о новом элементе формата array(‘value’ => $post_id, ‘name’ => $element_name, ‘name2’ => $element_title, ‘edit’ => $edit_post_link)

Текущая страница без GET запроса и фильтров

Параметры:

• $current_page_url – текущий URL страницы без GET запроса и фильтров
• $options – массив с настройками плагина

Фильтрация массива с настройками для JavaScript

Параметры:

• $settings – массив с настройками

Проверяет нужно фильтровать шорткод WooCommerce или нет

Параметры:

• $is_filter – нужно ли фильтровать шорткод WooCommerce
• $query_vars – массив данных шорткода для WP_Query
• $atts – массив атрибутов шорткода
• $name – имя шорткода

Фильтрация массива с ID продуктов, которые будут исключены. Используется для исключения вариативных продуктов, где подходящих вариаций нет в наличии

Параметры:

• $products – массив с ID продуктов
• $terms – массив с фильтрами, которые применяются
• $limits – массив с фильтрами-слайдерами, которые применяются

Фильтрация массива с параметрами для WP_Query. Массив уже содержит все фильтры и ограничения

Параметры:

• $query_vars – массив с параметрами для WP_Query
• $terms – массив с фильтрами, которые применяются
• $limits – массив с фильтрами-слайдерами, которые применяются

Фильтрация проверки является ли текущий запрос основным для WooCommerce

Параметры:

• $is_wc_main_query – является ли текущий запрос основным
• $query – объект WP_Query, запрос
• $is_shortcode – это фильтрация шорткода WooCommerce или нет

Фильтрация WP_Query. Уже содержит фильтры и ограничения.

Параметры:

• $query – WP_Query для получения продуктов с фильтрами
• $terms – массив с фильтрами, которые применяются
• $limits – массив с фильтрами-слайдерами, которые применяются

Фильтрация любого WP_Query запроса, который проходит через функцию фильтрации, вне зависимости от того добавляются фильтры к нему или нет.

Параметры:

• $query – WP_Query запрос
• $is_shortcode – это шорткод WooCommerce или нет

Фильтрация мета ключа для цены продуктов

Параметры:

• $price_meta_key – мета ключ для цены. По умолчанию: _price
• $position – название позиции хука

Фильтрация параметров, которые будут добавлены в WP_Query для фильтрации продуктов

Параметры:

• $args – массив с параметрами для WP_Query

Фильтрация параметров для группы фильтров, перед отображением всех фильтров. Так же используется для вывода дополнительных блоков перед группой фильтров

Параметры:

• $custom_vars – массив с дополнительными параметрами для группы
• $group_settings – настройки группы фильтров

Фильтрация аргументов в группе фильтров, которые используются для всех фильтров

Параметры:

• $new_args – массив с параметрами для виджета фильтров
• $group_settings – настройки группы фильтров
• $custom_vars – массив с дополнительными параметрами для группы

Фильтрация аргументов в группе фильтров, которые используются для каждого фильтров

Параметры:

• $new_args – массив с параметрами для виджета фильтров
• $group_settings – настройки группы фильтров
• $filter – ID фильтра
• $custom_vars – массив с дополнительными параметрами для группы

Фильтрация параметров для группы фильтров, перед отображением каждого фильтра. Так же используется для вывода дополнительных блоков перед каждым фильтром в группе фильтров

Параметры:

• $custom_vars – массив с дополнительными параметрами для группы
• $group_settings – настройки группы фильтров

Фильтрация параметров для группы фильтров, после отображения каждого фильтра. Так же используется для вывода дополнительных блоков после каждого фильтра в группе фильтров

Параметры:

• $custom_vars – массив с дополнительными параметрами для группы
• $group_settings – настройки группы фильтров

Фильтрация параметров для группы фильтров, после отображения всех фильтров. Так же используется для вывода дополнительных блоков после группы фильтров

Параметры:

• $custom_vars – массив с дополнительными параметрами для группы
• $group_settings – настройки группы фильтров

Фильтрация массива с типами фильтров

Параметры:

• $filter_type_array – массив с типами фильтров с параметрами

Хук для получения данных с кэша. Изначально возвращает false. При включении кэширования в плагине к этому хуку привязывается функция для возврата данных с кэша

Параметры:

• $data – данные с кэша
• $key – ключ для кэширования
• $group – группа для кэширования

Хук для сохранения данных в кэш. Изначально возвращает true. При включении кэширования в плагине к этому хуку привязывается функция для сохранения данных в кэш

Параметры:

• $set_result – сохранены данные или нет
• $key – ключ для кэширования
• $value – значение для сохранения
• $group – группа для кэширования
• $expire – на какое время сохранить кэш

Фильтрация массива со всеми атрибутами продуктов WooCommerce

Параметры:

• $attributes – массив со всеми атрибутами продуктов

Фильтрация массива всех таксономий по которым фильтруются продукты

Параметры:

• $taxonomies – массив таксономий

Фильтрация массива операторов для всех таксономий по которым фильтруются продукты

Параметры:

• $taxonomies_operator – массив операторов для таксономий

Фильтрация атрибута при добавлении в tax_query для WP_Query продуктами

Параметры:

• $taxonomy – массив с параметрами для одного элемента tax_query

Фильтрация значений слайдера цены при распознавании фильтров в ссылке

Параметры:

• $prices – массив с ценами: от какой цены, до какой цены

Фильтрация массива с типами виджетов для настроек фильтров

Параметры:

• $widget_types – массив с типами виджетов

Фильтрация настроек виджета с фильтрами

Параметры:

• $instance – массив с настройками фильтра

Фильтрация параметров для виджета с фильтрами

Параметры:

• $args – массив с параметрами для виджета

Фильтрация текста перед ценой, настраивается в фильтре цены

Параметры:

• $text – текст перед ценой

Фильтрация текста после цены, настраивается в фильтре цены

Параметры:

• $text – текст после цены

Можно использовать для предотвращения вывода фильтров. Используется для вывода специфических фильтров

Параметры:

• $not_display – не отображать фильтры. По умолчанию: false
• $widget_type – тип виджета фильтров
• $instance – настройки фильтра
• $args – параметры виджета
• $object – объект BeRocket_AAPF_Widget класса для вызова необходимых функций

Фильтрация значений wp_term которые будут использоваться в фильтре при выводе

Параметры:

• $terms – массив со значениями атрибута

Фильтрация пользовательских классов, которые будут добавлены к виджету

Параметры:

• $classes – строка с классами что будут добавлены, может быть пустой

Фильтрация CSS стилей, которые будут добавлены к виджету

Параметры:

• $styles – строка со стилями что будут добавлены, может быть пустой

Фильтрация минимального значения цены от выбранного промежутка значений

Параметры:

• $price – минимальная цена
• $base_price – начальная минимальная цена до всех фильтраций

Фильтрация максимального значения цены от выбранного промежутка значений

Параметры:

• $price – максимальная цена
• $base_price – начальная максимальная цена до всех фильтраций

Фильтрация всех значений, которые передаются в шаблон для вывода фильтров

Параметры:

• $parameters – массив всех параметров для передачи
• $type – тип фильтра
• $instance – все настройки фильтра

Фильтрация минимального значения цены от выбранного промежутка значений и от минимального доступного значения

Параметры:

• $price – минимальная цена

Фильтрация максимального значения цены от выбранного промежутка значений и от максимально доступного значения

Параметры:

• $price – максимальная цена

Фильтрация данных, которые возвращает функция get_price_range

Параметры:

• $price_range – Массив из двух значений минимальной цены и максимальной цены или false, если цены нет

Фильтрация части запроса с WHERE для удаления продуктов которых нет в наличии при проверке вариативных продуктов

Параметры:

• $query – строка с запросом

Фильтрация запроса для получения вариаций, которых нет в наличии для текущих фильтров

Параметры

• $query – запрос в виде массива
• $input – начальные данные
• $terms – выбранные фильтры
• $limits – выбранные слайдеры
• $current_attributes – атрибуты в фильтрах
• $current_terms – значения атрибутов в фильтрах

Фильтрация данных, которые используются в Update button, Reset button, Selected filters area

Параметры

• $set_query_var_title – все параметры
• $additional – дополнительные параметры для элемента

Фильтрация данных, которые используются для пересчета количества продуктов для значений атрибута

Параметры

• $taxonomy_data – все данные
• $terms – список всех значений атрибута

Массив фильтрации при помощи таксономий tax_query, который используется в запросе пересчета количества продуктов для значений атрибута

Параметры

• $tax_query – массив фильтрации по таксономиям
• $terms – значения текущего атрибута
• $taxonomy_data – параметры для пересчета количества продуктов для значений атрибута
• $old_tax_query – текущий массив $tax_query

Массив фильтрации при помощи мета данных продукта meta_query, который используется в запросе пересчета количества продуктов для значений атрибута

Параметры

• $meta_query – массив фильтрации при помощи мета данных
• $terms – значения текущего атрибута
• $taxonomy_data – параметры для пересчета количества продуктов для значений атрибута
• $old_meta_query – текущий массив $meta_query

Фильтрация аргументов, которые передаются в WodrPress функцию get_terms. Получение значений атрибутов для фильтров

Параметры

• $args – аргументы для get_terms
• $additional – дополнительные параметры, которые используются для дальнейшей фильтрации значений

Фильтрация дополнительных параметров для получения правильных значений атрибутов. Получение значений атрибутов для фильтров

Параметры

• $additional – дополнительные параметры, которые используются для дальнейшей фильтрации значений
• $args – аргументы для get_terms

Фильтрация полученных значений атрибутов

Параметры

• $terms – значения атрибута с функции get_terms
• $args – аргументы для get_terms
• $additional – дополнительные параметры, которые используются для дальнейшей фильтрации значений

Генерация HTML кода элемента построителем фильтров

В плагине определено 2 типа элемента{$type} tag и tag_open

Параметры

• $html – HTML код, пустая строка. Должен быть сгенерирован при помощи этого хука
• $element – все параметры элемента

Фильтрация списка типов виджетов на странице создания фильтров

Параметры

• $widget_types – массив с данными всех типов виджетов

Фильтрация промежутка цен

Параметры:

• $price_range – Массив из двух значений минимальной цены и максимальной цены

Фильтрация массива с элементами запроса для подсчета количества продуктов в промежутке цен

Параметры:

• $query_args – массив с которого собирается запрос

Изменить имя дополнительных атрибутов для использования в title, header, description блоках страницы.

Параметры

• $taxonomy_label – название атрибута
• $term_parsed – массив данных о значении атрибута (может различаться в зависимости от типа фильтра)
• $custom_name – массив со всеми доступными дополнительными атрибутами

Изменить имя значения дополнительных атрибутов для использования в title, header, description блоках страницы.

Параметры

• $term_name – название значения атрибута
• $term_parsed – массив данных о значении атрибута (может различаться в зависимости от типа фильтра)

Функция проверки есть фильтры на странице или нет

Параметры:

• $filters [boolean] – проверить обычные фильтры
• $limits [boolean] – проверить слайдеры с атрибутами
• $price [boolean] – проверить слайдер цены
• $search [boolean] – проверить поиск

Возвращает:

[boolean] Есть фильтры или нет

Выбрано значение атрибута или нет для флажка, переключателя или выпадающего списка

Параметры:

• $term [object] – объект WP_Term со значением атрибута для проверки
• $checked [boolean] – для флажка, переключателя
• $child_parent [boolean] – искать в дочерних
• $depth [int] – глубина поиска в дочерних

Возвращает:

[string] Строка с текстом для флажка, переключателя или выпадающего списка

Возвращает выбранные в фильтрах значения для таксономии

Параметры:

• $taxonomy [string] – slug таксономии

Возвращает:

[array] Массив с ID значений таксономии

Добавление фильтрации к массиву, который будет использоваться для WP_Query

Параметры:

• $query_vars [array]- Массив с текущими параметрами

Возвращает:

[array] Массив с параметрами собранными с входящего массива и данных для фильтрации

Начиная с версии 3.0(1.5 для бесплатной версии) плагин использует функции аналогичные хукам в WordPress для JavaScript кода.

Подробнее о всех JavaScript хуках можно посмотреть на этой странице. Подробнее о функциях для применения фильтров можно узнать на этой странице этой странице

При добавления хука сразу при загрузке страницы необходимо проверить или функции доступны, если они не доступны используйте событие berocket_hooks_ready, которое вызывается сразу после

Пример кода для замены функции разворачивания фильтра

bapf_custom_smb_open_function = function(use_default, $this) {
    $this.find('.bapf_body').first().show();
    if( $this.find('.bapf_colaps_smb').length ) {
        $this.find('.bapf_colaps_smb').removeClass('fa-chevron-down').addClass('fa-chevron-up');
    }
    return false;
}
if ( typeof(berocket_add_filter) == 'function' ) {
    berocket_add_filter('colaps_smb_open_apply', bapf_custom_smb_open_function);
} else {
    jQuery(document).on('berocket_hooks_ready', function() {
        berocket_add_filter('colaps_smb_open_apply', bapf_custom_smb_open_function);
    });
}

Функции можно вызвать в пользовательских скриптах

berocket_add_filter

berocket_apply_filters

berocket_do_action

berocket_remove_filter

berocket_throw_error

braapf_init_load

braapf_update_products

braapf_grab_all

braapf_grab_single

braapf_compact_filters

braapf_compat_filters_to_string

braapf_get_current_url_data

braapf_build_url_from_urldata

braapf_filter_products_by_url

Начиная с версии 3.0 в Javascript коде плагина появился аналог WordPress хуков для изменения поведения работы фильтров.
Все функции являются аналогами WordPress функций

Функции которые используются для хуков и аналоги WordPress

berocket_add_filter – add_filter

berocket_apply_filters – apply_filters

berocket_do_action – do_action

berocket_remove_filter – remove_filter

input_ckbox_changed

filter_changed_element

ajax_load_from_pagination

braapf_filters_mask

before_update_products_context

apply_filters_to_page

apply_filters_to_page_partial

ajax_load_from_filters_partial

page_has_products_holder

ajax_load_from_filters

grab_all_filters

grab_single_filter_taxonomy_undefined

grab_single_filter_exist

grab_single_filter

grab_single_filter_default

glue_by_operator

compat_filters_result_single

compat_filters_result

compat_filters_to_string_single

compat_filters_to_string

get_current_url_data

url_from_urldata_baselink

url_from_urldata_linkget

build_url_parameters_default

load_products_ajax_on_popstate

ajax_load_from_url_url

ajax_load_from_url_data

ajax_load_from_url_callback

ajax_load_from_url_beforeSend

ajax_load_from_url_done

ajax_load_from_url_done_after

ajax_load_from_url_fail

ajax_load_from_url_fail_after

ajax_load_from_url_always

ajax_load_from_url_always_after

jqrui_data_slidr_ion

jqrui_slidr_ion_{data-display}

jqrui_slidr_ion_link_{data-display}

jqrui_slidr_{data-display}

jqrui_slidr_link_{data-display}

hidden_clickable_close_mouseleave

hidden_clickable_open_delay

bapf_rst_nofltr_hide

bapf_rst_sel_show

pagination_links_a_tags

pagination_href_from_clicked_a

filter_mobile_width

filter_tablet_width

remove_same_filters_to_prevent_errors

update_page_on_error

default_selected_filters_area_single

default_selected_filters_area_full_exist

default_selected_filters_area_full_notexist

remove_shortcode_fix_filters

scroll_shop_to_top

universal_theme_compatibility

uncode_theme_compatibility

flatsome_theme_compatibility

woodmart_theme_compatibility

divi_theme_compatibility

rey_theme_compatibility

layzyloadimage_script_compatibility

jetpacklazyimages_script_compatibility

braapf_init_filtered_set

update_products

braapf_init

braapf_init_for_parent

berocket_hooks_ready

berocket_filters_document_ready

berocket_filters_first_load

berocket_ajax_filtering_start

berocket_ajax_filtering_on_update

berocket_ajax_products_loaded

berocket_ajax_products_not_loaded

berocket_ajax_filtering_end

braapf_unselect

braapf_unselect_all

bapf_ochild

bapf_cchild

bapf_ocolaps

bapf_ccolaps

braapf_change_jqrui_slidr

[paid] berocket_inline_before_width_calculate

[paid] berocket_inline_after_width_calculate