Добавление разных изображений для вариантов продукта
Разные изображения для вариантов в теме Horizon от Shopify (без приложений и без Plus). Бесплатное решение от VecomLab.
Актуально для версии темы Horizon 3.1.0

Описание проблемы
По умолчанию в админке Shopify и в настройках темы Horizon каждому варианту можно задать только одно изображение, но не несколько.
Эту проблему платформа частично решает для магазинов на тарифе Plus. Также можно использовать сторонние приложения Shopify, однако это чаще всего невыгодно и неэффективно, так как нередко возникают ошибки, которые приходится исправлять через поддержку месяцами.
Задачу можно решить, используя Metafields and Metaobjects для Variants и редактор кода темы.
Идея
У варианта есть метаполе
custom.variant_gallery(список файлов).Мы считаем «своими» все картинки, чьё имя файла совпадает со стемом из метаполя или начинается со стема +
_или-.На сервере (Liquid) делаем пред-скрытие лишних картинок для первого кадра.
На клиенте (JS) читаем карту «вариант → файлы» и фильтруем при переключении варианта.
Если ни у одного варианта метаполя нет — ничего не меняется, всё работает как в теме.
Что нового: зум и quick add
Зум-диалог теперь тоже фильтруется по варианту: и миниатюры, и большие кадры.
Mobile quick add (модалка на странице коллекции): на мобильных в модалке показывается только одно изображение — featured текущего варианта (как в стандартной Horizon), даже если у варианта есть целая серия.
Шаг 1. Метаполе варианта (единожды на весь магазин)
Settings → Metafields and metaobjects → Variants → Add definition
Name: Variant Gallery
Namespace and key:
custom.variant_galleryType: File → List of files
Validations: только Images
Options: включить Storefront API access
Save
Почему так: это нативный способ связать вариант с файлами в Shopify Files. Ключ совпадает с тем, что использует код.
Шаг 2. Договор по именам файлов
В Files даём серии фото общего варианта общий стем:
В метаполе варианта прикрепляем один «якорный» файл из серии (например, ring-gold.jpg). Остальные подхватятся по стему автоматически.
Шаг 3. Вставки в _product-media-gallery.liquid
Ниже перечислено ровно то, что мы добавили/заменили, и зачем.
3.1. JSON-карта вариант → файлы (сервер → фронт)
Вставить перед {%- if has_image_drop -%}:
Зачем: фронт получает готовый JSON без парсинга DOM. Сразу приводим URL к базовому имени.
3.2. Флаги на <media-gallery>
В атрибутах тега, рядом с data-presentation и style, добавить:
data-vg-ready="0"— анти-мигание: пока скрипт не закончит, картинки скрыты (ниже будет CSS).data-initial-variant-id— опционально, для отладки/аналитики; сам скрипт берёт id варианта из формы.
3.3. vg_list для первого рендера
Сразу после {{ block.shopify_attributes }}:
Зачем: знать список файлов текущего варианта на сервере, чтобы пред-скрыть лишние картинки ещё до JS (правильный первый кадр).
3.4. Серверный пред-скрыт в слайдах (Carousel)
Перед вычислением class/style/attributes каждого медиа:
И далее добавляем vg-prehide и display:none:
3.5. Единый набор data-атрибутов на слайд
Перед блоком с attributes:
И заменяем блок attributes на варианты с подстановкой {{- common_data_attrs -}} (для model / image / «без zoom»).
Было:
Стало:
Зачем: фронту нужны тип и URL картинки. data-vg-allow/data-vg-prehide помогают CSS до инициализации JS.
3.6. То же — для Grid
Внутри <ul class="media-gallery__grid"> перед каждым <li> повторяем логику prehide
А в самом <li> для Grid заменяем class= "" и style "" на:
И добавляем data-атрибуты:
3.7. Фильтрация внутри зум-диалога (Liquid)
Миниатюры зума (1)
Внутри блока с миниатюрами (кнопки .dialog-thumbnails-list__thumbnail) добавьте пред-скрытие, как мы делали для слайдов/грида:
В <button> замените class="" и style="" :
И добавьте атрибуты:
Большие кадры в зуме (2)
Для <li> внутри .dialog-zoomed-gallery примените ту же проверку prehide и те же data-атрибуты.
Вставьте проверку перед <li>
Замените class="" и style="" в <li>
И добавьте атрибуты:
Идея та же: обеспечиваем «чистый» первый кадр в зуме ещё до выполнения JS.
3.8. Клиентский скрипт и мини-CSS (после </media-gallery>)
Скрипт:
читает
#variant-galleries-json;если у товара нет ни одного варианта с метаполем → ставит
data-vg-ready="1"и выходит (ничего не меняем);иначе фильтрует
image-слайды по текущему варианту; при смене варианта — повторяет;в конце ставит
data-vg-ready="1"(анти-мигание выключается).
CSS:
Зачем: полностью убирает «дрожание/моргание» и промежуточные состояние до готовности. Мы не трогаем миниатюры/стрелки — в «чистом» варианте данной версии скрипта их и не скрываем.
Почему это нужно:
пока стоит
data-vg-ready="0", модалка не «мигает» набором картинок;JS дополнительно гарантирует, что даже после переключений варианта в модалке будет ровно одно изображение.
Что сознательно не трогаем (остается «как в теме»)
Сделаем это в следующих версиях скрипта:
Счётчик / стрелки / миниатюры карусели — не настраиваем и не прячем отдельными правилами.
Небольшой аудит «лишнего»
data-initial-variant-id— опция, можно удалить (скрипт не сломает).MutationObserverсейчас повешен наdocument.bodyдля «неубиваемости» при динамических перерисовках. Можно ужать до наблюдения только за<media-gallery>, но текущий вариант надёжнее ко всем темам/скриптам.Дублирование логики «пред-скрыт на сервере» + «фильтр на клиенте» — осознанно: даёт идеальный первый кадр (без мусора) и корректную работу при дальнейших переключениях. Это не лишнее, а анти-FOUC-слой.
Итог
Если у варианта заполнено метаполе Variant Gallery, на странице показываются только его фотографии (по имени файла). Если метаполя нет — всё работает как раньше. Первый кадр чистый без миганий (пред-скрытие на сервере), при переключении варианта галерея обновляется скриптом. Никаких приложений, конфликтов и замедлений.
Настройка темы
Режимы Product media (Grid + Hint) и Grid + Dots поддерживаются. Поведение «одно изображение в Mobile quick add» включается только внутри модалки на экранах ≤ 749 px; на странице товара и на десктопе остаётся полноценная галерея по варианту.

Вы можете задать вопросы в телеграм-чат.
FAQ
Последнее обновление