01 О плагине

SEO AI for WooCommerce — это плагин для WordPress, который автоматически генерирует и управляет сворачиваемыми (toggle/collapse) SEO-описаниями для категорий, товаров и произвольных таксономий WooCommerce. Описания формируются по шаблонам с динамическими переменными — название категории, количество товаров, диапазон цен и т.д.

Плагин решает типичную SEO-задачу: наполнение страниц каталога уникальным текстовым контентом без ручного написания сотен описаний.

Free vs PRO

02 Требования и совместимость

Минимальные версии

Протестированные темы

• Storefront, Astra, OceanWP, Flavor, Flavflavor
• Kadence, GeneratePress, Flavor
• Большинство тем, использующих стандартные WooCommerce-хуки

Конструкторы страниц

• Elementor + Elementor Pro
• WPBakery Page Builder
• Gutenberg (нативная поддержка)
• Beaver Builder, Divi — через шорткод

AJAX и бесконечная прокрутка

Плагин корректно работает с AJAX-фильтрацией и бесконечной прокруткой товаров. Контент toggle вставляется до списка товаров и не зависит от AJAX-обновлений.

Мультиязычность

Совместим с WPML и Polylang. Шаблоны можно задать для каждого языка отдельно через настройки плагина или через переопределение на уровне категории.

03 Установка

Free через панель WordPress

Free через ZIP / FTP

PRO установка

Типичные ошибки при активации

04 Быстрый старт

Free: настройка за 2 минуты Free

PRO: расширенная настройка за 5 минут PRO

После активации лицензии доступны расширенные шаблоны. Пример шаблона с условной логикой:

<h2>Каталог {category_name}</h2>
<p>В разделе «{category_name}» представлено {products_count} товаров
по цене от {min_price} до {max_price} руб.</p>

{if products_count > 50}
<p>Большой ассортимент — воспользуйтесь фильтрами!</p>
{else}
<p>Просмотрите все товары ниже.</p>
{endif}

05 Настройки бесплатной версии Free

Доступные переменные

Пример: шаблон → вывод

Каталог «{category_name}»: {products_count} товаров от {min_price} ₽

Каталог «Кроссовки Nike»: 142 товара от 2 990 ₽

Настройки collapse-виджета

• Текст кнопки «Развернуть» — по умолчанию «Подробнее»
• Текст кнопки «Свернуть» — по умолчанию «Свернуть»
• Начальное состояние — свёрнуто / развёрнуто
• Высота превью — количество пикселей видимого текста (по умолчанию 120px)
• Анимация — плавное раскрытие (CSS transition)
• Позиция вставки — до товаров, после товаров, через шорткод
• Градиент затухания — включить/выключить fade-эффект внизу свёрнутого блока

06 Функции PRO PRO

Массовое применение шаблонов (Bulk Apply)

Применяйте один шаблон ко всем категориям одним кликом. Выберите шаблон, выберите категории (или «Все»), нажмите «Применить». Описания будут сгенерированы автоматически на основе данных каждой категории.

Откат (Rollback)

Перед каждым массовым применением PRO-версия сохраняет резервную копию всех описаний. Если результат не устроил — откатите к предыдущей версии в один клик.

Шаблоны для товаров

Кроме категорий, PRO позволяет создавать toggle-описания для отдельных товаров. Дополнительные переменные:

Кастомизация кнопки

• Произвольный текст для «Развернуть» / «Свернуть»
• Выбор иконки (стрелка, плюс, шеврон или без иконки)
• Положение иконки (слева / справа от текста)
• Цвет фона и текста кнопки
• Размер и радиус скругления
• Класс CSS для полной кастомизации через тему

07 Шорткоды

Шорткод [scs_toggle] позволяет вставить collapse-блок в любое место — страницу, запись, виджет или конструктор.

Синтаксис

[scs_toggle title="Заголовок" open="false" height="120"]
  Содержимое toggle-блока. HTML поддерживается.
[/scs_toggle]

Параметры

Пример с параметрами

[scs_toggle title="О нашем магазине" open="false" height="80" more_text="Читать далее" less_text="Скрыть"]
  <p>Мы работаем с 2015 года и предлагаем ...</p>
[/scs_toggle]

08 Gutenberg-блок SCS Toggle PRO

PRO-версия добавляет нативный Gutenberg-блок «SCS Toggle», который можно использовать в редакторе блоков WordPress.

