Модуль для UMI.CMS - RU Документация - REES46 Manual
RU Документация
Page tree
Skip to end of metadata
Go to start of metadata

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 блока не могут работать эффективно. Для достижения максимального эффекта блоки должны быть расположены по рекомендованной схеме:

  • Главная страница (\templates\demodizzy\xslt\modules\catalog\special-offers.xsl):
    • Блок "Популярные товары" без указания категории.
  • Страница категории (\templates\demodizzy\xslt\modules\catalog\category-view.xsl, template: udata[@method = 'getObjectsList'][total]):
    • Блок "Популярные товары" сверху (с указанием категории).
    • Блок "Вы недавно смотрели" снизу.
    • Блок "Возможно вам это понравится" снизу.
  • Детальный просмотр товара (\templates\demodizzy\xslt\modules\catalog\object-view.xsl):
    • Блок "С этим товаром покупают".
    • Блок "Похожие товары".
    • Блок "Возможно вам это понравится".
  • Страница корзины (\templates\demodizzy\xslt\modules\emarket\cart.xsl):
    • Блок "Не забудьте посмотреть".

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','С этим товаром покупают')%

     


    • Страница категории: 
      • популярные товары (сверху): 
      • вы недавно смотрели (снизу): 
      • возможно, вам это понравится (снизу): 
      Детальный просмотр товара (все снизу): 
      • с этим товаром покупают: 
      • похожие товары: 
      • возможно, вам это понравится: 
      Страница корзины: 
      • не забудьте посмотреть: 
      Страница поиска :
      • популярные товары (сверху): %rees46 recommend_tpls('popular','Популярные товары')%
      • вы недавно смотрели (снизу): %rees46 recommend_tpls('recently_viewed','Вы недавно смотрели')%
      • возможно, вам это понравится (снизу): %rees46 recommend_tpls('see_also','Возможно, вам это понравится')%

     

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

  • Главная страница (templates\demoold\tpls\filtered_pages\gotw.tpl):

    • Блок "Популярные товары" без указания категории:

      %rees46 recommend_tpls('popular','Популярные товары')%
  • Страница категории (templates\demoold\tpls\catalog\default.tpl):

    • Блок "Популярные товары" сверху (с указанием категории):

      %rees46 recommend_tpls('popular','Популярные товары')%

    • Блок "Вы недавно смотрели" снизу:

      %rees46 recommend_tpls('recently_viewed','Вы недавно смотрели')%

    • Блок "Возможно вам это понравится" снизу:

      %rees46 recommend_tpls('see_also','Возможно, вам это понравится')%
  • Детальный просмотр товара (templates\demoold\tpls\catalog\default.tpl):

    • Блок "С этим товаром покупают":

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

    • Блок "Похожие товары":

      %rees46 recommend_tpls('similar','Похожие товары')%

    • Блок "Возможно вам это понравится":

      %rees46 recommend_tpls('interesting','Возможно вам это понравится')%
  • Страница корзины (templates\demoold\tpls\emarket\default.tpl):

    • Блок "Не забудьте посмотреть":

      %rees46 recommend_tpls('see_also','Возможно, вам это понравится')%
  • Страница поиска (templates\demoold\tpls\catalog\filtered.tpl):

    • Блок "Популярные товары" сверху (с указанием категории):

      %rees46 recommend_tpls('popular','Популярные товары')%

    • Блок "Вы недавно смотрели" снизу:

      %rees46 recommend_tpls('recently_viewed','Вы недавно смотрели')%

    • Блок "Возможно вам это понравится" снизу:

      %rees46 recommend_tpls('see_also','Возможно, вам это понравится')%

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

 

  • No labels