SEO Filters Pro — руководство пользователя

Что такое SEO Filters Pro

SEO Filters Pro (KosTeams SEO Filters for WooCommerce) — плагин фасетной фильтрации товаров для WooCommerce. У него две стороны работы.

• Фильтры работают через AJAX, без перезагрузки страницы. Выборку и счётчики считает собственный индекс каталога — за 3–4 SQL-запроса, поэтому скорость держится и на больших каталогах.
• Каждая комбинация фильтров получает свой человекопонятный URL с автоматическими Title, Description, H1 и canonical. Такие страницы индексируются Яндексом и Google и собирают трафик по длинному хвосту запросов.

Мета-теги отдаются через API Yoast SEO или Rank Math — плагин сам определяет, какой из них активен. Если SEO-плагина нет, посадочные включаются в нативный sitemap WordPress.

Установка и активация лицензии

• Загрузите ZIP-архив плагина через «Плагины → Добавить новый → Загрузить плагин» и активируйте его. Таблицы индекса и посадочных создаются автоматически.
• Откройте «KosTeams Licenses» в меню админки, введите лицензионный ключ из письма о покупке и нажмите «Активировать».
• Статус лицензии виден в консоли плагина: SEO Filters → Лицензия.

ЛицензияSEO Filters → Лицензия

Лицензия привязывается к домену. При переносе сайта деактивируйте её на старом домене (страница «KosTeams Licenses») и активируйте на новом; если что-то пошло не так — напишите в поддержку, перенесём вручную.

Индексация каталога

За скорость фильтра отвечает собственный индекс: плагин раскладывает товары, вариации, категории, атрибуты, цену, наличие и рейтинг по своим таблицам. Его нужно построить после установки, а затем перестраивать после массовых изменений каталога.

ДашбордSEO Filters → Дашборд

• Перестроить вручную: кнопка «Перестроить индекс» на дашборде консоли. Счётчик рядом показывает, сколько товаров проиндексировано.
• Автообновление: при изменении товара, цены, остатков или терминов индекс обновляется сам. Режим — в Настройки → Движок и индексация: realtime (сразу), scheduled (пачками по расписанию) или manual.
• WP-CLI: на больших каталогах удобнее консоль: wp ksf index run — полная переиндексация, wp ksf index status — состояние, wp ksf index product <id> — один товар.

Вывод фильтра в каталог

Фильтр можно вывести пятью способами — все рисуют одну и ту же панель:

• Автоматически перед списком товаров — опция «Авто-вывод фильтра перед каталогом» в Настройки → Фронтенд (включена по умолчанию).
• Шорткодом [ksf_filters] — в любом месте шаблона или страницы. Старый шорткод [wsf_filter_widget] тоже работает для обратной совместимости.
• Классическим виджетом «KosTeams SEO Filters» — в «Внешний вид → Виджеты», удобно для сайдбара темы.
• Блоком Gutenberg «KosTeams SEO Filters» — в редакторе блоков, категория WooCommerce.
• Виджетом Elementor — появляется в панели Elementor, если конструктор активен.

Панель фильтров выводится на страницах категорий и архивах магазина. На мобильных (по умолчанию — до 768px) фильтры сворачиваются в шторку с кнопкой «Фильтры»; позиция кнопки настраивается (см. раздел 05).

Настройки фронтенда и темы оформления

Всё поведение панели настраивается в SEO Filters → Настройки → Фронтенд.

ФронтендНастройки → Фронтенд

• Тема оформления — светлая, тёмная, минимал, скруглённая и брендовые пресеты. Для своего дизайна положите файл kosteams-seo-filters/filters.css в тему сайта и выберите режим «Своя тема», либо включите «Без стилей» и стилизуйте панель CSS-ом темы. Все цвета и радиусы — CSS-переменные —ksf-*.
• Мобильная шторка — включение, порог ширины экрана (px) и расположение кнопки «Фильтры»: авто, перед списком товаров, после или перед основным блоком.
• Поведение списков — сколько значений видно до кнопки «Показать все», порог появления поиска внутри длинного фильтра, свёрнутость секций по умолчанию.
• Применение фильтров — «Мгновенно» (клик сразу обновляет выдачу) или «По кнопке»: покупатель отмечает несколько значений, а кнопка «Показать N» показывает живой счётчик подходящих товаров.
• Чипы активных фильтров — в сайдбаре, над товарами или выключены; плюс счётчик результатов и спиннер загрузки.

