Автоматическая конвертация изображений блога в WebP и добавление Alt-текстов

Плагин blogwebp для Webasyst Blog

Плагин автоматически переводит картинки в формат WebP и помогает заполнять Alt-текст у изображений в постах. WebP обычно весит меньше JPG и PNG, поэтому страницы открываются быстрее. Alt нужен для SEO и для людей, которые используют программы чтения с экрана.

Зачем он нужен

Новые фото при загрузке в редактор поста сразу сохраняются как WebP.

Старые посты с JPG, PNG и GIF можно массово перевести в WebP через cron или команду в SSH.

У каждой картинки можно указать Alt — вручную или автоматически из заголовка поста.

Ссылки на файлы в HTML поста записываются в виде /wa-data/public/blog/img/... , без полного адреса сайта.

Каждый новый файл получает уникальное имя, чтобы не перезаписывать уже существующие изображения.

Что делает плагин при работе с новыми постами

Вы открываете редактирование поста в Blog и загружаете картинку через редактор Redactor.

Плагин конвертирует файл в WebP и сохраняет его в папку wa-data/public/blog/img/ .

В окне загрузки появляется поле Alt-текст . Если поле пустое, подставляется заголовок поста.

После загрузки в HTML поста попадает ссылка вида /wa-data/public/blog/img/имя-файла.webp .

При сохранении поста плагин ещё раз проверяет Alt у всех изображений без текста.

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

JPG, JPEG, PNG, GIF, WebP.

Требования к серверу

PHP с поддержкой WebP: GD ( imagewebp ) или ImageMagick.

Папка wa-data/public/blog/img/ должна быть доступна для записи.

Для массовой конвертации старых постов нужен доступ к SSH и cron.

Открыть Blog → Настройки → Плагины → WebP изображения .

Включить плагин и сохранить настройки.

Открыть любой пост, загрузить тестовое фото и проверить, что в HTML есть .webp и атрибут alt .

Настройки плагина

Включить плагин

Главный переключатель. Без него конвертация при загрузке не работает.

Качество WebP

От 1 до 100. По умолчанию 85 — баланс между размером файла и качеством.

Обязательный Alt

Не даст загрузить картинку без Alt-текста.

Alt из заголовка поста

Если Alt не указан, подставляет заголовок поста.

Cron: конвертация старых постов

Включает автоматическую обработку по расписанию.

Cron: ID постов

Список ID через запятую, например 143, 200, 305 . Пустое поле — обработка пакетами.

Cron: размер пакета

Сколько опубликованных постов обрабатывать за один запуск, если ID не указаны. По умолчанию 5.

Cron: удалять оригиналы

После успешной конвертации удаляет JPG, JPEG, PNG и GIF. WebP остаётся.

Конвертация старых постов (cron и SSH)

Плагин находит картинки в тексте поста, конвертирует их в WebP, обновляет ссылки в HTML и при необходимости удаляет старые файлы. Уже существующие WebP повторно не перекодируются.

Лог работы:

wa-log/blog/blogwebp-convert.log

Пример строки для crontab (каждый день в 03:15):

15 3 * * * php /полный/путь/к/webasyst/cli.php blog blogwebpConvertPosts

Ручной запуск для одного поста:

php /полный/путь/к/webasyst/cli.php blog blogwebpConvertPosts --post_id 143

Пробный запуск без изменений:

php /полный/путь/к/webasyst/cli.php blog blogwebpConvertPosts --post_id 143 --dry_run 1

Пример результата в HTML поста

Кратко для новичка

blogwebp — это плагин, который делает картинки в блоге легче и правильнее оформленными: меньше вес, быстрее сайт, есть Alt для поисковиков. Новые фото конвертируются сами при загрузке. Старые — через cron или одну команду в терминале.

Если что-то не работает

Проверить, что плагин включён в настройках Blog.

Проверить поддержку WebP на сервере (GD или ImageMagick).

После обновления плагина обновить страницу редактора поста через Ctrl+F5.

Для cron смотреть лог wa-log/blog/blogwebp-convert.log .

Убедиться, что в настройках включено Cron: удалять оригиналы , если нужно удаление JPG после конвертации.

Нужна помощь с настройкой под ваш магазин? Пишите на scc.lac@mail.ru или в Telegram @web_stu .