Appearance
Шаблоны
Шаблоны находятся в разделе Витрина → Товарные рекомендации → Шаблоны.
Шаблон определяет HTML-разметку блока рекомендаций, которую получает сайт. Шаблоны общие для проекта: один шаблон можно назначить нескольким блокам в их настройках. Если блоку шаблон не назначен, используется шаблон по умолчанию.
Как создать шаблон
- Нажмите «Новый шаблон».
- Укажите «Название шаблона».
- Отредактируйте «Код шаблона». Новый шаблон заполняется базовой разметкой, ее можно взять за основу.
- Нажмите «Сохранить».
- Откройте нужный блок, нажмите «Настройки» и выберите шаблон в поле «Шаблон блока».
На странице шаблона доступны действия «Редактировать», «Сбросить до базового шаблона» и «Удалить».
Удаление шаблона
Блоки с удаленным шаблоном потеряют оформление: они будут возвращать только данные о товарах с пустым шаблоном. Перед удалением назначьте этим блокам другой шаблон.
Язык шаблонов
Шаблоны пишутся на языке Liquid: доступны его теги и фильтры, описанные в руководстве по Liquid. Справка по переменным показывается рядом с редактором.
| Переменная | Описание |
|---|---|
title | Заголовок блока из действия «Изменить заголовок» в правилах |
link | Ссылка заголовка из того же действия |
recommended_items | Массив подобранных товаров |
Свойства каждого товара в recommended_items:
| Свойство | Описание |
|---|---|
id, name, description, url | Артикул, название, описание и ссылка на товар |
price, price_full | Цена без дробной части и с дробной частью |
price_formatted, price_full_formatted | Отформатированная цена |
oldprice, oldprice_full, oldprice_formatted, oldprice_full_formatted | Старая цена в тех же вариантах |
discount, discount_formatted | Размер скидки |
currency | Символ валюты |
image_url | Ссылка на оригинальное изображение |
image_url_resized | Изображения с измененным размером: 120, 140, 160, 180, 200, 220, 310, 520 px. Пример: item.image_url_resized['520'] |
image_url_resized_120 | Изображение 120 × 120 px |
category_ids, categories | Идентификаторы и названия категорий |
brand, model, barcode | Бренд, модель, штрихкод |
is_new | Признак новинки |
rating | Рейтинг |
stock_quantity | Остаток на складе |
leftovers | Остаток строкой: one, few, lot |
fashion_sizes, fashion_original_sizes | Преобразованные и исходные размеры одежды |
group_id | Идентификатор группы вариантов товара |
location_ids | Локации, в которых товар есть в наличии |
sales_rate, relative_sales_rate | Оборачиваемость и относительная оборачиваемость |
Пример вывода товаров:
liquid
<div class="recommender-block-title">{{ title }}</div>
<div class="recommended-items">
{% for item in recommended_items %}
<div class="recommended-item">
<a href="{{ item.url }}"><img src="{{ item.image_url_resized['220'] }}" /></a>
<a href="{{ item.url }}">{{ item.name }}</a>
<div>{{ item.price_formatted }}</div>
</div>
{% endfor %}
</div>Если блок не подобрал ни одного товара, HTML не формируется.
Оформление и шаблон
Цвета и размеры из раздела Оформление рассчитаны на классы базового шаблона. Если меняете разметку, сохраните эти классы, чтобы оформление продолжило работать.
О получении HTML и данных блока для разработчиков — в разделе Интеграция.