В Shop-Script показывается старое фото товара: как проверить оригинал, миниатюры и кеш

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

Этот порядок подходит для Shop-Script с обычной темой и для магазинов, где изображения изменяют плагины, импорт или CDN. Названия настроек зависят от версии и конфигурации: проверяйте фактические URL и ответы сервера, а не предполагаемое поведение.

Зафиксируйте симптом и выберите контрольные страницы

Сохраните URL товара, ID товара, артикул конкретного SKU, адрес изображения, время замены и два скриншота: как фото выглядит в редакторе и как — на публичной странице. Отдельно проверьте карточку товара, плитку категории, результаты поиска, блок рекомендаций и мобильную витрину.

Если новая фотография появляется в карточке, но не появляется в категории, вероятная зона проверки — размер миниатюры, кеш страницы или отдельный шаблон списка. Если на всех страницах старое фото, начните с данных самого товара и источника загрузки. Для магазина с несколькими витринами дополнительно укажите домен и тему оформления каждой витрины.

Проверьте исходное изображение и порядок фотографий

Откройте товар в редакторе и убедитесь, что новая фотография действительно сохранена в нужном товаре и установлена основной, если требуется именно основное изображение. Проверьте, не прикреплён ли новый файл к другому товару или варианту. При массовом импорте сверяйте стабильный идентификатор записи, а не одно название.

Для разработчика доступен официальный метод shop.product.images.getList, который возвращает список изображений товара, их ID, размеры, порядок и ссылки на эскизы. В shop.product.images.getInfo можно запросить информацию об одном изображении и его миниатюре заданного размера. Это диагностические средства при наличии разрешённого API-доступа, а не требование использовать API для каждой проверки.

Важно различать замену файла с сохранением прежней записи и удаление старой фотографии с добавлением новой: при разных реализациях импорта и плагинов идентификаторы и ссылки могут вести себя по-разному. Не удаляйте историю фотографий на рабочем сайте до резервного копирования.

Разделите оригинал, эскиз и изображение в шаблоне

На странице магазина через инструменты разработчика найдите фактический адрес изображения, которое показывает браузер. У элемента могут быть src, srcset и несколько размеров для адаптивной загрузки; браузер выбирает не обязательно тот URL, который виден первым в HTML. Сравните фактически загруженный файл с изображением в административной части.

Shop-Script использует эскизы изображений разных размеров. Официальная документация описывает хук image_generate_thumb, который срабатывает перед генерацией эскиза и позволяет плагинам влиять на процесс. Поэтому правильный оригинал и неправильный эскиз — отдельный сценарий неисправности.

Проверьте конкретный размер, который требует шаблон, и существует ли файл по его адресу. Если небольшая картинка верна, а крупная — старая, сравните их URL, дату изменения и ответ сервера. Не подменяйте диагноз массовой регенерацией всех файлов.

Сверьте HTTP-ответ, кеш браузера и CDN

Запросите проблемный URL изображения напрямую и запишите код ответа, Content-Type, размер файла и заголовки кеширования. Ответ 404 означает иную проблему, чем корректный 200 с устаревшим содержимым. Если используется CDN или прокси-кеш, определите, какой узел возвращает старую версию: исходный сервер, CDN или браузер.

Откройте страницу в приватном окне и сравните результат на другом устройстве. Это полезный тест, но сам по себе не доказывает причину: приватный режим тоже получает файлы из общего CDN. При необходимости используйте запрос с отключённым кешированием в инструментах разработчика и сопоставьте содержимое полученных файлов.

Если версия в хранилище уже обновлена, а CDN ещё отдаёт старый объект, очистите конкретный URL или примените согласованный механизм изменения версии адреса. Массовая очистка всех кешей может увеличить нагрузку и временно ухудшить доступность витрины.

Проверьте тему оформления и изображения вариантов

Шаблон списка товаров, карточка и мобильные блоки могут запрашивать разные размеры изображения. Сверьте настройки изображения в теме, а затем код вывода в изменённых шаблонах. Важно проверить не только HTML, но и JavaScript, который меняет фотографию при выборе SKU.

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

Когда проблема связана с нестандартным шаблоном, может потребоваться доработка Shop-Script и темы с тестированием всех размеров и вариантов, а не только заменой одного URL.

Исключите повторную загрузку старого фото интеграцией

В магазинах с автоматическим обновлением каталога старая фотография может возвращаться после очередного обмена. Проверьте журнал импорта и расписание интеграции: не обновляет ли внешний источник изображения после ручного редактирования. Для диагностики полезно зафиксировать время замены фото и время последнего обмена.

Если внешняя система отвечает за фотографии, договоритесь о правиле владения данными: какие изображения можно менять вручную и какие должны обновляться автоматически. Не выключайте всю интеграцию ради проверки одной карточки; сначала протестируйте на ограниченном наборе товаров или в тестовом окружении.

Проверьте плагины обработки изображений

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

Не отключайте обработчики изображений на рабочей витрине без плана отката: изменение формата или адресов файлов может затронуть тысячи карточек. Зафиксируйте исходные настройки, подготовьте резервную копию и оцените, какие старые эскизы потребуется пересоздать после исправления.

Вносите исправления по масштабу проблемы

Если неверно выбрана основная фотография, исправьте порядок только у нужного товара. Если проблема в одном размере эскиза, сначала восстановите этот размер для тестовой карточки. Если ошибка в теме, исправьте шаблон и проверьте srcset на разных ширинах экрана. Если виноват CDN, обновите конкретные кешированные объекты.

Регенерация миниатюр всего каталога может занять значительное время и место на диске. Перед такой операцией уточните фактический объём файлов, возможности хостинга и необходимость её выполнения. Для планового сопровождения ошибок изображений и обновлений полезна техническая поддержка интернет-магазина.

Сверьте результат на карточке, в каталоге и поиске

После исправления проверьте исходный URL и размеры миниатюр, отображение товара в категории и поиске, переключение вариантов, мобильный экран и обновление без авторизации. Сравните несколько товаров: изменённый, соседний и тот, который был загружен до обновления темы. Убедитесь, что нет битых изображений, неожиданной обрезки и повторного появления старой фотографии после следующего импорта.

Если фото участвует в товарных фидах или внешних интеграциях, проверьте передаваемые ссылки отдельно: они могут обновляться по другому расписанию. Смежные примеры изменений магазина собраны в портфолио доработок Quadro Design, однако конкретная диагностика зависит от конфигурации проекта.

Вывод: при старой фотографии в Shop-Script нужно последовательно сравнить запись товара, оригинал, требуемую миниатюру, URL из шаблона и ответ кеширующих слоёв. Сначала локализуйте место расхождения, затем исправьте один проверяемый случай и только после этого распространяйте решение на каталог.