RU Документация
Page tree
Skip to end of metadata
Go to start of metadata
Оглавление

1. Введение

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

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

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

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

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

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

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

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

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

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

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

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

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

3.4. Пакетная установка блоков рекомендаций (устаревший функционал)

  1. По-умолчанию пакетный режим установки автоматически добавляет блок "Популярные товары" на главную страницу, блок "Не забудьте посмотреть" на страницу корзины и блок "Искавшие это также купили" на страницу поиска.

  2. Для установки блоков рекомендаций на страницы категорий необходимо перейти в раздел "Магазин" (верхнее меню), затем в раздел "Витрина" -> "Шаблоны". В левом списке файлов шаблона необходимо найти файл "category.html" и в самый низ данного файла скопировать следующий код, который пакетно добавит блоки "Популярные товары" (из категории), "Вам будет интересно" и "Вы недавно смотрели":

    category.html
    {shopRees46Plugin::frontendCategoryBottom()}
  3. Не забудьте сохранить изменения.

  4. Для установки блоков рекомендаций на страницы карточки товара необходимо перейти в раздел "Магазин" (верхнее меню), затем раздел "Витрина" -> "Шаблоны". В левом списке файлов шаблона необходимо найти файл "product.html" и в самый низ данного файла скопировать следующий код, который пакетно добавит блоки "Похожие", "С этим также покупают" и "Вам будет интересно":

    product.html
    {shopRees46Plugin::frontendProductBottom()}
  5. Не забудьте сохранить изменения.

3.5. Самостоятельная установка блоков рекомендаций

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

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

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

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

Пример:

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

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

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

Пример:

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

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

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

Пример:

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

4. Удаление плагина

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

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

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

4.2. Удаление плагина

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

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

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

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

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

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

6. Оформление блоков в дизайн сайта

  1. Войдите в личный кабинет REES46.
  2. В левом меню перейдите в раздел "Вид блоков рекомендаций".
  3. Используя возможности CSS оформите внешний вид блоков по своему усмотрению.
  4. Не забудьте сохранить изменения.

7. Участие в разработке модуля

REES46 является бесплатной профессиональной рекомендательной системой, цель которой – дать возможность персонализированного подхода к клиенту любому интернет-магазину. Если вы специалист в разработке модулей под WebAsyst/ShopScript и желаете улучшить модуль, отправляйте pull request в репозиторий https://github.com/rees46/rees46_webasyst.



  • No labels