1. Введение
Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе UMI.CMS 2.9.2.
2. Краткий план установки
- Зарегистрировать магазин в системе REES46.
- Установить модуль на сайт.
- Настроить модуль.
- Настроить внешний вид блоков рекомендованных товаров.
- Проверить работоспособность.
3. Пошаговая инструкция по установке
3.1 Регистрация магазина
- Перейдите на сайт http://rees46.com.
- Зарегистрируйтесь и создайте новый магазин.
- Запишите код магазина и секретный ключ (длинная бесмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46). И то и другое можно получить в разделе "Настройка магазина".
3.2 Установка модуля
- Получите модуль с лицензией UMI.CMS (или привяжите) на странице UMI.Market.
- Установите UMI.CMS, указав в инсталляторе лицензионный ключ с привязанным модулем. Модуль автоматически установится вместе с системой. Либо просто обновите уже установленную систему - по завершению обновления модуль появится в системе.
4. Установка блоков рекомендаций и трекинга событий в шаблоны
Далее в зависимости от типа используемого шаблона следуйте одной из двух инструкций:
4.1. XSLT-шаблон
Примеры шаблонов
- templates/demodizzy,
- Современный
- Переместите с заменой файлы из директории
templates/demodizzy
в соответствующую директориюtemplates/demodizzy
(текущий используемый шаблон дизайна). Добавьте в файл вашего шаблона
templates/demodizzy/xslt/layouts/default.xsl
перед</body>
строчку:<xsl:apply-templates select="document('udata://rees46/view')/udata" mode="rees46-init" />
Добавьте в файл
templates/demodizzy/xslt/default.xsl
перед</
xsl:stylesheet
>
строчку:<xsl:include href="modules/rees46/common.xsl" />
- Зайдите в панель управления модулями (Меню Модули => Конфигурация => вкладка Модули).
- Введите в поле "Путь до инсталляционного файла"
classes/modules/rees46/install.php
- Нажмите на кнопку "Установить". После инсталляции модуль должен появится в самом низу списка модулей (REES46 коннектор).
- Перейдите в Модули => REES46 коннектор и в поле "Идентификатор магазина" введите ключ, полученный при регистрации магазина на сайте rees46.com.
- Перейдите в Модули => Пользователи, нажмите на иконку редактирования пользователя
Гость
, поставьте галочку "Просмотр рекомендаций" модуля REES46 коннектор. Галка "Права на использование" стоять не должна. - Установите права на просмотр требуемым вам пользователям и группам пользователей (всем).
Настройте блоки с рекомендациями (рекоммендеры). Рекоммендеры подключаются в 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,
- Классический
- Переместите с заменой файлы из директории templates/demoold в соответствующую директорию templates/demoold (текущий используемый шаблон дизайна)
- Зайдите в панель управления модулями (Меню Модули => Конфигурация => вкладка Модули)
- Введите в поле "Путь до инсталляционного файла"
classes/modules/rees46/install.php
- Нажмите на кнопку "Установить". После инсталляции модуль должен появится в самом низу списка модулей (REES46 коннектор).
- Перейдите в Модули => Пользователи, нажмите на иконку редактирования пользователя
Гость
, поставьте галочку "Просмотр рекомендаций" модуля REES46 коннектор. Галка "Права на использование" стоять не должна. - Установите права на просмотр требуемым вам пользователям и группам пользователей
- Перейдите в Модули => REES46 коннектор, следуйте инструкциям на экране.
Добавьте в файл вашего шаблона
templates\demoold\tpls\content\footer.inc.tpl
в самый низ файла строчку:%rees46 view_tpls()%
Настройте блоки с рекомендациями (рекоммендеры). Рекоммендеры подключаются в 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