Преимущества блока

• Визуальное редактирование содержимого прямо в редакторе
• Предпросмотр toggle в реальном времени
• Все параметры доступны через боковую панель настроек
• Поддержка вложенных блоков (изображения, списки, таблицы)
• Drag-and-drop позиционирование на странице
• Совместимость с Full Site Editing (FSE)

09 Условная логика PRO

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

Синтаксис

{if переменная оператор значение}
  Контент, если условие истинно
{else}
  Контент, если условие ложно
{endif}

Поддерживаемые операторы

Пример для маркетплейса

{if products_count > 200}
<div class="large-catalog-notice">
  🔥 В разделе «{category_name}» более {products_count} товаров!
  Используйте фильтры для быстрого поиска.
</div>
{endif}

{if min_price < 500}
<p>💰 Бюджетные варианты от {min_price} ₽</p>
{endif}

{if parent_category != ""}
<p>Подкатегория раздела «{parent_category}»</p>
{else}
<p>Корневая категория каталога.</p>
{endif}

10 Аналитика PRO

PRO-версия включает встроенную аналитику и интеграцию с Google Analytics 4 (GA4) и Google Tag Manager (GTM).

Встроенная аналитика

• Подсчёт кликов на кнопку «Развернуть» по каждой категории/товару
• Таблица статистики в админ-панели с сортировкой и фильтрацией
• График кликов за период (7/30/90 дней)
• Экспорт данных в CSV

GA4 события

При клике на toggle плагин отправляет кастомное событие в GA4:

gtag('event', 'scs_toggle_click', {
  event_category: 'engagement',
  event_label: 'Кроссовки Nike',
  toggle_state: 'open'
});

GTM события

Для GTM плагин пушит данные в dataLayer:

dataLayer.push({
  event: 'scs_toggle',
  scs_action: 'open',
  scs_target: 'category-krossovki-nike'
});

11 Настройки на элемент PRO

PRO-версия позволяет переопределить глобальные настройки для конкретной категории или товара.

На уровне категории

• Собственный шаблон описания (вместо глобального)
• Своя высота превью
• Своя кнопка (текст, цвет, иконка)
• Отключение toggle для конкретной категории

На уровне товара

• Индивидуальное toggle-описание
• Переопределение позиции вставки
• Выбор: использовать шаблон или ручной текст

12 Таксономии PRO

Помимо стандартных категорий WooCommerce, PRO-версия поддерживает произвольные таксономии:

• product_cat — категории товаров (по умолчанию)
• product_tag — теги товаров
• pa_* — атрибуты WooCommerce (цвет, размер и т.д.)
• Произвольные таксономии — бренды, коллекции и любые кастомные таксономии, зарегистрированные плагинами или темой

13 FAQ

14 Решение проблем

Collapse не работает / кнопка не нажимается

Переменные не подставляются

• Убедитесь, что используете фигурные скобки: {category_name}, а не квадратные.
• Проверьте правильность написания переменной (регистр имеет значение).
• Переменные работают только на страницах WooCommerce (архивы, категории, товары).

Условная логика не работает

• Убедитесь, что используется PRO-версия с активной лицензией.
• Проверьте синтаксис: {if переменная оператор значение} — пробелы обязательны.
• Нельзя вкладывать {if} друг в друга (вложенные условия не поддерживаются).

Проблемы с лицензией

• «Ключ недействителен» — проверьте ключ в личном кабинете, скопируйте заново.
• «Превышено количество активаций» — деактивируйте лицензию на старом домене через личный кабинет.
• «Не удалось связаться с сервером» — проверьте доступность API сервера лицензий, убедитесь что хостинг не блокирует исходящие запросы.

GA4 события не отправляются

• Убедитесь, что GA4 tracking code загружен до скриптов плагина.
• Проверьте в DevTools → Network вкладке, что запросы к google-analytics.com отправляются.
• Если используете GTM — проверьте, что контейнер GTM загружен и переменная dataLayer определена.

Поиск конфликтов

15 Поддержка

Нужна помощь? Выберите удобный канал связи:

Что включить в запрос

• Версию WordPress, WooCommerce и плагина SCS Toggle
• Версию PHP (Инструменты → Здоровье сайта → Информация)
• Скриншот или видео проблемы
• Ошибки из DevTools Console (F12 → Console)
• Список активных плагинов
• URL страницы, где проявляется проблема