Merchant Image Audit для OpenCart — аудит фото товаров под минимум Google Merchant Center 500×500

Merchant Image Audit для OpenCart — модуль для магазинов, которые показывают товары в Google Shopping и бесплатных объявлениях через Merchant Center. По справке Google, с 31 января 2027 года каждое изображение в image_link и additional_image_link должно быть не меньше 500×500 px — для всех товаров и категорий. С 14 апреля 2026 года меньшие изображения уже получают в Merchant Center предупреждение «Image too small for upcoming enforcement». В типичном OpenCart-каталоге фото загружались годами, разными людьми и разного размера, так что просматривать их вручную — долго.

Модуль измеряет оригинальный файл каждого фото товара — главного и всех дополнительных, а не уменьшенные копии, которые показывает тема, — и делит товары на четыре группы: всё в порядке; не проходят только дополнительные фото; главное слишком маленькое, но среди собственных фото товара есть побольше; нужно новое фото. Заодно он проверяет формат, вес, мегапиксели и то, соответствует ли расширение файла настоящему формату. Модуль никогда не увеличивает фото: он либо находит собственное большее фото, либо прямо пишет, что нужно новое.

Для WooCommerce есть отдельная версия — Merchant Image Audit для WooCommerce.

Как это выглядит для покупателя

Покупатель модуля не видит: на витрине и в оформлении заказа ничего не меняется, скриптов и запросов на страницах магазина модуль не добавляет. Публичные адреса модуля — дополнительные файлы для Merchant Center и адрес повторной проверки — открываются только с секретным ключом. Покупатель замечает только последствие: товар в Google Shopping показан чётким фото, а не отклонён из-за слишком маленького изображения.

Что получает админ

Модуль — в Расширения → Расширения → Модули → CatCode Merchant Image Audit. Пять вкладок: «Аудит», «Файлы для Merchant Center», «Проверка фида», «Настройки», «Лицензия».

• «Проверить все товары». Модуль читает только заголовки файлов, пачками, и ничего не меняет. Счётчики: проверено товаров, все фото в норме, главное не проходит, из них есть собственное фото побольше, нужно новое фото, дополнительных фото не проходят.
• Список товаров с миниатюрой, размером и весом оригинала главного фото, миниатюрами дополнительных с размерами и вердиктом каждого. Синяя рамка — самое большое собственное фото, проходящее все требования. Клик по миниатюре открывает оригинал, по названию — редактирование товара.
• Фильтры: все проблемы, главное фото не проходит, можно исправить собственным фото, нужно новое фото, не проходят только дополнительные, расширение ≠ формат, всё в норме. Поиск — по названию, модели, SKU или ID.
• Отчёт CSV — строка на товар: ID, модель, SKU, название, вердикт, размер, статус и адрес главного фото, сколько дополнительных фото и сколько из них не проходят, самое большое собственное фото с размером и адресом. UTF-8 с BOM: открывается в Excel без танцев с кодировкой, а названия товаров, начинающиеся с «=», не выполняются как формулы.
• Настройки: минимальный размер (по умолчанию 500×500), проверять ли отключённые товары.

Pro: исправление, файлы для Merchant Center, проверка фида

• «Сделать главным». Собственное дополнительное фото товара, проходящее все требования, становится главным, а прежнее главное переходит в дополнительные — ничего не удаляется. Кнопка «Поставить своё большее фото всем» делает то же самое для каждого товара с вердиктом «Можно исправить». Каждое изменение видно в списке с кнопкой «Отменить».

• Дополнительные файлы для Merchant Center. Merchant Center позволяет подключить к основному фиду дополнительный источник данных (supplemental), который меняет атрибуты уже существующих товаров по совпадению id, не трогая модуль фида. Модуль готовит три таких файла в формате TSV, в каждой ячейке — значение: image_link с оригинальным файлом (только для товаров «Можно исправить» или для всех, у кого есть подходящее фото), excluded_destination для товаров без единого подходящего фото (Shopping_ads, Free_listings, Display_ads, Local_inventory_ads, Free_local_listings — на выбор) и custom label для тех же товаров в слоте custom_label_0…4. Шаблон id подстраивается под ваш фид.
• Как подключить (по справке Google): в Merchant Center включить дополнение «Advanced data source management» → Settings → Data sources → Supplemental sources → Add supplemental product data → A file → ссылка на файл (или загрузить файл вручную) → привязать к основному источнику. Живой приём файла мы не проверяли — см. выше.

