# Shop-Script (Webasyst)
# Введение
Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе Webasyst Shop-Script версии 5 и выше.
# Краткий план установки
- Зарегистрировать магазин в системе REES46.
- Установить плагин (opens new window).
- Ввести в настройки модуля данные вашего магазина.
- Включить плагин.
- Установить блоки рекомендаций.
- Проверить работоспособность.
# Пошаговая инструкция по установке
# Регистрация магазина
- Перейдите на сайт rees46.ru (opens new window).
- Зарегистрируйтесь и создайте новый магазин.
- Запишите код магазина и секретный ключ (длинная бессмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46).
# Установка модуля на сайт
- Перейдите в раздел "Инсталлер" в верхнем меню интернет-магазина.
- В левом меню перейдите в раздел "Плагины" и в выпадающем меню выберите "Shop" - плагины для магазина.
- Найдите и установите плагин "REES46: рекомендательная система".
- Если у вас не установлен плагин "Яндекс.Маркет", то его также необходимо установить. Данный плагин потребуется для создания файла списка товаров, с которым будет работать REES46.
# Первичная настройка
# Создание YML-файла
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "Яндекс.Маркет" и, если ранее настройка данного плагина не производилась, выберите основную валюту вашего интернет-магазина и при необходимости конвертацию.
- Перейдите в раздел "Импорт/экспорт". Для этого необходимо кликнуть по соответствующей ссылке в правой части текущего окна.
- В левом меню открывшейся страницы выберите плагин "Яндекс.Маркет".
- Если у вас уже есть профиль экcпорта, то создайте новый профиль с названием "REES46".
- В поле "Обновление файла" выберите "Автоматически при каждом запросе".
- В разделе "1. Выберите товары" выберите "Все товары".
- В разделе "2. Общие параметры экспорта" введите название интернет-магазина и компании, если значения не подставились автоматически. Опции "Выгружать товары с нулевым остатком", "Экспортировать каждый артикул товара как отдельную позицию" и "Выгружать скрытые категории" необходимо выключить.
- В разделе "3. Экспорт характеристик товаров" обязательными полями являются "Название" и "Наличие", поле "Описание" является рекомендуемым.
- После задания всех настроек нажмите кнопку "Экспортировать" внизу страницы и дождитесь завершения экспорта.
- По завершении экспорта перейдите по ссылке "Получить ссылку на файл", где на открывшейся странице отобразится ссылка на сформированный YML-файл.
- Скопируйте предложенную ссылку и укажите её в настройках интернет-магазина в личном кабинете на сайте REES46. Не забудьте сохранить настройки.
# Настройка плагина REES46
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "REES46: рекомендательная система".
- В поля "Код магазина" и "Секретный ключ" вставьте соответствующие значения, полученные в разделе 3.1 данной инструкции.
- Выберите способ расстановки блоков рекомендаций. Подробнее о каждом способе смотрите соответствующий раздел данной инструкции.
- Если ваш тариф REES46 предусматривает отраслевые модификации алгоритмов рекомендаций, выберите соответствующую модификацию.
- Включите плагин выбрав статус "Включен".
- Сохраните изменения.
# Установка блоков рекомендаций
Подробная инструкция по созданию и управлению блоками товарных рекомендаций находится в Товарные рекомендации.
Вы можете использовать предустановленные блоки рекомендаций или создать собственные. Настройка блоков осуществляется в личном кабинете 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, то для этого достаточно выключить плагин в настройках. Чтобы выключить плагин необходимо сделать следующее:
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "REES46: рекомендательная система".
- Выключите плагин выбрав статус "Выключен".
- Сохраните изменения.
# Удаление плагина
Для удаления плагина необходимо произвести действия в обратном порядке:
- Если вы использовали самостоятельную установку блоков, то необходимо удалить все строки, добавленные в данной инструкции.
- Удалите плагин.
- Если в процессе удаления возникли проблемы: свяжитесь с нами по адресу desk@rees46.ru.
# Если рекомендации еще не появились
Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается, и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки.
Если что-то не получается
Свяжитесь с нами по адресу desk@rees46.ru.