Appearance
Шаблоны коллекций
Шаблоны находятся в разделе Витрина → Товарные коллекции → Шаблоны.
Шаблон определяет HTML-разметку, в которой коллекция выводится на сайте. Шаблоны общие для проекта: один шаблон можно назначить нескольким коллекциям в поле «Шаблон» формы коллекции. Если коллекции шаблон не назначен («Без шаблона»), API вернёт только данные о товарах — так удобно, если вы выводите коллекцию своей вёрсткой.
Как создать шаблон
- Нажмите «Новый шаблон».
- Укажите «Название шаблона».
- Отредактируйте «Код шаблона». Новый шаблон заполняется базовой разметкой: сетка карточек с изображением, названием, ценой и ссылкой «Подробнее». Её можно взять за основу.
- Нажмите «Сохранить».
- Откройте коллекцию, нажмите «Настроить» и выберите шаблон в поле «Шаблон».
На странице шаблона показан его код и доступны действия:
| Действие | Что делает |
|---|---|
| Редактировать | Открывает редактор шаблона |
| Сбросить до базового шаблона | Заменяет код шаблона базовой разметкой |
| Удалить | Удаляет шаблон |
Удаление шаблона
Коллекции с удалённым шаблоном потеряют оформление: они будут возвращать только данные о товарах с пустым шаблоном. Перед удалением назначьте этим коллекциям другой шаблон.
Язык шаблонов
Шаблоны пишутся на языке 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>