Описание
Captain Advance Filter — это легкий плагин поиска и фильтрации для WordPress, который позволяет создавать мощные фильтры на базе AJAX для записей, страниц, пользовательских типов записей и товаров WooCommerce.
Создавайте расширенные возможности поиска и фильтрации без программирования. Создавайте пользовательские запросы и наборы фильтров, выбирайте из множества типов фильтров и стилей отображения и мгновенно показывайте отфильтрованные результаты без перезагрузки страницы.
Фильтруйте контент по категориям, тегам, пользовательским таксономиям, метаполям записей, атрибутам товаров, цене, статусу наличия, рейтингам, датам и многому другому. Отображайте параметры фильтрации с помощью флажков, радиокнопок, выпадающих списков, полей поиска, ползунков диапазонов, навигации от А до Я, выбора дат, рейтингов WooCommerce или переключателя вида на фронтенде.
Используйте визуальный конструктор запросов и конструктор наборов фильтров для создания многоразовых систем фильтрации, а затем отображайте их где угодно с помощью шорткодов, блоков Gutenberg или виджетов Elementor.
✨ Основные функции:
- AJAX-поиск и фильтрация: Мгновенное обновление результатов без перезагрузки страницы.
- Визуальный конструктор запросов: Создавайте пользовательские запросы для записей, страниц, пользовательских типов записей и товаров.
- Конструктор наборов фильтров: Комбинируйте несколько фильтров и подключайте их к многоразовому запросу.
- Множество типов фильтров: Флажок, радиокнопка, выпадающий список, поиск, диапазон, А-Я, выбор даты, рейтинг Woo и переключатель вида.
- Фильтрация по таксономиям и метаполям: Фильтрация контента с использованием категорий, тегов, пользовательских таксономий, настраиваемых полей и метаданных записей.
- Фильтры товаров WooCommerce: Фильтрация товаров по атрибутам, цене, статусу наличия и звездным рейтингам.
- Множество стилей отображения: Список, кнопки, цветовые свотчи, графические свотчи и вкладки для поддерживаемых фильтров.
- AJAX-пагинация: Выбирайте нумерованную пагинацию, «Загрузить еще», бесконечную прокрутку или их отсутствие.
- Стили загрузчика AJAX: Выбирайте спиннер, оверлей, скелетон или отсутствие загрузчика для вывода результатов.
- Переключатель вида на фронтенде: Позволяет посетителям переключаться между доступными макетами колонок сетки.
- Ссылки на отфильтрованные результаты: Делитесь отфильтрованными результатами и добавляйте их в закладки с сохранением выбранных значений в URL.
- Счетчик результатов: Отображение количества подходящих результатов с помощью специального шорткода.
- Пользовательские карточки результатов: Выбирайте из предопределенных стилей карточек или создавайте собственные шаблоны.
- Адаптивные макеты сетки: Управление колонками для десктопа, планшета и мобильных устройств.
- Поддержка Elementor: Специализированные виджеты фильтра, сетки и пагинации.
- Поддержка Gutenberg: Встроенные блоки для фильтра, сетки и пагинации.
- Поддержка шорткодов: Легко встраивайте фильтры, сетки, пагинацию и счетчики результатов в любое место.
- Кеширование запросов: Опциональное кеширование с использованием транзиентов WordPress для более быстрого выполнения повторяющихся запросов.
- Темный режим: Чистая и современная панель администратора на базе React с поддержкой темного режима.
- Не требуется программирование: Создавайте запросы и фильтры прямо из панели администратора WordPress.
🔎 Типы фильтров:
- Флажок (Checkbox): Выбор одного или нескольких вариантов.
- Радиокнопка (Radio): Выбор одного варианта.
- Выпадающий список (Dropdown): Выбор значений фильтра из выпадающего списка.
- Поиск (Search): Поиск и фильтрация контента с использованием ключевых слов.
- Диапазон (Range): Создание числовых фильтров диапазона, таких как ценовые диапазоны.
- От А до Я (A Z): Просмотр контента в алфавитном порядке.
- Выбор даты (Date Picker): Фильтрация контента по диапазонам дат публикации.
- Рейтинг Woo: Фильтрация товаров WooCommerce по звездному рейтингу.
- Переключатель вида (View Switcher): Позволяет посетителям переключаться между доступными макетами сетки результатов.
🎨 Стили отображения:
Фильтры типа «Флажок» (Checkbox) и «Переключатель» (Radio) могут использовать несколько стилей отображения в зависимости от выбранного источника данных:
- Список
- Кнопки
- Цветовые свотчи
- Графические свотчи
- Вкладки
Цветные и графические образцы (свотчи) могут автоматически использовать данные атрибутов WooCommerce, если они доступны, с вариантами резервного копирования, если данные свотчей не настроены.
📄 Пагинация и загрузка:
Выберите, как отображаются и загружаются отфильтрованные результаты:
- Пагинация (Pagination): Стандартная нумерованная пагинация.
- Загрузить еще (Load More): Загрузка дополнительных результатов без покидания страницы.
- Бесконечная прокрутка (Infinite Scroll): Автоматическая загрузка дополнительных результатов при прокрутке.
- Нет (None): Отображение результатов без элементов управления пагинацией.
Выберите индикатор загрузки AJAX для каждого запроса:
- Спиннер
- Оверлей
- Скелетон
- Нет
🛒 Совместимость с WooCommerce:
Captain Advance Filter работает с WooCommerce и предоставляет специализированные функции фильтрации товаров.
- Рейтинг Woo: Фильтрация товаров по N звездам и выше с использованием рейтингов товаров WooCommerce.
- Ценовой диапазон: Фильтрация товаров с использованием данных о ценах WooCommerce.
- Статус наличия: Фильтрация товаров по доступному статусу наличия на складе.
- Атрибуты товаров: Фильтрация по таким атрибутам, как цвет, бренд, размер и др.
- Цветовые свотчи (Color Swatches): Отображение параметров атрибутов товара в виде цветовых образцов.
- Графические свотчи (Image Swatches): Отображение параметров атрибутов товара с помощью изображений.
- Карточка магазина (Shop Card): Отображение цены товара WooCommerce, значка распродажи и кнопки «В корзину».
- Пользовательские шаблоны товаров: Используйте специальные теги WooCommerce, такие как
{{price}},{{sale_badge}}и{{add_to_cart}}.
🧩 Поддержка пользовательских типов записей:
Используйте Captain Advance Filter с любым общедоступным типом записей WordPress. Создавайте пользовательские запросы и фильтруйте результаты с помощью таксономий, метаполей записей, дат, поисковых запросов и других поддерживаемых источников фильтрации.
🔌 Интеграции с конструкторами:
- Elementor: Специализированные виджеты фильтра, сетки и пагинации с элементами управления стилями Elementor.
- Gutenberg: Встроенные блоки для фильтра, сетки и пагинации.
- Шорткоды: Используйте Captain Advance Filter с любым конструктором страниц WordPress или темой, поддерживающей шорткоды.
- Bricks Builder: Поддержка появится в ближайшее время.
⚡ Производительность:
- Легковесная реализация фронтенда.
- Фильтрация на базе AJAX без полной перезагрузки страницы.
- Фронтенд-ресурсы загружаются только на тех страницах, где используется Captain Advance Filter.
- Отсутствие зависимости от jQuery на фронтенде.
- Опциональное кеширование результатов запросов с использованием транзиентов WordPress.
- Встроенная поддержка ленивой загрузки (lazy loading) для изображений карточек результатов.
🔗 Шорткоды:
[captaf-filter id="1"]: Отображение набора фильтров.[captaf-grid query="query_key"]: Отображение сетки отфильтрованного контента.[captaf-pagination query="query_key"]: Отображение элементов управления пагинацией.[captaf-count query="query_key"]: Отображение количества подходящих результатов.
Вы также можете отображать отдельные фильтры из набора фильтров, используя атрибут only.
Скриншоты





