Skip to content

Шаблоны ​

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

Шаблон определяет HTML-разметку блока рекомендаций, которую получает сайт. Шаблоны общие для проекта: один шаблон можно назначить нескольким блокам в их настройках. Если блоку шаблон не назначен, используется шаблон по умолчанию.

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

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

На странице шаблона доступны действия «Редактировать», «Сбросить до базового шаблона» и «Удалить».

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

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

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

Шаблоны пишутся на языке 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 и данных блока для разработчиков — в разделе Интеграция.