• Проверка фида. Многие модули фида ставят в image_link уменьшенную копию из image/cache/, даже когда оригинал большой. Укажите адрес фида, который вы подаёте в Merchant Center (XML с пространством имён g: или TSV/CSV, также gzip, до 200 000 ссылок), — модуль измерит каждое изображение по image_link и additional_image_link. Изображения этого магазина читаются с диска, других хостов — по HTTP, только первые байты. Для копии из кеша модуль показывает оригинал и его размер.
• Ежедневная повторная проверка. В OpenCart 4 — заданием cron OpenCart; в OpenCart 3 и 2.3 — адресом для cron хостинга (раз в час достаточно, новый круг начинается только через 20 часов); а также короткими шагами, когда Merchant Center забирает файл.

Как это работает — шаг за шагом

1. «Проверить все товары» проходит каталог пачками по 200 товаров, каждый запрос — до 8 секунд, так что тайм-аут хостинга не обрывает проверку. Берутся включённые товары (отключённые — по настройке).
2. Для каждого фото модуль берёт оригинал из image/ и читает только заголовок файла: ширину, высоту, настоящий формат. Файл больше 16 МБ или 64 Мп, отсутствующий, нечитаемый или в неподдерживаемом формате (SVG, AVIF) получает свой статус.
3. Товар получает один вердикт. Главное фото проходит и дополнительные тоже → «Норма». Главное проходит, а какие-то дополнительные нет → «Дополнительные фото». Главное не проходит (или его нет), но есть собственное дополнительное, проходящее все требования → «Можно исправить», и модуль отмечает самое большое из них. Иначе → «Нужно новое фото».
4. Вы фильтруете список, выгружаете CSV для фотографа или контент-менеджера, а в Pro исправляете «Можно исправить» кнопкой.
5. В Pro модуль строит по последней проверке три дополнительных файла для Merchant Center и ежедневно проверяет каталог заново, так что файлы не устаревают.

Что под капотом

• Без правок ядра. Без OCMOD-патчей и событий. Одна библиотека классов одинакова в трёх сборках, код совместим с PHP 7.0.
• Собственные таблицы oc_cc_imgaudit_product (вердикт товара), oc_cc_imgaudit_image (каждое фото), oc_cc_imgaudit_log (замены главного фото для «Отменить»), oc_cc_imgaudit_feed (проверка фида).
• Читаются только заголовки файлов: getimagesize(), заголовок WebP разбирается вручную, чтобы работало и на PHP 7.0. Фото не перекодируются и не копируются.
• Дополнительные файлы отдаются по адресу index.php?route=extension/cc_imgaudit/feed&type=image|exclude|label&key=…: без ключа или без активного Pro — «403».
• Лицензия живёт в отдельной группе настроек: «Сохранить» её не трогает.
• Удаление: деинсталляция убирает таблицы, настройки, задание cron (OpenCart 4) и права доступа к странице модуля. Аудит восстанавливается новой проверкой.

Как установить

1. OpenCart 4: Расширения → Инсталлятор → загрузите cc_imgaudit.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Инсталлятор → cc_imgaudit-oc3.ocmod.zip, затем Расширения → Модификации → «Обновить». OpenCart 2.3: залейте содержимое папки upload/ из cc_imgaudit-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Инсталлятор 2.3 без настроенного FTP файлы не копирует.
2. Расширения → Расширения → Модули → CatCode Merchant Image Audit → «Установить», затем «Редактировать».
3. Вкладка «Аудит» → «Проверить все товары». Отфильтруйте «Нужно новое фото» и выгрузите CSV — это список для фотографа.
4. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать 7 дней» во вкладке «Лицензия». Затем «Поставить своё большее фото всем» и, при необходимости, ссылки на файлы из вкладки «Файлы для Merchant Center» — в Merchant Center.