# Создание нового блока
# Как создать собственный блок рекомендаций за 3 минуты?
Основная часть настроек блоков рекомендаций описана в других разделах, в этом мы пошагово покажем, как создать блок с нуля
# Первый шаг
Заходим в раздел "Блоки рекомендаций" и в правом верхнем углу нажимаем кнопку "Добавить блок", перед нами появляется следующий экран.
1. Название блока
- Придумываем названием в зависимости от задач, например "Популярные/На главной"
2. Описание блока
- Если название малоинформативно, добавляем описание
3. Количество товаров
- Количество отображаемых товаров в блоке, от 1 до 30 максимум
# Второй шаг
После мы попадаем в созданный блок и нужно будет настроить его под наши задачи
Следуем рекомендациям, копируем код и устанаваливаем его в код на сайте.
# Атрибуты
| Атрибут | Описание |
|---|---|
| block | Тип блока рекомендаций. Статичное значение - dynamic |
| code | ID блока рекомендаций. Необходимо скопировать в личном кабинете, на странице настроек блока |
| item | ID товара, который нужно передать в запросе. Обязателен для алгоритмов "Похожие товары", "С этим товаром покупают". Также нужно передавать, если в настройках используется фильтр, который проверяет товар или его свойство. |
| exclude | Список идентификаторов товаров, через запятую, которые нужно исключить из ответа. |
| category | ID категории, по которой нужно отфильтровать товары ответа. |
| categories | Список идентификаторов категорий, через запятую, по которым нужно отфильтровать товары из ответа. |
| search_query | Поисковый запрос. Обязателен для алгоритма "Искавшие это также купили" |
| brands | Список наименований брендов, через запятую, по которым нужно отфильтровать товары из ответа. |
| callback | JS функция, которая будет вызвана в случае успешного ответа. Обязательно должна быть доступна глобально. |
| error | JS функция, которая будет вызвана в случае ошибки. Обязательно должна быть доступна глобально. |
| min | Минимальное количество товаров в ответе, необходимое для того, чтобы блок был отрисован на странице. |
| lazy | Добавление атрибута data-recommender-lazy="false" выключает ленивую загрузку на уровне блока |
# Третий шаг
Для того, чтобы завершить настройку блока, необходимо настроить правила показа и внешний вид блока.
Правила показа настраиваются во вкладке "Правила", подробно об этом написано в разделе "Структура и термины".
Внешний вид блока настраивается двумя способами:
Либо через "Базовый редактор" с применением стандартного дизайна
Либо через "Текстовый редактор" с применением html и css
Оба способа описаны в разделе "Оформление".