Skip to content

Шаблоны коллекций ​

Шаблоны находятся в разделе Витрина → Товарные коллекции → Шаблоны.

Шаблон определяет HTML-разметку, в которой коллекция выводится на сайте. Шаблоны общие для проекта: один шаблон можно назначить нескольким коллекциям в поле «Шаблон» формы коллекции. Если коллекции шаблон не назначен («Без шаблона»), API вернёт только данные о товарах — так удобно, если вы выводите коллекцию своей вёрсткой.

Как создать шаблон ​

  1. Нажмите «Новый шаблон».
  2. Укажите «Название шаблона».
  3. Отредактируйте «Код шаблона». Новый шаблон заполняется базовой разметкой: сетка карточек с изображением, названием, ценой и ссылкой «Подробнее». Её можно взять за основу.
  4. Нажмите «Сохранить».
  5. Откройте коллекцию, нажмите «Настроить» и выберите шаблон в поле «Шаблон».

На странице шаблона показан его код и доступны действия:

ДействиеЧто делает
РедактироватьОткрывает редактор шаблона
Сбросить до базового шаблонаЗаменяет код шаблона базовой разметкой
УдалитьУдаляет шаблон

Удаление шаблона

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

Язык шаблонов ​

Шаблоны пишутся на языке Liquid: доступны его теги и фильтры, описанные в руководстве по Liquid. Справка по переменным показывается рядом с редактором.

ПеременнаяОписание
products_totalКоличество товаров в коллекции
collection_itemsМассив товаров, отобранных группами фильтров коллекции

Основные свойства товара в collection_items:

СвойствоОписание
idАртикул товара
name, descriptionНазвание и описание
urlСсылка на товар
price, price_fullЦена без дробной части и с дробной частью
price_formatted, price_full_formattedОтформатированная цена
oldprice, oldprice_formattedСтарая цена и отформатированная старая цена. Есть варианты _full
discount, discount_formattedРазмер скидки
currencyСимвол валюты
image_urlСсылка на оригинальное изображение
image_url_resizedИзображение нужного размера: 120, 140, 160, 180, 200, 220, 310, 520. Например, item.image_url_resized['140']
brand, model, barcodeБренд, модель, штрихкод
categories, category_idsНазвания и идентификаторы категорий
is_newПризнак новинки
ratingРейтинг
stock_quantity, leftoversОстаток на складе и его строковое представление: one, few, lot
group_idИдентификатор группы товаров с вариантами
location_idsЛокации, в которых товар есть в наличии
fashion_sizes, fashion_original_sizesПреобразованные и исходные размеры одежды
sales_rate, relative_sales_rateОборачиваемость и относительная оборачиваемость

Пример вывода списка товаров:

liquid
<div class="collection">
  {% for item in collection_items %}
    <a href="{{ item.url }}">
      <img src="{{ item.image_url_resized['180'] }}" alt="{{ item.name | strip_html }}">
      <span>{{ item.name | strip_html | truncate: 30 }}</span>
      <span>{{ item.price_full_formatted }}</span>
    </a>
  {% endfor %}
</div>