1. Введение

Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе UMI.CMS 2.9.2.

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

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

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

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

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

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

  1. Получите модуль с лицензией UMI.CMS (или привяжите) на странице UMI.Market.
  2. Установите UMI.CMS, указав в инсталляторе лицензионный ключ с привязанным модулем. Модуль автоматически установится вместе с системой. Либо просто обновите уже установленную систему - по завершению обновления модуль появится в системе.

4. Установка блоков рекомендаций и трекинга событий в шаблоны

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

4.1. XSLT-шаблон

 

  • templates/demodizzy,
  • Современный
  1. Переместите с заменой файлы из директории templates/demodizzy в соответствующую директорию templates/demodizzy (текущий используемый шаблон дизайна).
  2. Добавьте в файл вашего шаблона templates/demodizzy/xslt/layouts/default.xsl перед </body> строчку: 

    <xsl:apply-templates select="document('udata://rees46/view')/udata" mode="rees46-init" />
  3. Добавьте в файл templates/demodizzy/xslt/default.xsl перед </xsl:stylesheet> строчку: 

    <xsl:include href="modules/rees46/common.xsl" />
  4. Зайдите в панель управления модулями (Меню Модули => Конфигурация => вкладка Модули).
  5. Введите в поле "Путь до инсталляционного файла" classes/modules/rees46/install.php
  6. Нажмите на кнопку "Установить". После инсталляции модуль должен появится в самом низу списка модулей (REES46 коннектор).
  7. Перейдите в Модули => REES46 коннектор и в поле "Идентификатор магазина" введите ключ, полученный при регистрации магазина на сайте rees46.com.
  8. Перейдите в Модули => Пользователи, нажмите на иконку редактирования пользователя Гость, поставьте галочку "Просмотр рекомендаций" модуля REES46 коннектор. Галка "Права на использование" стоять не должна.
  9. Установите права на просмотр требуемым вам пользователям и группам пользователей (всем).
  10. Настройте блоки с рекомендациями (рекоммендеры). Рекоммендеры подключаются в xslt-файлы текущей используемой темы кодом. Конкретное место для вставки кода на странице выбирается вами самостоятельно исходя из текущего шаблона дизайна:

    <xsl:call-template name="rees46-recommender">
    	<xsl:with-param name="type">recently_viewed</xsl:with-param>
    </xsl:call-template>
    <xsl:call-template name="rees46-recommender">
    	<xsl:with-param name="type">also_bought</xsl:with-param>
        <xsl:with-param name="item"><xsl:value-of select="page/@id"/></xsl:with-param>
    </xsl:call-template>

    "Недавно просмотренные" – заголовок блока с рекомендациями.

    recently_viewed – тип рекомендаций. Возможные типы рекомендаций:

    • interesting – возможно, вам это понравится.
    • also_bought – с этим товаром покупают.
    • similar – похожие товары.
    • popular – популярные товары.
    • see_also – не забудьте посмотреть.
    • recently_viewed – вы недавно смотрели.
    • buying_now - прямо сейчас покупают.

Важно установить максимальное количество блоков из предложенных. Может возникнуть соблазн поставить только 1-2 блока, потому что "не хочется портить дизайн". В этом случае помните: 1-2 блока не могут работать эффективно. Для достижения максимального эффекта блоки должны быть расположены по рекомендованной схеме:

4.2. TPL-шаблон

 

  • templates/demoold,
  • Классический
  1. Переместите с заменой файлы из директории templates/demoold в соответствующую директорию templates/demoold (текущий используемый шаблон дизайна)
  2. Зайдите в панель управления модулями (Меню Модули => Конфигурация => вкладка Модули)
  3. Введите в поле "Путь до инсталляционного файла" classes/modules/rees46/install.php
  4. Нажмите на кнопку "Установить". После инсталляции модуль должен появится в самом низу списка модулей (REES46 коннектор).
  5. Перейдите в Модули => Пользователи, нажмите на иконку редактирования пользователя Гость, поставьте галочку "Просмотр рекомендаций" модуля REES46 коннектор. Галка "Права на использование" стоять не должна.
  6. Установите права на просмотр требуемым вам пользователям и группам пользователей
  7. Перейдите в Модули => REES46 коннектор, следуйте инструкциям на экране.
  8. Добавьте в файл вашего шаблона templates\demoold\tpls\content\footer.inc.tpl в самый низ файла строчку: 

    %rees46 view_tpls()%
  9. Настройте блоки с рекомендациями (рекоммендеры). Рекоммендеры подключаются в tpl-файлы текущей используемой темы кодом. Конкретное место для вставки кода на странице выбирается вами самостоятельно исходя из текущего шаблона дизайна, например: 

    %rees46 recommend_tpls('also_bought','С этим товаром покупают')%

     

     

Важно установить максимальное количество блоков из предложенных. Может возникнуть соблазн поставить только 1-2 блока, потому что "не хочется портить дизайн". В этом случае помните: 1-2 блока не могут работать эффективно. Для достижения максимального эффекта блоки должны быть расположены по рекомендованной схеме:

5. Отслеживание событий корзины

5.1 Добавление товара в корзину

Для отслеживание добавление товара в корзину необходимо добавить код указанный ниже в файл /js/client/basket.js в конец функции putElement:

REES46.pushData('cart', {item_id: id, is_available: '1'});

5.2 Удаление товара из корзины

Для отслеживания удаления товара из корзины необходимо добавить код указанный ниже в файл /js/client/basket.js в конец функции removeItem:

REES46.pushData('remove_from_cart', {item_id: id});

6. Проверка работоспособности

Пройдитесь по страницам сайта, сделайте один-два фиктивных заказа и увидите, как на ваших страницах появляются рекомендованные товары.

В случае проблем с установкой обращайтесь к нам.

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

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