Перейти к основному содержимому

CDN: модули для CMS

Модули заменяют адреса публичных изображений на CDN URL вашего сайта. Браузер получает изображение с Zorka CDN, а оригиналы остаются на хостинге. Доступ к nginx, Apache или .htaccess не нужен.

Выберите модуль​

CMSПроверенная версияИнструкция
WordPress + WooCommerceWordPress 7.1.3, WooCommerce 11.2.1WordPress
OpenCart 33.0.4.1OpenCart
OpenCart 44.1.0.4OpenCart
ocStore 33.0.4.1ocStore
MODX Revolution 2 / 32.8.9-pl / 3.2.4-plMODX
Joomla 5.4 / 6.x5.4.9 / 6.1.4Joomla
1С-БитриксОтдельный модульБитрикс

WordPress — 0.1.1, остальные пакеты — 0.1.0. Минимум для WordPress/OpenCart 3/ocStore 3 — PHP 7.4; OpenCart 4 требует PHP 8 и версию, подходящую самой CMS. Проверка нового модуля не означает совместимость со всеми старыми релизами, темами и расширениями.

Перед установкой​

  1. Подключите источник CDN для сайта. Оригиналы должны открываться по HTTPS без cookie и авторизации.
  2. В личном кабинете откройте лицензию или подписку и скопируйте CDN URL. Он работает после подключения источника.
  3. Используйте весь выданный адрес, включая /s/site_id, если он присутствует. Это не лицензионный ключ. Общий адрес https://cdn.zorka.cloud без привязки не выбирает ваш сайт автоматически.
  4. Добавьте к CDN URL путь реальной картинки и проверьте результат в браузере. Только после этого включайте подмену.

Модули не создают регистрацию источника автоматически и не загружают файлы на CDN. Если источник ещё не подключён, обратитесь в поддержку через кабинет.

Что меняется​

Поддерживаются JPEG, PNG, WebP, AVIF, GIF и BMP, srcset, стандартные lazy-loading атрибуты, picture, постеры видео и inline CSS url(). Расширение URL может остаться .jpg, а Content-Type ответа — быть image/avif или image/webp: формат выбирает CDN по браузерному Accept.

Оригиналы и записи контента не меняются. Укажите только публичные папки и исключите приватные вложения, платные загрузки и персональные документы. Фильтрация по пути не заменяет проверку прав доступа.

SVG, ICO, сторонние домены и типовые подписанные ссылки остаются исходными. Внешние CSS, строки JavaScript/JSON, headless API и нестандартные динамические галереи требуют отдельной интеграции. Нет автоматического возврата на origin при недоступности CDN.

Проверка и отключение​

Проверьте страницу без авторизации: для вошедших пользователей новые модули отключают подмену. WordPress также пропускает корзину, checkout и личный кабинет WooCommerce. Посмотрите src/srcset в HTML и ответы изображений в Network: ожидаются успешная загрузка и правильный Content-Type. При наличии заголовков CDN проверьте Vary: Accept и X-Image-Cache.

После изменения настроек, отключения или удаления очистите весь кэш HTML страниц. Кэш, который веб-сервер отдаёт без запуска PHP, может сохранять старые адреса. При проблеме отключите модуль и очистите кэш: оригинальные ссылки сформирует CMS.

Архивы и SHA-256 manifest доступны по ссылкам в инструкциях. Настройка собственного reverse proxy относится к отдельному способу интеграции.