Плагин сжимает изображения медиатеки через API ANK. Здесь описаны установка, настройка, автоматическая и пакетная обработка, восстановление исходников и проверка результата.
1. Возможности и принцип работы
ANK Image Compress обрабатывает исходные JPEG, PNG и WebP и выбранные размеры, созданные WordPress. После ответа API плагин проверяет формат, размеры и уменьшение файла; только затем заменяет изображение. Имя и адрес сжатого файла сохраняются. Исходные байты до замены сохраняются в приватной папке за пределами сайта.
Доступны автоматическое сжатие новых загрузок, обработка отдельного изображения, выбранных изображений и всей медиатеки, поиск по имени или названию, страницы по 50 изображений, статистика экономии и восстановление исходника.
2. Установка и API-ключ
- Установите плагин ANK Image Compress из ZIP-файла через «Плагины → Добавить плагин → Загрузить плагин» и активируйте его.
- Создайте учётную запись на ankpicpress.com, откройте личный кабинет и получите API-ключ. Учётные данные и баланс общие с ank-tinypng.ru; вход на каждом домене выполняется отдельно.
- В WordPress откройте «Настройки → ANK Сжатие», введите ключ и нажмите «Сохранить настройки».
- Проверьте в блоке «Подключение» состояние API и доступный баланс. Сохранённый ключ повторно не показывается.
Для сети WordPress Multisite можно определить константу ANKIC_API_KEY в wp-config.php: один ключ будет доступен сайтам сети. Не публикуйте его в документации и открытых файлах. При заданной константе поле ключа в админке недоступно для редактирования.
3. Автоматическое сжатие
В «Настройки → ANK Сжатие» включите «Обрабатывать новые изображения после загрузки через WP-Cron» и сохраните настройки. После создания изображения WordPress ставит обработку в очередь с небольшой задержкой. Работа не требует открытой страницы админки, но WP-Cron должен запускаться посещениями сайта или системным cron.
Для проверки загрузите небольшое статичное JPEG, PNG или WebP, подождите запуска cron и найдите изображение в таблице плагина. Статус «Готово» означает, что подходящие размеры уже обработаны; счётчик показывает обработанные и доступные файлы. Если обработка не стартует, проверьте WP-Cron, API-ключ и баланс.
4. Ручная и пакетная обработка
Для одного файла нажмите «Сжать» в таблице плагина или в списочном виде медиатеки WordPress. В медиатеке можно также выделить несколько изображений и выбрать действие пакетного сжатия. Кнопка «Обработать все изображения на этой странице» относится только к текущим 50 строкам.
Для всей медиатеки используйте «Начать пакетную обработку» в отдельном блоке. Плагин проходит изображения через WP-Cron по одному файлу за запуск. Прогресс сохраняется на сервере; доступны пауза и возобновление. Показатели «изображений обработано» и «ошибок» относятся к текущему проходу. Повторный запуск не должен заново сжимать уже обработанные версии без запроса на переобжатие.
5. Размеры, WebP и AVIF
В разделе «Размеры для сжатия» отметьте миниатюры WordPress, которые нужно отправлять в API. Исходное изображение обрабатывается всегда. Чем больше размеров выбрано, тем больше может быть запросов к API. Максимальную ширину и высоту можно указать для новых больших JPEG и WebP; значение 0 сохраняет поведение WordPress. PNG WordPress по этой настройке не уменьшает.
Параметр «Формат новых размеров изображений» создаёт новые миниатюры в WebP или AVIF средствами WordPress. Он не меняет существующие изображения и исходный файл. WebP-миниатюры могут затем сжиматься через API ANK. AVIF-миниатюры создаются локально WordPress и в API ANK не отправляются. Выбор доступен только если серверный редактор изображений поддерживает формат.
6. Поиск, статистика и восстановление
Поиск в таблице принимает название или имя файла; результаты выводятся по 50 на странице. Столбцы показывают число обработанных файлов, сэкономленный объём и состояние. В блоке статистики выводятся суммарные числа обработанных изображений, файлов и сохранённых байтов.
Кнопка «Восстановить исходник» возвращает сохранённые до сжатия байты. «Переобжать» запускает новую обработку. Перед массовым переобжатием проверьте баланс: каждый новый успешный результат может потребовать кредит. Резервные исходники хранятся вне публичной папки сайта; для их записи у WordPress должны быть права на родительский каталог установки.
7. Кредиты, форматы и ограничения
Текущий API ANK принимает статичные JPEG, PNG и WebP размером до 5 МБ и разрешением до 20 Мп. Если ответ API не меньше исходного файла, он не заменяется и кредит не списывается. Повтор одинакового запроса защищён от повторного списания. Баланс виден в блоке «Подключение».
8. Если обработка не работает
- API недоступно или ключ неверен. Откройте «Настройки → ANK Сжатие», проверьте состояние подключения, при необходимости сохраните новый ключ и обновите страницу.
- Нет автоматической обработки. Проверьте галочку автоматической обработки и реальный запуск WP-Cron. Затем загрузите новый небольшой JPEG и проверьте его статус.
- Файл пропущен. Проверьте MIME, размер до 5 МБ, разрешение до 20 Мп и отсутствие анимации. Для AVIF проверьте поддержку серверного редактора и помните, что API его не сжимает.
- Не удалось сохранить исходник. Проверьте права WordPress на родительский каталог сайта. До исправления плагин не должен заменять файл.
- Старое изображение в браузере. Обновите кэш страницы или CDN; плагин добавляет версию URL в стандартной выдаче WordPress после замены файла.
Если ошибка повторяется, отправьте в modules@ankpicpress.com версию плагина, тип и размер файла, текст ошибки и шаги воспроизведения. API-ключ и исходники с личными данными в письмо не включайте.