3. Настройки по вкладкам
Страница настроек состоит из информационных блоков вверху и четырёх вкладок ниже: «Основные», «Расширенные», «Правила сервера» (видна только при способе «Через сервер») и «Внешний кэш (S3), эксперимент». Внизу кнопка «Сохранить»: пока вы её не нажали, ничего не меняется.
Золотое правило. На вкладке «Расширенные» плагин сам пишет: «По умолчанию для большинства сайтов установлены оптимальные значения. Если вы не понимаете значения опций на этой вкладке, значит, они вам пока не нужны». Поэтому для начала достаточно вкладки «Основные».
Условные обозначения в таблицах: База — доступно всем; ⭐ Premium — нужна лицензия Premium (без неё поле неактивно); 📋 — после изменения при способе «Через сервер» нужно заново скопировать правила в сервер (не путать со значком 🔧 «нужен администратор» из других глав) (см. главу 4); 🧹 — после изменения нужно очистить кеш.
«По умолчанию» взято из шаблона страницы настроек 3.4.3 (значение, которое показывается, пока настройки не сохранены).
Информационные блоки вверху страницы
На узком экране (375 px, интерфейс 2.0) блоки на месте, но под меню магазина и списком плагинов; при способе «Через сервер» четыре вкладки не помещаются в ширину, и страница чуть шире экрана (444 px), это ограничение раскладки 3.4.1–3.4.3, не проблема настройки (снимки 3.4.3):
| Блок | Что показывает | Где подробно |
|---|---|---|
| Состояние (голубая плашка с заголовком вроде «Кеш выключен» или «Работает через маршрутизацию») | Одно из состояний, способ подключения, дату последней «Проверки кеша» и один «Следующий шаг» с кнопкой | Глава 5 |
| Как включить кеш | Пошаговая подсказка А (роутинг) и Б (сервер). Только переключает два поля вкладки «Основные» и ничего не сохраняет | Быстрый старт |
| Обслуживание (cron) | Какую команду добавить в cron, когда она запускалась в последний раз, что будет без неё | Глава 6 |
| После обновления плагина (с 3.1.7 или более старой версии) | Свёрнутый список действий после обновления | Глава 8 |
| Сводка | Кеш-версия, количество страниц в кеше, путь сохранения, стратегия, веб-сервер, подключение | — |
| Необязательно: полная очистка кеша по расписанию (CRON) | Команда SupercachePluginCacheDel, которая очищает весь кеш при каждом запуске. Это не обслуживание |
Глава 6 |
| Блок «Состояние SuperCache» (Diagnostics Lite) | Таблица состояния: движок, папки, диск, очередь; кнопка «Измерить диск сейчас» | Глава 5 |
| Проверка конфигурации | Список проверок настроек и файлов плагина с подсказками | Глава 5 |
| Проверка кеша | Проверка одной страницы: MISS, затем HIT | Глава 5 |
| Очистить одну страницу | Удаление кеша одной страницы по адресу | Глава 6 |
| Обход кеша для администратора | Просмотр витрины без кеша на 5–60 минут | Ниже |
В правой колонке есть блок «Нужна помощь?» со ссылками «Как начать пользоваться?», «Посмотреть FAQ», «Документация» (в том числе подробная инструкция по динамическим блокам) и «Отключение плагина».
Вкладка «Основные»
Пример (снимок 3.4.3; выбран способ «Через сервер», стратегия «Раздельная»):
Группа «Основные настройки»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Включить кеширование | Главный выключатель. Плагин создаёт и отдаёт готовые страницы | Включить после выбора способа подключения; снять, чтобы остановить кеш | Выключено (на новой установке) | База |
| Очистить кеш | Если отметить и сохранить, кеш будет удалён. Что именно удалится, подсказка показывает под галочкой: «Весь кеш будет удалён при сохранении» либо список типов страниц (см. «Как удалять кеш») | После смены настроек, помеченных 🧹; после ручной правки темы | Не отмечено | База |
| Как подключить кеш | «Через роутинг» (то же, что «Через маршрутизацию») или «Через сервер (самый быстрый вариант)» | Начните с роутинга; на сервер переходите по главе 4 | Не выбрано | База |
Группа «Дополнительные настройки»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Стратегия кеширования | «Общая»: одна копия для всех устройств. «Раздельная»: две копии, для компьютеров и для телефонов. «Только десктоп» / «Только мобильные»: кеш только для одного вида устройств, второй всегда собирается заново | «Раздельная» — если у темы разная вёрстка для телефона или она адаптивная (плагин рекомендует её для большинства сайтов). «Общая» — только если страницы для всех устройств одинаковы. Планшеты (iPad) Webasyst считает компьютерами | «Общая» | База 📋 🧹 |
| Локализация | Для какого языка сохранять кеш: «Любая локализация» или один конкретный язык | Если магазин многоязычный и язык переключается на том же адресе (cookie), выберите один язык: для остальных страницы будут собираться заново. Если языки на разных адресах (/en/), оставьте «Любая локализация» |
«Любая локализация» | База 📋 🧹 |
Под полем при способе «Через сервер» показано предупреждение: «Если вы измените эту опцию, вам необходимо очистить кеш, заново сконфигурировать правила сервера и установить их в файле конфигурации сервера».
Вкладка «Расширенные»
Вид вкладки без Premium (снимки 3.4.3; серые поля Premium неактивны). Три фрагмента подряд:
Группа «Управление кешем»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Не кешировать авторизованных пользователей | Для вошедших покупателей и сотрудников страницы строятся заново и в кеш не попадают. По коду плагина это правило действует всегда, независимо от галочки (она оставлена для совместимости) | Не снимайте: это безопасное значение («рекомендуется») | Отмечено | База |
| Поисковые роботы, AI-роботы, SEO-сканеры, Прочие роботы и утилиты | Для каждой категории роботов: «Отдавать из кеша и создавать кеш»; «Отдавать только готовый кеш, не создавать его»; «Не использовать кеш». Робот определяется по User-Agent из списка известных роботов плагина; любой незнакомый User-Agent считается обычным посетителем | Если не хотите, чтобы робот «прогревал» кеш (создавал много страниц) — оставьте «Только готовый кеш». «Не использовать кеш» нагружает сервер при активном обходе | «Отдавать только готовый кеш, не создавать его» для новой установки; у обновившегося магазина — как было в 3.1.7 | База 📋 |
| Удаление кешированных страниц после оформления заказа | После заказа удаляет кеш страниц заказанных товаров и их категорий, чтобы остатки были актуальны | Включайте, если остатки на странице важны; плагин предупреждает, что на большом каталоге это добавляет запросы к базе и может замедлить оформление. После включения оформите тестовый заказ | Выключено | База |
| Удаление кеша после редактирования товара | После сохранения товара в админке удаляются кешированные страницы этого товара и его категорий | Оставьте включённым | Включено | База |
| Удаление кешированных страниц после добавления комментария | После нового отзыва очищается кеш страницы этого товара (основной адрес, адрес с категорией, страница отзывов, все устройства). Списки категорий и главная показывают новый рейтинг после собственной пересборки | Оставьте включённым | Включено | База |
Группа «Разное»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Включить кеширование Server Worker | Дополнительное кеширование в браузере покупателя (через Service Worker) | Только если понимаете, зачем. Если на витрине включено приложение «PWA», его Service Worker занимает место, и worker SuperCache там не регистрируется: опция на таких страницах не действует. Service Worker работает только по HTTPS | Выключено | База |
Группа «Параметры URL»
Вариант «Сохранять кеш с определёнными query string» открывает поле списка (в нём по умолчанию пять меток). Снимок сделан на тестовом стенде с заглушкой лицензии: он показывает вид интерфейса, а не работу с настоящей лицензией Premium.
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Как работать с query string | Что делать с адресами, где после «?» есть параметры (?color=red, ?utm_source=...). «Не сохранять кеш с query string URL»; «Сохранять кеш с любыми query string»; «Сохранять кеш с определёнными query string» |
Оставьте первый вариант. «С любыми» опасен: у всех адресов с одним путём будет одна общая копия независимо от параметров, поэтому страницы с фильтрами и сортировкой могут показать чужое содержимое. «С определёнными» нужен, чтобы рекламные метки (UTM) не мешали кешу | «Не сохранять кеш с query string URL» | «Любые» — База; «Определённые» — ⭐ в интерфейсе помечено «Только для премиум-версии плагина» (отдельного запрета в коде не найдено, см. главу 9) 📋 🧹 |
| Список разрешённых query string (появляется при «Определённых») | Имена параметров, по одному на строку. Адрес кешируется, только если содержит хотя бы один из них | Добавьте метки вашей рекламы | utm_source, gclid, yclid, ymclid, fbclid |
⭐ 📋 🧹 |
При включённом Metadata v2 кеширование со строкой запроса требует строгого профиля правил сервера (вкладка «Правила сервера»).
Группа «Размер кеша»
Поля размера кеша с включённым ограничением. Снимок сделан на тестовом стенде с заглушкой лицензии: он показывает вид интерфейса, а не работу с настоящей лицензией Premium.
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Резерв свободного места на диске (МБ) | Пока на диске свободного места меньше этого числа, новые страницы не записываются в кеш; магазин продолжает работать. Измеряется заданием cron; без свежего замера запись не приостанавливается. 0 выключает | Если хостинг даёт мало места; ставьте значение больше обычного запаса | 50 | База |
| Включить вычисление размера кеша | Считает, сколько места занимает кеш (нужен cron). Основа лимита | Если нужен лимит размера | Выключено | ⭐ |
| Включить ограничение кеша (появляется после предыдущей) | Включает лимит размера | — | Выключено | ⭐ |
| Ограничение размера кеша + МБ/ГБ | Максимальный размер | Исходя из свободного места | 0 | ⭐ |
| Что делать, когда вы достигли предела кеша | «Не создавать больше кеша»; «Удалить кеш»; «Постепенно удалять самые старые страницы» (только с Metadata v2: удаляются самые старые страницы товаров, затем категорий, пока кеш не займёт 90 % предела; главная не удаляется; без Metadata v2 действует как «Не создавать больше кеша») | «Не создавать» — самое безопасное | «Не создавать больше кеша» | ⭐ |
Важно про лимит: он работает только по замеру, который делает cron-задание плагина. Без cron, или пока замер старый, лимит не применяется; кеш при этом продолжает работать. Кнопка «Измерить диск сейчас» в блоке «Состояние SuperCache» делает одну порцию замера немедленно.
Группа «Исключения кеширования»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Исключения по URL (regexp) | Список фрагментов адреса, по одному на строку. Если фрагмент встречается где угодно в полном адресе страницы (без учёта регистра), страница не кешируется. Несмотря на название и подсказку интерфейса, регулярные выражения по коду не работают: каждая строка сравнивается как обычный текст | Добавьте фрагмент адреса страниц с личным или быстро меняющимся содержимым, например /special/. Не используйте \/ и другие спецсимволы |
Служебные значения (путь админки, order\/, orders\/, signup\/, my\/); сами личные страницы защищены отдельным жёстким правилом, а не этим списком |
База |
| Исключения по URL (string) | То же, но адреса пишутся полностью, с http(s):// и доменом, и совпадать должны точно. Без регулярных выражений |
Если не хотите возиться с регулярными выражениями | Пусто | База |
| Исключить карточки товаров, категории, домашнюю страницу, страницу корзины, просмотр заказа в личном кабинете, список заказов, сравнение товаров, результаты поиска | Не кешировать страницы выбранного типа целиком | Если страницы такого типа показывают личное или быстро меняющееся содержимое. Корзина, оформление заказа и личный кабинет не кешируются и без этих галочек | Не отмечено | ⭐ (без Premium поля неактивны и не действуют) |
Совет: надёжнее всего поле «Исключения по URL (string)»: впишите адрес целиком, например https://shop.example/catalog/specials/. В поле (regexp) пишите простой фрагмент без спецсимволов. ⚠️ Подсказка интерфейса («разрешены регулярные выражения») расходится с кодом; проверьте нужное исключение «Проверкой кеша».
Группа «Настройки удаления кеша»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Как удалять кеш | «Полностью удалить кеш» — любая очистка удаляет всё. «Частично удалить кеш» — удаляются только отмеченные типы страниц (товары, категории, главная, корзина, заказы, сравнение, поиск) | Если после правок нужно сохранить часть кеша. При Metadata v2 частичная очистка не предлагается: очищается весь кеш | «Полностью удалить кеш» | «Частично» — ⭐ |
| Удалить карточки товаров и другие флажки типов | Какие типы удалять при частичной очистке (видны только при «Частично») | — | Не отмечено | ⭐ |
Группа «Минификация файлов»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Сжатие в gzip | Кроме обычной копии страницы хранится сжатая (.gz): браузерам, умеющим gzip, отдаётся меньше данных | Если сервер поддерживает gzip (плагин даёт ссылки на онлайн-проверку) | Выключено | База 📋 🧹 |
| HTML минификация | Библиотека, убирающая лишние пробелы из HTML (в списке указаны ориентировочные доли экономии). Страница в кеше может отображаться иначе при плохой совместимости | Только после проверки: смените, очистите кеш и просмотрите кешированные страницы | «—» (выключено) | База 🧹 |
Группа «Отображение кеша»
Динамические блоки включены. Снимок сделан на тестовом стенде с заглушкой лицензии: он показывает вид интерфейса, а не работу с настоящей лицензией Premium.
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Активировать динамические блоки | Часть страницы (например, блок «вы смотрели» или число товаров в корзине) подгружается отдельным запросом, поэтому остаётся «живой» на закешированной странице | Если один изменяющийся фрагмент вынуждает вас отключать кеш для всей страницы. Нужна правка шаблона темы и блока в «Сайт → Блоки» (подробно: «Документация» в правой колонке). Нужен JavaScript у покупателя | Выключено | ⭐ 🧹 |
| Добавить анимацию блока (при включённых блоках) | Плавное появление блока | Для плавности | Выключено | ⭐ 🧹 |
| Активировать условный рендеринг | Фрагмент страницы показывается, только если соответствующий динамический блок вернул данные | Продвинутая настройка | Выключено | ⭐ 🧹 |
Группа «Интеграция с плагинами»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Адаптивные изображения PRO | Защита от показа посетителю страницы, собранной под экран другого посетителя. Включает отдельную логику для плагина «Адаптивные изображения PRO». Снижает долю попаданий в кеш | Обязательно включите, если этот плагин установлен у вас на витрине. После включения: сохранить, переустановить правила сервера 📋 и один раз очистить кеш | Выключено; сама не включается | База 📋 🧹 |
| Автоматическое определение и выбор города | Совместимость с плагином «Автоопределение и выбор города»: посетитель, выбравший город, получает страницы без общего кеша (cookie supercache=no_cache) |
Если плагин установлен | Выключено | База |
| Критический CSS | Совместимость с плагином «Критический CSS» | Если плагин установлен | Выключено | База |
| Переподключить JS-запросы к серверу для поддоменов | Исправляет ошибки при работе с плагином «SEO регионы» на поддоменах | Если у сайта есть поддомены и такой плагин | Выключено | База |
Эти опции описывают только связь с чужими плагинами. Работу с конкретными версиями чужих плагинов на реальных магазинах мы не проверяли (⚠️ не проверено).
Группа «Интеграция с темами дизайна»
| Поле | Что делает | Когда менять | По умолчанию | Редакция |
|---|---|---|---|---|
| Отключать кеш при обновлении страницы | Если посетитель несколько раз подряд перезагрузил страницу, она отдаётся без кеша | Рекомендуется для тем, которые при обновлении страницы подключают другую версию сайта (в подсказке названы «MegaShop 2.0» и «Ahead») | Выключено | База 🧹 |
Вкладка «Правила сервера»
Видна, только когда выбран способ «Через сервер». Подробно: глава 4.
| Поле | Что делает | По умолчанию |
|---|---|---|
| Профиль правил сервера | «Прежний (как в версии 3.1.8)» или «Строгий». Строгий нужен для Metadata v2; он отдаёт страницу напрямую только на запросы GET и HEAD, при непустом файле и при разрешённых параметрах. Без движка Metadata v2 строгие правила страниц не отдают | «Прежний» 📋 |
| Диагностический заголовок X-Supercache | «Выключен», «Включен», «Отладка (с причиной обхода кеша)». Добавляет в ответы магазина заголовок X-Supercache: HIT / MISS / BYPASS. Расшифровка: глава 5 |
«Выключен» 📋 |
| Сконфигурировать правила сервера | Если отмечено при сохранении, правила создаются заново. После сохранения галочка снимается сама, поэтому чтобы получить правила для изменённых настроек, отметьте её и нажмите «Сохранить» снова. Сам текст правил показан ниже, его нужно скопировать вручную | Отмечено на первом сохранении |
Вкладка (снимок 3.4.3, Apache, строгий профиль не выбран; полный текст правил в 3.4.3 зависит от настроек):
Вкладка «Внешний кэш (S3), эксперимент»
Экспериментальная функция, выключена по умолчанию, обычному владельцу магазина не нужна и не рекомендуется. Подробности и риски: глава 7.
Обход кеша для администратора
Блок «Обход кеша для администратора: просмотр витрины без кеша». Позволяет вам, администратору, на 5, 15, 30 или 60 минут смотреть витрину так, как её строит магазин, без кеша. Ничего, что вы открыли таким способом, в кеш не записывается. Посетители включить это не могут.
- Включение: «Разрешить обход кеша для администратора» → «Сохранить» → кнопка «Открыть витрину без кеша» (выберите время). «Выключить обход» стирает cookie в вашем браузере; «Отозвать у всех» делает недействительными все выданные cookie.
- Cookie ставится для адреса, на котором открыта страница настроек. На витринах других доменов обход не работает.
- При способе «Через сервер» после включения нужно обновить правила (📋): иначе веб-сервер продолжит отдавать вам файл из кеша напрямую. Плагин покажет предупреждение.
- По умолчанию выключено. База.
Снимки 3.4.3: до включения; после включения (кнопки и выбор времени); после нажатия «Открыть витрину без кеша» (под кнопками показан адрес, который открылся в новой вкладке).
Красное предупреждение «Ранее сохранённые правила сервера не знают cookie обхода…» показывается после включения опции и в режиме «Через роутинг». Для роутинга правил сервера нет, поэтому там оно ни на что не влияет; при способе «Через сервер» его нужно выполнить.