Блоки
Этот плагин предоставляет 3 блока.
- Filter
- Grid
- Pagination
Установка
- Загрузите папку плагина в директорию
/wp-content/plugins/. - Активируйте плагин на экране Плагины в WordPress.
- Откройте Captain Advance Filter в меню администратора WordPress.
- Создайте запрос с помощью конструктора запросов.
- Создайте набор фильтров и подключите его к своему запросу.
- Настройте типы фильтров, стили отображения, пагинацию и параметры загрузчика.
- Добавьте сгенерированный шорткод на свою страницу или используйте интеграцию с Elementor или Gutenberg.
Часто задаваемые вопросы
-
Работает ли Captain Advance Filter без Elementor?
-
Да. Elementor не является обязательным. Вы можете использовать Captain Advance Filter с блоками Gutenberg, шорткодами или любой темой WordPress, поддерживающей шорткоды.
-
Работает ли это с WooCommerce?
-
Да. Captain Advance Filter поддерживает фильтрацию товаров WooCommerce по атрибутам, цене, статусу наличия и рейтингу товаров. Также доступны специфичные для WooCommerce опции карточки магазина и образцов (свотчей).
-
Могу ли я фильтровать произвольные типы записей?
-
Да. Любой общедоступный тип записи WordPress может использоваться в качестве источника запроса.
-
Могу ли я фильтровать по настраиваемым полям или метаполям записей?
-
Да. Фильтры могут использовать поддерживаемые поля метаданных записей в качестве источника данных в дополнение к таксономиям.
-
Поддерживает ли он AJAX-фильтрацию?
-
Да. Отфильтрованные результаты загружаются с помощью AJAX без необходимости полной перезагрузки страницы.
-
Какие варианты пагинации доступны?
-
Вы можете выбрать между нумерованной пагинацией, кнопкой «Загрузить еще», бесконечной прокруткой или полным отсутствием (None).
-
Какие стили загрузчика доступны?
-
Вы можете выбрать спиннер, оверлей, скелетон или отсутствие анимации (None) для загрузки результатов AJAX.
-
Могут ли посетители переключаться между макетами сетки?
-
Да. Добавьте тип фильтра «Переключатель вида», чтобы позволить посетителям переключаться между доступными макетами колонок сетки на фронтенде.
-
Да. Включите опцию «Поделиться URL» для поддерживаемых фильтров, чтобы синхронизировать выбранные значения фильтров с URL страницы. Посетители могут делиться отфильтрованными результатами или добавлять их в закладки.
-
Нужны ли мне знания программирования?
-
Нет. Запросы и наборы фильтров можно создавать с помощью визуальной панели администратора. Шорткоды генерируются автоматически.
-
Замедлит ли Captain Advance Filter мой сайт?
-
Плагин использует условную загрузку ресурсов, поэтому фронтенд-ресурсы загружаются только на тех страницах, где фактически используется Captain Advance Filter. Также доступно опциональное кеширование запросов для улучшения повторных поисков.
-
Безопасны ли фронтенд-эндпоинты REST?
-
Да. Конечные точки фильтрации проверяют, являются ли запрашиваемые типы записей и таксономии общедоступными для просмотра, прежде чем вернуть результаты. Приватные данные через эти конечные точки не раскрываются.
Отзывы
Участники и разработчики
«Captain Advance Filter» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники«Captain Advance Filter» переведён на 9 языков. Благодарим переводчиков за их работу.
Перевести «Captain Advance Filter» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.5.0
- Added: Added a new Step 3 Settings to the Edit Query page for managing card design.
- Added: Added Card Display Options to Step 3 of Settings with Show Title, Description, Author, and Date switches.
- Performance: Admin app no longer re-renders every open page on unrelated state updates.
- Changed: Columns picker moved to the Settings step, shown only when Grid layout is selected.
- Changed: removed the redundant «— Desktop» text next to the Columns device-switcher icon.
- Changed: Gap (px) moved to Settings and is now a 0–100 slider next to the Columns card.
- Changed: List layout and Slider are marked Coming Soon (disabled with a hover hint) on the Select Layout step.
- Fixed: Cached filter results are no longer stale after saving or deleting a query or filter set.
- Fixed: Columns picker on the Settings step now spans full width instead of sitting squeezed in a third of the row.
- Fixed: Layout card background now matches Card Display Options and the rest of the Settings step.
- Fixed: left-column toggle no longer overlaps the right column’s label text in Card Display Options.
- Fixed: stray extra line under the last row of Card Display Options.
- Changed: removed the icons from the Layout and Spacing card headings on the Settings step.
- Removed: Unused admin pages, components, and AJAX handlers left over from earlier development.
1.4.0
- Добавлено: ссылки с фильтрами для синхронизации выбранных фильтров с URL страницы.
- Добавлено: опция «Нет» (None) для пагинации, кнопки «Загрузить еще» и бесконечной прокрутки.
- Добавлено: трехшаговый мастер редактора запросов с автосохранением.
- Добавлено: опции White Label для пользовательского брендинга и управления меню администратора.
- Добавлено: сохранение настроек при деинсталляции и опциональное удаление данных плагина.
- Добавлено: новые руководства по запросам, наборам фильтров, пагинации и кнопке «Загрузить еще».
- Добавлено: новая страница обновления с сравнением Free и Pro, а также автоматическим скрытием промо-баннера Pro.
- Улучшено: макеты редакторов запросов и наборов фильтров, а также элементы адаптивного управления.
- Улучшено: поддержка темного режима во всей панели администратора.
- Улучшено: элементы управления ссылками теперь настраиваются для каждого фильтра в отдельности.
- Улучшено: настройки редактора запросов, дизайн карточек, колонки и элементы управления макетом.
- Улучшено: страницы документации, помощи и наших продуктов.
- Добавлено: поддержка отката для ранее опубликованных версий плагина.
- Изменено: переключатель вида на фронтенде теперь доступен как тип фильтра.
- Исправлено: различные проблемы с админ-интерфейсом, темным режимом, адаптивной версткой, шорткодами и фронтенд-фильтрацией.
1.3.0
- Добавлено: источники данных таксономий и метаполей записей для фильтров.
- Добавлено: фильтрация по ценовому диапазону и статусу наличия для товаров WooCommerce.
- Добавлено: стиль отображения «Вкладки» для фильтров-флажков и радиокнопок.
- Добавлено: поддержка Match Any и All для многофункциональных фильтров с Checkbox и Dropdown.
- Добавлено: поддержка ссылок на отфильтрованные результаты.
- Добавлено: новые страницы помощи и наших продуктов.
- Добавлено: поддержка отката (Roll Back) для ранее опубликованных версий плагина.
- Улучшено: редактор запросов, редактор фильтров, документация, панель управления и интерфейс навигации.
- Улучшено: поддержка темного режима во всей панели администратора.
- Улучшено: адаптивные макеты и элементы управления на фронтенде.
- Исправлено: различные проблемы с фильтрацией, кешированием, интерфейсом, шорткодами и темным режимом.
1.2.0
- Добавлено: фильтр выбора даты.
- Добавлено: фильтр рейтинга Woo для WooCommerce.
- Добавлено: стили отображения «Список», «Кнопки», «Цветовые свотчи» и «Графические свотчи».
- Улучшено: фильтрация товаров WooCommerce и карточки результатов.
- Улучшено: стили темного режима и карточек результатов на фронтенде.
- Улучшено: готовность к переводу в панели администратора и на фронтенде.
- Исправлено: неверное применение значений фильтра диапазона.
- Исправлено: различные проблемы с темным режимом и отображением карточек на фронтенде.
1.1.0
- Добавлено: стили карточек результатов «Классический», «Минималистичный», «Карточка магазина» и «Темный оверлей».
- Добавлено: поддержка цены WooCommerce, значка распродажи и кнопки добавления в корзину.
- Добавлено: токены пользовательских шаблонов карточек.
- Добавлено: шорткоды индивидуальных фильтров с использованием атрибута
only. - Добавлено: адаптивная мобильная навигация для панели администратора.
- Добавлено: обнаружение фронтенд-ресурсов Elementor и Gutenberg.
- Улучшено: готовность к переводу и пользовательский интерфейс администратора.
- Исправлено: различные проблемы с фронтендом, шорткодами и интеграцией.
1.0.0
- Добавлено: типы фильтров «Флажок», «Радиокнопка», «Выпадающий список», «Ползунок диапазона», «Поиск» и «От А до Я».
- Добавлено: пагинация, кнопка «Загрузить еще» и бесконечная прокрутка.
- Добавлено: виджеты Elementor.
- Добавлено: блоки Gutenberg.
- Добавлено: визуальный конструктор запросов.
- Добавлено: конструктор наборов фильтров.
- Добавлено: адаптивные макеты сетки и переключатель колонок.
- Добавлено: AJAX-фильтрация и обновление результатов в реальном времени.
- Добавлено: шорткод количества результатов.
- Добавлено: шорткоды фильтра, сетки, пагинации и счетчика.
- Добавлено: кеширование запросов.
- Добавлено: панель администратора на базе React.
- Добавлено: REST API для фронтенд-фильтрации и управления в административной панели.
- Добавлено: условная загрузка фронтенд-ресурсов.
- Добавлено: усиление безопасности и санизация ввода.
