1. Введение
Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе Webasyst Shop-Script версии 5 и выше.
2. Краткий план установки
- Зарегистрировать магазин в системе REES46.
- Установить плагин.
- Ввести в настройки модуля данные вашего магазина.
- Включить плагин.
- Установить блоки рекомендаций.
- Проверить работоспособность.
3. Пошаговая инструкция по установке
3.1. Регистрация магазина
- Перейдите на сайт http://rees46.com.
- Зарегистрируйтесь и создайте новый магазин.
- Запишите код магазина и секретный ключ (длинная бессмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46).
3.2. Установка модуля на сайт
- Перейдите в раздел "Инсталлер" в верхнем меню интернет-магазина.
- В левом меню перейдите в раздел "Плагины" и в выпадающем меню выберите "Shop" - плагины для магазина.
- Найдите и установите плагин "REES46: рекомендательная система".
- Если у вас не установлен плагин "Яндекс.Маркет", то его также необходимо установить. Данный плагин потребуется для создания файла списка товаров, с которым будет работать REES46.
3.3. Первичная настройка
3.3.1. Создание YML-файла
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "Яндекс.Маркет" и, если ранее настройка данного плагина не производилась, выберите основную валюту вашего интернет-магазина и при необходимости конвертацию.
- Перейдите в раздел "Импорт/экспорт". Для этого необходимо кликнуть по соответствующей ссылке в правой части текущего окна.
- В левом меню открывшейся страницы выберите плагин "Яндекс.Маркет".
- Если у вас уже есть профиль экcпорта, то создайте новый профиль с названием "REES46".
- В поле "Обновление файла" выберите "Автоматически при каждом запросе".
- В разделе "1. Выберите товары" выберите "Все товары".
- В разделе "2. Общие параметры экспорта" введите название интернет-магазина и компании, если значения не подставились автоматически. Опции "Выгружать товары с нулевым остатком", "Экспортировать каждый артикул товара как отдельную позицию" и "Выгружать скрытые категории" необходимо выключить.
- В разделе "3. Экспорт характеристик товаров" обязательными полями являются "Название" и "Наличие", поле "Описание" является рекомендуемым.
- После задания всех настроек нажмите кнопку "Экспортировать" внизу страницы и дождитесь завершения экспорта.
- По завершении экспорта перейдите по ссылке "Получить ссылку на файл", где на открывшейся странице отобразится ссылка на сформированный YML-файл.
- Скопируйте предложенную ссылку и укажите её в настройках интернет-магазина в личном кабинете на сайте REES46. Не забудьте сохранить настройки.
3.3.2. Настройка плагина REES46
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "REES46: рекомендательная система".
- В поля "Код магазина" и "Секретный ключ" вставьте соответствующие значения, полученные в разделе 3.1 данной инструкции.
- Выберите способ расстановки блоков рекомендаций. Подробнее о каждом способе смотрите соответствующий раздел данной инструкции.
- Если ваш тариф REES46 предусматривает отраслевые модификации алгоритмов рекомендаций, выберите соответствующую модификацию.
- Включите плагин выбрав статус "Включен".
- Сохраните изменения.
3.4. Установка блоков рекомендаций
Вы можете использовать предустановленные блоки рекомендаций или создать собственные. Настройка блоков осуществляется в личном кабинете REES46.
Некоторые блоки рекомендаций требуют дополнительных параметров. Ниже приведены примеры таких блоков.
3.4.1. Установка блока на странице товара
Блок на странице товара (шаблон "product.html
") требует в качестве дополнительного параметра ID товара. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-item
", в значении которого использовать переменную шаблонизатора, содержащую ID товара.
Пример:
<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-item='{$product.id}'></div>
3.4.2. Установка блока на страницу категории
Блок на странице категории (шаблон "category.html
") требует в качестве дополнительного параметра ID категории. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-category
", в значении которого использовать переменную шаблонизатора, содержащую ID категории.
Пример:
<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-category='{$category.id}'></div>
3.4.3. Установка блока на страницу поиска
Блок на странице поиска (шаблон "search.html
") требует в качестве дополнительного параметра фразу поискового запроса. Чтобы передать этот параметр необходимо в код блока добавить соответствующий атрибут "data-recommender-search_query
", в значении которого использовать переменную шаблонизатора, содержащую необходимую фразу.
Пример:
<div class='rees46-recommend' data-recommender-block='dynamic' data-recommender-code='КОД_БЛОКА_РЕКОМЕНДАЦИЙ' data-recommender-search_query='{$title}'></div>
4. Удаление плагина
4.1. Выключение плагина
Если вы решили временно не использовать REES46, то для этого достаточно выключить плагин в настройках. Чтобы выключить плагин необходимо сделать следующее:
- Перейдите в раздел "Магазин" в верхнем меню интернет-магазина.
- Откройте список установленных плагинов. Для этого необходимо кликнуть по ссылке "Плагины" в правой части открывшегося окна.
- Выберите плагин "REES46: рекомендательная система".
- Выключите плагин выбрав статус "Выключен".
- Сохраните изменения.
4.2. Удаление плагина
Для удаления плагина необходимо произвести действия в обратном порядке:
- Если вы использовали самостоятельную установку блоков, то необходимо удалить все строки, добавленные в шаблоны в п.3.4. данной инструкции.
- Удалите плагин.
- Если в процессе удаления возникли проблемы: свяжитесь с нами по адресу support@rees46.com.
5. Если рекомендации еще не появились
Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается, и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки.
Если что-то не получается
Свяжитесь с нами по адресу support@rees46.com.
6. Оформление блоков в дизайн сайта
- Войдите в личный кабинет REES46.
- В левом меню перейдите в раздел "Вид блоков рекомендаций".
- Используя возможности CSS оформите внешний вид блоков по своему усмотрению.
- Не забудьте сохранить изменения.
7. Участие в разработке модуля
REES46 является бесплатной профессиональной рекомендательной системой, цель которой – дать возможность персонализированного подхода к клиенту любому интернет-магазину. Если вы специалист в разработке модулей под WebAsyst/ShopScript и желаете улучшить модуль, отправляйте pull request в репозиторий https://github.com/rees46/rees46_webasyst.