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.