[woof]

Главный шорткод для WooCommerce Products Filter. Генерирует форму поиска. Концепция: 1 страница — 1 фильтр, размещать несколько фильтров на одной странице нельзя.

Атрибуты

• sid — идентификатор шорткода — используется для генерации уникального CSS-класса в основном контейнере сгенерированной формы поиска, чтобы получить уникальный дизайн. Базовый sid, заданный в плагине по умолчанию — ‘auto_shorcode‘. Пользователи и разработчики могут создавать любые sid и применять собственные CSS-стили.
  Можно менять скины, используя следующий синтаксис: sid =”flat_grey woof_auto_3_columns” — где вместо 3 может стоять целое число от 1 до 4, а вместо flat_grey может быть: flat_grey или flat_dark.
• autohide — должна ли форма поиска быть скрыта (0) или показана (1) после загрузки страницы
• autosubmit — разрешает автоматическую отправку формы поиска, даже если эта опция отключена на странице настроек плагина. Пример: [woof autosubmit=1]
• is_ajax — должна ли сгенерированная форма поиска работать через AJAX (1) или нет (0)
• taxonomies — используется для отображения релевантных элементов фильтра в сгенерированной форме поиска, если в настройках плагина включены: показ количества + динамический пересчёт + скрытие пустых вариантов. Пример: [woof is_ajax=1 taxonomies=product_cat:9,12+locations:30,31]
• ajax_redraw — Перерисовывает форму поиска без отправки данных поиска. Не работает в режиме AJAX. Пример: [woof redirect=”http://www.my_site.com/test-all/” autosubmit=1 ajax_redraw=1 is_ajax=1 tax_only=”locations” by_only=”none”].
• tax_only — мощный атрибут, позволяющий собрать любую форму поиска с произвольными таксономиями через запятую. Пример: [woof tax_only=’pa_color,pa_size‘ by_only=’by_sku,by_author’]. Используйте ‘none’, чтобы не выводить ни одной таксономии. Порядок таксономий в атрибуте ‘tax_only‘ имеет значение!
• by_only — мощный атрибут, позволяющий собрать любую форму поиска с произвольными таксономиями через запятую. Перечислите через запятую любые by-элементы фильтра: by_text,by_price,by_sku,by_author,by_onsales,by_instock. Разумеется, для этого сначала нужно включить соответствующие расширения для этих by-элементов фильтра. Пример: [woof tax_only=’pa_color,pa_size’ by_only=’by_sku,by_author‘]. Используйте ‘none‘, чтобы не выводить нетаксономические элементы. В этом атрибуте также можно использовать ключи метаполей, если они добавлены на вкладке Мета-поля, пример: [woof tax_only=’pa_color,pa_size’ by_only=’_width‘]. Используйте слово ‘none‘, чтобы избежать появления секций фильтра, которые не являются таксономиями.
• tax_exclude — исключает таксономии из формы поиска. Пример: [woof tax_exclude=’pa_size,pa_test’]
• redirect — позволяет показывать результаты на любой другой странице сайта. Пример: [woof redirect=’http://www.my_site.com/search_page_results_77′]. Не работает в режиме ajax — поскольку redirect не имеет смысла в режиме ajax!
• start_filtering_btn — должна ли сгенерированная форма поиска быть скрытой (1) или нет (0). В случае скрытой формы вы увидите простую кнопку, после нажатия на которую появится форма поиска. Лучший вариант, чтобы избежать задержки загрузки страницы, если форма поиска довольно большая. Текст можно изменить с помощью хука woof_start_filtering_btn_txt или атрибута “start_filtering_btn_txt“
• btn_position — позволяет разместить кнопку Filter&Reset снизу — b, сверху — t, сверху и снизу — tb. По умолчанию — снизу. Не работает в бесплатной версии!!
• dynamic_recount — позволяет включить (1) или отключить (0) динамический пересчёт индивидуально для текущей формы поиска товаров. По умолчанию используется значение из настроек на вкладке Options. Не работает в бесплатной версии!!
• hide_terms_count — скрыть текст с количеством вариантов, 1 или 0. Не работает в бесплатной версии!!
• conditionals — специальный атрибут для расширения ‘Conditionals‘, которое позволяет задавать условия отображения элементов фильтра в зависимости от текущего запроса фильтрации — что-то вроде предопределённых шагов. Пример: [woof conditionals=’product_cat>by_price,pa_size,by_instock>pa_color+pa_size->by_price’]
• mobile_mode — скрывает форму фильтра WOOF на мобильном устройстве, вместо неё появляется кнопка для отображения фильтра. Атрибут ‘sid‘ обязателен! Пример: [woof mobile_mode=1 sid=’test’]. Кнопка автоматически добавляется к селектору ‘.woocommerce-products-header‘, который можно изменить с помощью хука ‘woof_mobile_btn_place_container‘. Чтобы вывести кнопку в конкретном месте, используйте шорткод [woof_mobile] — этот шорткод добавляет контейнер, в который вставляется кнопка.