Здесь описано каждое поле страницы настроек в том порядке, в каком оно показано. Страница состоит из верхней серой панели и четырёх вкладок: «Настройки», «Функции», «Хранилище», «Диагностика» (она описана в разделе 11).
Значения «по умолчанию» относятся к новой установке. После обновления с 3.3.0 остаются ваши прежние значения. Настройки хранятся отдельно для каждой витрины (см. раздел 7). Внизу страницы — кнопка «Сохранить»: изменения вступают в силу только после неё.
Содержание: верхняя панель · основные · дополнительные · совместимость с темами · прочее · производительность · функции · хранилище
Верхняя панель
| Поле |
Что делает |
| Область настроек |
Показывает, чьи настройки вы сейчас правите: «Все витрины» или адрес конкретной витрины |
| Удалить все изображения → кнопка «Удалить все созданные изображения» |
Удаляет все созданные плагином копии и очищает записи в базе для выбранной витрины (а при «Все витрины» — для всех витрин). Удаляются только файлы, созданные плагином; оригиналы не затрагиваются; устаревшие копии в S3 тоже удаляются. Показывает ход выполнения. Когда использовать: после смены базовых параметров, если нужно пересоздать копии (например, Retina @2x после обновления), или перед удалением плагина. Файлы общие для витрин: удаляя у одной витрины, учтите, что другие используют те же файлы |
| Статистика изображений |
«Обработано» — число исходных картинок; «Создано» — файлов на сервере и в облаке. Ссылка «Показать количество файлов» считает общее число файлов (на больших каталогах может занять время) |
| Путь хранения |
Куда складываются копии: папка на сервере или адрес облачного хранилища |
| Витрина |
Какую витрину вы настраиваете. Подробнее — раздел 7 |
Вкладка «Настройки»
Основные настройки
| Поле |
По умолчанию |
Что делает и когда менять |
| Включить плагин |
выключено |
Включает или отключает плагин для витрины. Пока выключен, страницы отдаются без изменений |
Дополнительные настройки
| Поле |
По умолчанию |
Что делает и когда менять |
| Пропускать изображения шире (px) |
2000 |
Картинки шире этого значения плагин не обрабатывает: они не уменьшаются, а остаются в исходном виде (подпись раньше называлась «Максимальная ширина»). Поднимайте, если у вас фото шире 2000 px и вы хотите их обработать. Кроме того, независимо от настройки, картинки шире или выше 5000 px, а также больше 25 мегапикселей, пропускаются (запись остаётся в журнале wa-log/responsiveimages/skip_large.log) |
| Движок обработки изображений |
GD |
GD или Imagick. Выберите ту библиотеку, которая есть на сервере. Imagick нужен, если GD не поддерживает нужный формат (например, AVIF). Если выбрать библиотеку, которой на сервере нет, плагин не сохранит настройки |
Совместимость с темами дизайна
| Поле |
По умолчанию |
Что делает и когда менять |
| Взаимодействие с атрибутом «srcset» |
Игнорировать |
Что делать, если у img темы уже есть srcset. Удалить — убрать srcset и sizes, оставить то, что подставит плагин. Заменить — заменить на адаптивную копию. Игнорировать — не трогать srcset темы. Добавить (если отсутствует) — добавить srcset, если у тега его нет. Заменять и добавлять srcset плагин может, если включены адаптивные изображения (Премиум) |
| Отключить retina.js |
выключено (скрипт подключается) |
Плагин подключает скрипт retina.js, но только если включены копии высокого разрешения. Отключите, если retina.js уже есть в вашей теме |
| Интеграция со сторонними Lazyload-решениями |
выключено |
Включите, если тема уже использует ленивую загрузку картинок. Плагин «Lazyload» из каталога Webasyst сторонним не считается (в подсказке плагина он назван отдельно) |
| Отслеживать изменения атрибута src |
выключено |
При смене src (например, в галерее товара) srcset обновляется автоматически. Включите, если, например, галерея изображений перестала переключаться. Если установлен плагин Lazyload с той же функцией, переключатель недоступен |
| Обрабатываемый тег |
img |
Какой тег плагин ищет на странице. Менять почти никогда не нужно |
| HTML-атрибут для увеличенных изображений |
data-rjs |
Имя атрибута, в который записывается ссылка на увеличенную (2x, 3x) картинку для retina.js. Менять только если вашей теме нужно другое имя |
| Создать копию изображения в 2x |
выключено |
Создаёт увеличенную копию 2x. Нужно, только если скрипты вашей темы сами добавляют @2x к имени файла. Если опция выключена, Retina-картинка темы обычным файлом не заменяется |
| Версия в именах файлов |
Вкл |
Новые файлы получают короткую версию оригинала в имени (например, photo-adaptive-343w-v3fa9c21b.jpg). При замене оригинала адрес копии меняется, и браузер, CDN и кеш страниц не покажут старую картинку. Выключайте только если вашей системе кеширования нужны неизменные имена. Подробнее — раздел 9 |
| Проверять оригинал на странице |
Вкл |
При каждом просмотре для каждой картинки выполняется один системный вызов: проверка, не заменили ли оригинал. Пока новых копий нет, показывается оригинал. Выключайте только на очень медленных сетевых файловых системах; тогда страница, которую никто не открывает в браузере, может ссылаться на уже удалённый старый файл |
| Хранить старые файлы, дней |
30 (допустимо 7–365) |
Сколько хранить заменённые копии, чтобы страницы из кеша не получили ошибку 404. Затем файл удаляет команда sweep или фоновый запуск. Без cron и без sweep старые файлы не удаляются. При нехватке места на диске удаляются раньше срока, старые первыми. На бакете S3 не ставьте правило удаления по возрасту. Правила nginx/Apache, чтобы браузеры кешировали версионные файлы год, описаны в истории изменений плагина (раздел 4.0; подсказка в поле на них ссылается); для S3 плагин отправляет Cache-Control сам |
| Размеры миниатюр |
пусто |
Список размеров (px) миниатюр, которые нужно создавать. Нужно, если тема загружает миниатюры определённых размеров и без них картинки не показываются. Добавьте нужные размеры кнопкой «Добавить размер» |
Прочее
| Поле |
По умолчанию |
Что делает и когда менять |
| Исключить URL-адреса (regexp) |
пусто |
Страницы, где плагин не должен работать. Каждая строка — регулярное выражение, которое проверяется по полному адресу страницы (с https://); достаточно совпадения с любой частью адреса. Косую черту / пишите с обратной чертой: \/cart\/ исключит страницы корзины |
| Исключить URL-адреса (string) |
пусто |
Список адресов, по одному в строке, в точности совпадающих с адресом в браузере (с https://, со строкой запроса, если она есть) |
| Исключить ссылки на изображения (regexp) |
пусто |
Картинки, которые нужно пропустить. Одна строка — одно регулярное выражение, проверяется по адресу картинки в HTML |
| Исключить ссылки на изображения (string) |
пусто |
Ссылки на картинки, точно такие же, как в HTML страницы, по одной в строке |
| Собственный CSS |
пусто |
Ваши стили, которые добавляются в <style> в заголовок страницы. Ссылка «Инструкция» открывает справку о CSS. Пример: если картинки искажаются после обработки, добавьте img[data-responsiveimages-processed] { width: auto; height: auto; } |
| Режим отладки (для разработчиков) |
выключено |
Подробный вывод ошибок и логирование. Не включайте на работающем магазине: могут раскрыться служебные сведения |
Отключить плагин для отдельной картинки можно прямо в HTML: атрибут data-responsiveimages="false" у тега img. Отключить микроданные для картинки: data-responsiveimages-schema="false".
Производительность
| Поле |
По умолчанию |
Что делает и когда менять |
| Максимум URL для обработки |
1 |
Сколько страниц из очереди обрабатывает один запрос посетителя (страница самого посетителя — первой). Больше — выше нагрузка. При ошибках 503 оставьте 1 |
| Лимит изображений на один URL |
30 |
Сколько картинок обрабатывается по одной странице за раз. Помогает ограничить расход памяти |
| Режим обработки |
Smart Hybrid (новая установка) / On-demand (после обновления) |
См. раздел 5: «При просмотре», «Фоновый», Smart Hybrid |
| Переключатель «Приостановить фоновую обработку для этой витрины (очередь сохраняется)» |
выключено |
Виден в режимах «Фоновый» и Smart Hybrid. Пауза для одной витрины; очередь сохраняется |
| Фоновая обработка |
— |
Справочный блок: строка cron, время последнего запуска (в часовом поясе пользователя Webasyst, как и во вкладке «Диагностика»), предупреждения, ссылки «Состояние очереди» и «Повторить изображения из карантина». Подробнее — раздел 5 |
| Бюджет времени на запрос посетителя (с) |
10 |
См. раздел 5. Скрыто в режиме «Фоновый» |
| Изображений на запрос посетителя |
10 |
То же |
| Макс. размер исходника при просмотре (МП) |
0 |
То же. 0 — без отдельного лимита |
| Включить проверку нагрузки на сервер |
выключено |
Если включено, плагин не создаёт картинки в запросах посетителей, пока нагрузка сервера выше порога ниже. Для фонового запуска используется собственная проверка --max-load |
| Порог загрузки CPU |
1,5 |
Появляется, когда проверка включена. 1,0 — это 100% загрузки одного ядра. Для выделенных серверов можно больше, для общего хостинга — меньше (например, 1,0) |
| Количество ядер процессора |
пусто |
Если пусто, определяется автоматически. Укажите вручную, если определение неверное |
| Максимальное время выполнения задачи (с) |
120 |
Не даёт процессу «зависнуть». 0 — без ограничения. Увеличьте для очень больших пачек или медленных серверов |
| Пауза между задачами (с) |
практически 0 (0,002 с); эти же значения показаны в подсказке поля |
Пауза между страницами из очереди. Помогает снизить нагрузку. На общем хостинге попробуйте 1–2 секунды |
| Пауза между изображениями (с) |
практически 0 (0,0005 с) |
Пауза между картинками. Помогает сгладить пики нагрузки. На общем хостинге 0,5–1 с |
| Пауза между AJAX-запросами при вычислении размера изображения (мс) |
10 |
Для адаптивных изображений (Премиум): страница отправляет серверу запрос на каждую картинку (их может быть 10–30). Увеличьте паузу (максимум 5000 мс), чтобы снизить число запросов |
| PHP Memory limit |
значение сервера |
Лимит памяти PHP для обработки (128M … 2048M). Если вы видите ошибку «Allowed memory size exhausted», картинка слишком велика или нужен больший лимит. Рекомендуется 256M и выше |
Если сервер часто отвечает ошибкой 503 при обработке, ориентируйтесь на значения из справки плагина: «Максимум URL для обработки» — 1, «Лимит изображений на один URL» — 5–10, «Максимальное время выполнения задачи» — 30–60 секунд, паузы между задачами 1–2 с и между изображениями 0,5–1 с, проверка нагрузки включена, порог 1,0–1,5.
Вкладка «Функции»
Вверху вкладки — общее пояснение: плагин создаёт копии, не затрагивая оригиналы; каждая функция увеличивает нагрузку на сервер и время обработки, включайте их осознанно. Пока функция не включена, она ничего не делает. Если выключить плагин, изменения откатываются сами (страницы снова без копий).
Адаптивные изображения (Премиум)
Плагин создаёт несколько копий каждой картинки под разные экраны, браузер сам выбирает подходящую.
| Поле |
По умолчанию |
Что делает |
| Включить адаптивные изображения |
выключено |
Основной переключатель |
| Минимальная ширина (пиксели) |
100 |
Картинки такой ширины и меньше не обрабатываются (значки, логотипы). Рекомендуется 30–50 px, чтобы не тратить ресурсы на мелочь |
| Контрольные точки |
375, 960, 1920 |
Ширины (px, не меньше 240), под которые создаются копии. Рекомендованные: смартфон 480, планшет 768, ноутбук 1024, настольный 1280. Не рекомендуется больше трёх точек: каждая увеличивает объём хранилища |
Современные форматы изображений
| Поле |
По умолчанию |
Что делает |
| Включить конвертацию в современные форматы |
выключено |
Создаёт копии в выбранном формате. Оригиналы сохраняются для старых браузеров |
| Выберите целевой формат |
— |
WebP — на 25–35% меньше JPEG, поддерживается почти везде. AVIF — на 50–60% меньше, лучшее сжатие, но поддерживается не везде и не всеми серверами. Если формат сервером не поддерживается, сохранение настроек прервётся с ошибкой. Браузер без поддержки формата получает обычный. В одном теге форматы не смешиваются |
Оптимизация изображений
| Поле |
По умолчанию |
Что делает |
| Включить оптимизацию изображений |
выключено |
Позволяет задать пониженное качество по форматам |
| Качество изображения (0–100): JPG |
85 |
Рекомендуется 80–90 (больше — крупнее файл) |
| PNG |
90 |
0 — максимальное сжатие, 99 — без потерь |
| GIF |
90 |
0 — меньше цветов, 99 — полная анимация и палитра |
| WebP |
85 |
Оптимальный баланс 85–95 |
| AVIF |
60 |
Рекомендуется 50–70 |
| JPEG XL |
80 |
Поле скрыто, потому что формат JPEG XL в выборе не предлагается; сохранённое значение не меняется и не используется |
Увеличенные изображения (Премиум)
| Поле |
По умолчанию |
Что делает |
| Генерировать версии изображений высокого разрешения |
не выбрано |
Отметьте 2x (Retina) и/или 3x. Копии грузятся только на экранах высокой плотности. Каждый масштаб — дополнительные файлы и расход памяти |
LQIP (низкокачественные изображения-заполнители) (Премиум)
| Поле |
По умолчанию |
Что делает |
| Создавать LQIP-заполнители |
выключено |
Создаёт маленькую размытую копию (2–5 КБ вместо 100–500 КБ), которая показывается, пока грузится полная картинка. В разметку добавляются атрибуты data-srcset-lqip и data-sizes-lqip. Работает только вместе с плагином Lazyload |
Микроданные (Премиум)
| Поле |
По умолчанию |
Что делает |
| Микроданные Schema.org |
выключено |
Добавляет разметку для поисковых систем (расширенные сниппеты) |
| Соотношения сторон изображений |
выключено |
Видно, когда включены микроданные. Добавляет информацию о соотношении сторон в разметку |
| Генерировать изображения с заданным соотношением сторон |
не выбрано |
Видно, когда включены оба переключателя выше. Отметьте нужные пропорции: 16:9, 4:3, 1:1 — плагин создаст копии с этими пропорциями |
Метаданные (Премиум)
| Поле |
По умолчанию |
Что делает |
| Добавить метаданные IPTC |
выключено |
Записывает в копии метаданные IPTC (индексация, авторские права). Только для изображений JPEG. Если на сервере отключена функция iptcembed, сохранение прервётся с ошибкой |
Альтернативный текст (Премиум)
Подробнее про GigaChat — в разделе 10.
| Поле |
По умолчанию |
Что делает |
| Генерация ALT-текста |
выключено |
Автоматически создаёт ALT. Добавляется только к тегам без атрибута alt; уже заданный (в том числе пустой alt="" у декоративной картинки) не меняется. Предел длины — 255 символов |
| Метод генерации ALT-текста |
— |
«Использовать переменные (шаблон)» или «Использовать ИИ (GigaChat)» |
| Шаблон ALT-текста (для метода «переменные») |
пусто |
Текст с подстановками: {$image_name} — имя файла, {$image_alt} — текущий ALT, {$page_title} — заголовок страницы, {$page_keywords} — ключевые слова страницы. Пример: {$page_title}: {$image_alt} |
| API-ключ для GigaChat (для метода GigaChat) |
пусто |
Ключ авторизации GigaChat. Сохранённый ключ на страницу не передаётся: показано «Ключ задан» и кнопки «Заменить ключ» / «Очистить ключ» |
| Шаблон ALT-текста (для GigaChat) |
пусто |
Подсказка для нейросети: какие тексты создавать (стиль, длина). Пример: «Краткое описание товара, 5–7 слов» |
HTML-атрибуты (Премиум)
| Поле |
По умолчанию |
Что делает |
Добавить атрибуты width и height |
выключено |
Добавляет размеры в теги img: браузер заранее резервирует место, страница не «прыгает» при загрузке (показатель CLS) |
Вкладка «Хранилище»
Хранение готовых копий в облаке (S3). Подробный порядок настройки, примеры для провайдеров и проверка подключения — в разделе 8. Здесь — перечень полей.
| Поле |
По умолчанию |
Что делает |
| Кнопка «Проверить подключение» |
— |
Проверяет подключение и доступ к бакету, пишет и удаляет тестовый файл, проверяет публичное чтение. Работает с ключом, ограниченным одним бакетом |
| Включить |
выключено |
Новые обработанные картинки загружаются в облако. Файлы, уже лежащие на сервере, автоматически не переносятся |
| URL хранилища |
пусто |
Полный адрес API хранилища, например https://storage.yandexcloud.net |
| Bucket |
пусто |
Имя бакета (регистр важен). Только латинские буквы, цифры, дефисы |
| Key ID |
пусто |
Идентификатор ключа доступа |
| Secret key |
пусто |
Секретный ключ. После сохранения на страницу не передаётся: «Ключ задан», «Заменить ключ», «Очистить ключ». Если вы меняете адрес хранилища, секретный ключ нужно ввести заново |
| Код региона |
пусто |
Например, ru-central1 (Yandex), us-east-1 |
| Endpoint Style |
Path-стиль |
«Path-стиль» (адрес вида https://хост/бакет/файл) или «Виртуально-хостинговый стиль» (https://бакет.хост/файл). Если не уверены — Path-стиль |
| Не отправлять ACL |
выключено |
Включите, если бакет не принимает ACL (ошибка AccessControlListNotSupported). Тогда файлы нужно открыть политикой бакета |
| Cache-Control файлов |
public, max-age=31536000, immutable |
Заголовок для файлов с версией в имени. Пусто — не отправлять. Файлам со старыми именами не отправляется |
| Отладка |
выключено |
Только для диагностики; на рабочем сайте не включайте |
Сохранение
- Кнопка «Сохранить» внизу пересобирает скрипт витрины
scripts.js и проверяет, что выбранные форматы и функции возможны на сервере. Если проверка не прошла, настройки не сохраняются и показывается ошибка.
- Если у витрины не удалась пересборка скрипта, вверху вкладки «Настройки» появится красное предупреждение: проверьте права на запись в папку данных плагина и журнал
wa-log/responsiveimages.log; сохранение настроек этой витрины пересоберёт скрипт.
- Сохранение настроек также возвращает в очередь картинки из карантина и достраивает таблицу очереди, если обновление было отложено.