Порядок, видимость и типы фильтров

Раздел Настройки → Фильтры: порядок и раскрытость показывает все фасеты каталога одним списком.

Секции фильтраDrag-n-drop

• Порядок секций меняется перетаскиванием за ручку слева.
• Видимость — чекбокс «показывать»; скрытый фасет не выводится, но продолжает индексироваться.
• Тип отображения для атрибутов: Чекбоксы, Радио, Цвет (плитки-кружки) или Картинка.
• Для типов «Цвет» и «Картинка» задайте значения на терминах атрибута: Товары → Атрибуты → Настроить термины — у каждого термина появляются поля «Цвет (swatch)» и «Картинка (swatch)».
• Подсказки: на странице редактирования атрибута есть поле «Описание для tooltip» — текст показывается покупателю по наведению на заголовок фильтра.
• На уровне категории набор и порядок фасетов можно переопределить: метабокс на странице редактирования категории товара показывает только фасеты, реально существующие в этой категории. Там же настраиваются теги-подборки.

Недоступные при текущем выборе значения не пропадают из панели — они показываются серыми с нулевым счётчиком, чтобы покупатель не терял ориентиры.

Ценовые диапазоны

Фильтр цены показывает поля «от/до» и готовые интервалы со счётчиками. Источник интервалов выбирается в Настройки → Ценовые диапазоны:

• Авто — плагин делит реальный разброс цен категории на равные корзины;
• Ручные — задаёте свои интервалы «от–до» (repeater с кнопкой «Добавить диапазон»);
• По категории — свои интервалы для отдельных категорий.

SEO-шаблоны и плейсхолдеры

Шаблоны в Настройки → SEO-шаблоны применяются ко всем отфильтрованным страницам, у которых нет отдельной сохранённой посадочной. Настраиваются Title, Meta Description, H1 и SEO-текст (визуальный редактор).

SEO-шаблоныНастройки → SEO-шаблоны

Над каждым полем — панель чипов: клик подставляет плейсхолдер в шаблон. Доступны:

• {category}, {brand}, {filters} — категория, бренд и активные фильтры страницы;
• {min_price}, {max_price}, {count} — цены и число товаров в выборке;
• {site_name}, {year} — название сайта и текущий год;
• отдельный чип для каждого атрибута вашего каталога;
• условные блоки {if:плейсхолдер}текст{endif} — фрагмент выводится, только если значение не пустое.

Пример: {category}{if:filters} {filters}{endif} — Купить | {site_name} даст «Электрические радиаторы Слева — Купить | «ТеплоМир»» на странице фильтра и просто «Электрические радиаторы — Купить | «ТеплоМир»» без фильтров.

Генератор посадочных страниц

Генератор (SEO Filters → Генератор URL) массово создаёт посадочные под комбинации «категория × значения атрибутов» — десятки страниц под коммерческие запросы за один запуск.

Генератор URLКатегории × атрибуты

• Категории — отметьте в дереве, для каких категорий создавать посадочные.
• Атрибуты — какие атрибуты комбинировать; глубина комбинаций (1–3 атрибута в одной странице) и лимиты задаются тут же и в «Настройки → Пороги генерации».
• Минимум товаров — комбинации, где товаров меньше порога, не создаются: это защита от тонких страниц и SEO-мусора.
• SEO-шаблоны генератора — свои Title/Description/H1/текст для создаваемых страниц, с теми же чипами-плейсхолдерами.
• Публиковать сразу — иначе посадочные создаются черновиками, и вы публикуете их вручную после проверки.

Кнопка «Предпросмотр» показывает, сколько и каких страниц получится, до запуска. Генерация идёт пачками с прогресс-баром — можно спокойно запускать на большом каталоге.

Посадочные URL: таблица и редактор

Все созданные посадочные живут в SEO Filters → Посадочные URL.

