# Shop-Script (Webasyst)

# Введение

Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе Webasyst Shop-Script версии 5 и выше.

# Краткий план установки

  1. Зарегистрировать магазин в системе REES46.
  2. Установить плагин (opens new window).
  3. Ввести в настройки модуля данные вашего магазина.
  4. Включить плагин.
  5. Установить блоки рекомендаций.
  6. Проверить работоспособность.

# Пошаговая инструкция по установке

# Регистрация магазина

  1. Перейдите на сайт rees46.ru (opens new window).
  2. Зарегистрируйтесь и создайте новый магазин.
  3. Запишите код магазина и секретный ключ (длинная бессмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46).

# Установка модуля на сайт

  1. Перейдите в раздел "Инсталлер" в верхнем меню интернет-магазина.
  2. В левом меню перейдите в раздел "Плагины" и в выпадающем меню выберите "Shop" - плагины для магазина.
  3. Найдите и установите плагин "REES46: рекомендательная система".
  4. Если у вас не установлен плагин "Яндекс.Маркет", то его также необходимо установить. Данный плагин потребуется для создания файла списка товаров, с которым будет работать REES46.

# Первичная настройка

# Создание YML-файла

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "Яндекс.Маркет" и, если ранее настройка данного плагина не производилась, выберите основную валюту вашего интернет-магазина и при необходимости конвертацию.
  4. Перейдите в раздел "Импорт/экспорт". Для этого необходимо кликнуть по соответствующей ссылке в правой части текущего окна.
  5. В левом меню открывшейся страницы выберите плагин "Яндекс.Маркет".
  6. Если у вас уже есть профиль экcпорта, то создайте новый профиль с названием "REES46".
  7. В поле "Обновление файла" выберите "Автоматически при каждом запросе".
  8. В разделе "1. Выберите товары" выберите "Все товары".
  9. В разделе "2. Общие параметры экспорта" введите название интернет-магазина и компании, если значения не подставились автоматически. Опции "Выгружать товары с нулевым остатком", "Экспортировать каждый артикул товара как отдельную позицию" и "Выгружать скрытые категории" необходимо выключить.
  10. В разделе "3. Экспорт характеристик товаров" обязательными полями являются "Название" и "Наличие", поле "Описание" является рекомендуемым.
  11. После задания всех настроек нажмите кнопку "Экспортировать" внизу страницы и дождитесь завершения экспорта.
  12. По завершении экспорта перейдите по ссылке "Получить ссылку на файл", где на открывшейся странице отобразится ссылка на сформированный YML-файл.
  13. Скопируйте предложенную ссылку и укажите её в настройках интернет-магазина в личном кабинете на сайте REES46. Не забудьте сохранить настройки.

# Настройка плагина REES46

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "REES46: рекомендательная система".
  4. В поля "Код магазина" и "Секретный ключ" вставьте соответствующие значения, полученные в разделе 3.1 данной инструкции.
  5. Выберите способ расстановки блоков рекомендаций. Подробнее о каждом способе смотрите соответствующий раздел данной инструкции.
  6. Если ваш тариф REES46 предусматривает отраслевые модификации алгоритмов рекомендаций, выберите соответствующую модификацию.
  7. Включите плагин выбрав статус "Включен".
  8. Сохраните изменения.

# Установка блоков рекомендаций

Подробная инструкция по созданию и управлению блоками товарных рекомендаций находится в Товарные рекомендации.

Вы можете использовать предустановленные блоки рекомендаций или создать собственные. Настройка блоков осуществляется в личном кабинете REES46.

Некоторые блоки рекомендаций требуют дополнительных параметров. Ниже приведены примеры таких блоков.

# Установка блока на странице товара

Блок на странице товара (шаблон "product.html") требует в качестве дополнительного параметра ID товара. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-item", в значении которого использовать переменную шаблонизатора, содержащую ID товара.

<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-item='{$product.id}'></div>

# Установка блока на страницу категории

Блок на странице категории (шаблон "category.html") требует в качестве дополнительного параметра ID категории. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-category", в значении которого использовать переменную шаблонизатора, содержащую ID категории.

<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-category='{$category.id}'></div>

# Установка блока на страницу поиска

Блок на странице поиска (шаблон "search.html") требует в качестве дополнительного параметра фразу поискового запроса. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-search_query", в значении которого использовать переменную шаблонизатора, содержащую необходимую фразу.

<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-search_query='{$title}'></div>

# Удаление плагина

# Выключение плагина

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

  1. Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
  2. Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
  3. Выберите плагин "REES46: рекомендательная система".
  4. Выключите плагин выбрав статус "Выключен".
  5. Сохраните изменения.

# Удаление плагина

Для удаления плагина необходимо произвести действия в обратном порядке:

  1. Если вы использовали самостоятельную установку блоков, то необходимо удалить все строки, добавленные в данной инструкции.
  2. Удалите плагин.
  3. Если в процессе удаления возникли проблемы: свяжитесь с нами по адресу desk@rees46.ru.

# Если рекомендации еще не появились

Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается, и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки.

Если что-то не получается

Свяжитесь с нами по адресу desk@rees46.ru.