Посадочные URLСтатусы · массовые действия

• Вкладки статусов «Все / Черновик / Опубликован», фильтр по категории, поиск по URL и массовые действия «Опубликовать» / «Удалить».
• Колонка «Товаров» подсвечивает страницы, где товаров стало мало, — их стоит закрыть или удалить.
• Клик по карандашу открывает редактор посадочной: свои Title, Description, H1, «Название тега», SEO-текст, короткий ЧПУ, canonical, robots и настройки sitemap (включение, приоритет, changefreq).

Редактор посадочнойSEO-контент страницы

Опубликованные посадочные автоматически попадают в sitemap (Yoast, Rank Math или нативный WordPress) и могут выводиться тегами-подборками над каталогом — быстрыми ссылками на популярные комбинации фильтров. Видимость и порядок тегов настраиваются в метабоксе категории.

Селекторы темы: AJAX-подмена под любую тему

Чтобы обновлять товары без перезагрузки, плагин должен знать, где в вашей теме находится список товаров, пагинация и заголовок. Эти CSS-селекторы задаются в Настройки → Селекторы темы.

Селекторы темыAJAX-подмена + автоопределение

• Для стандартных тем (Astra, Storefront и т.п.) подходят значения по умолчанию — например, ul.products.
• Для нестандартной темы нажмите «Определить селекторы автоматически»: откроется каталог с оверлеем — кликаете по списку товаров, пагинации и заголовку прямо на живой странице, и поля заполняются сами.

Режимы URL, canonical и редиректы

Раздел Настройки → URL и SEO-маршрутизация управляет тем, как выглядят адреса отфильтрованных страниц:

• Режим URL: плоские ЧПУ вида /category/atribut-znachenie/ (по умолчанию) или с префиксом /filter/.
• Порядок атрибутов в URL задаётся перетаскиванием — у одной комбинации всегда один канонический адрес; альтернативный порядок отдаёт 301 на канонический.
• Порог noindex: страницы, где выбрано больше N групп фильтров, закрываются в robots — защита от комбинаторного взрыва в индексе.
• Короткие ЧПУ посадочных: формат короткого адреса (слитный, по значениям или хеш) — длинные адреса отдают 301 на короткий.
• Кириллица в значениях атрибутов поддерживается, при необходимости — автотранслитерация; адреса в верхнем регистре отдают 301 на нижний.

Кэширование

В Настройки → Кэш (секунды) задаётся время жизни трёх слоёв кэша: результаты фильтрации, счётчики фасетов и конфигурация фильтров. Кэш автоматически сбрасывается при изменении товаров и настроек.

• На типовом магазине значения по умолчанию менять не нужно.
• Если каталог обновляется редко, увеличьте TTL — фильтр реже пересчитывает выборку.
• Плагин совместим со страницами-кэшерами (WP Rocket, LiteSpeed Cache): AJAX-запросы фильтра идут мимо страничного кэша.

Диагностика и частые вопросы

Фильтры не показывают значения (пустые секции). Проверьте по порядку: 1) активирована ли лицензия (SEO Filters → Лицензия); 2) построен ли индекс (Дашборд → «Проиндексировано товаров» больше нуля, иначе — «Перестроить индекс»); 3) есть ли у товаров категории и атрибуты, по которым строятся фасеты.

Клик по фильтру перезагружает страницу вместо AJAX. Тема использует нестандартный контейнер товаров — настройте селекторы (раздел 11).

Кнопка «Фильтры» не появляется на мобильном. Причина та же — селектор контейнера товаров; либо выберите явную позицию кнопки в «Настройки → Фронтенд → Расположение кнопки «Фильтры»».

Изменил товар, а фильтр показывает старые данные. Подождите TTL кэша или перестройте индекс с дашборда; проверьте режим индексации (realtime / scheduled).

Посадочная отдаёт 404. Пересохраните постоянные ссылки («Настройки → Постоянные ссылки → Сохранить») — WordPress перечитает rewrite-правила.

Мета-теги не подставляются. Убедитесь, что активен Yoast SEO или Rank Math и заполнены SEO-шаблоны (раздел 08).