Page tree
Skip to end of metadata
Go to start of metadata
Оглавление

1. Введение

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

Обратите внимание, что модуль быстрого подключения может не содержать весь актуальный функционал. Для более гибкого подключения рекомендуется использовать JS SDK.


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

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

3. Видео-инструкция по установке и настройке модуля

Самый простой способ провести подключение – это посмотреть данный видеоматериал и следовать инструкциям.

Обратите внимание!

Код скрипта из п.4.4.1 необходимо вставить в текущий шаблон перед закрывающим тегом </head>, а не перед закрывающим тегом </body>, как говорится в видео-инструкции.

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

Если же вы из числа суровых программистов и не признаете видео, то читайте дальше.

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

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

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

  1. Убедитесь, что установлены все последние обновления платформы Bitrix и модуля "Современный интернет-магазин (bitrix.eshop)".
  2. Перейдите в административный интерфейс вашего сайта.
  3. Зайдите в раздел "Marketplace", затем в "Каталог решений".
  4. В поле поиска введите REES46 и найдите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  5. Выполните установку.
  6. Не забудьте включить модуль.

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

4.3.1 Коды доступа

  1. Перейдите в раздел "Настройки".
  2. Перейдите в подраздел "Настройки модулей" и выберите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  3. Вставьте в текстовые поля код магазина и секретный ключ, полученные в разделе 4.1.
  4. Сохраните изменения.


4.3.2 Обмен информацией о товарах

Там же в настройках перейдите во вкладку "Расширенный YML", скопируйте предоставленный URL:


И вставьте его в соответствующее поле в настройках вашего магазина на сайте REES46:

Функция YML доступна для Битрикс версии 15.0.2 и выше.

4.4. Установка отслеживания событий

Режим правки

Обратите внимание, что большинство операций по вставке блоков рекомендаций и кода отслеживания производится в режиме правки со стороны сайта, а не интерфейса администратора.

Включается режим в верхней панели переключателем, который находится в правом углу.

4.4.1. Отредактируйте текущий шаблон

Откройте на редактирование шаблон вашего сайта и вставьте перед закрывающим тегом </head> код:

<?php if(IsModuleInstalled("mk.rees46") ):
	$APPLICATION->IncludeComponent('rees46:handler', '.default');
endif; ?>

Сохраните.

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


4.4.2. Отредактируйте шаблон компонента "Элемент каталога детально (bitrix:catalog.element)"

  1. Перейдите на страницу просмотра любого товара.
  2. Убедитесь, что режим "Правки" включен.
  3. Наведите мышь на карточку товара и подождите, пока не появится серый плавающий блок, у которого слева будет ссылка "Изменить товар", а справа шестеренка. Рядом с шестеренкой будет выпадающий список. Кликните в него и найдите в списке элемент "Элемент каталога детально (bitrix:catalog.element)". Кликните в него и выберите "Редактировать шаблон компонента". Если такого пункта нет, то выполните следующие действия:
    • выберите элемент списка "Каталог (bitrix:catalog)" и кликните "Копировать шаблон компонента".
    • в форме укажите любое имя шаблона, сохраните и, когда появится редактор кода, сохраните еще раз.
    • в итоге вы должны вернуться на просмотр страницы товара.
  4. Повторите пункт №3, пока не сможете попасть в редактирование (bitrix:catalog.element)
  5. Вставьте в шаблон bitrix:catalog.element следующий код. Обратите внимание, что код необходимо вставить в конце шаблона таким образом, чтобы он был размещён вне любого другого кода, заключённого в <? ... ?> или <?php ... ?>.
<?php if(IsModuleInstalled("mk.rees46") && $arResult["ID"]):
    $APPLICATION->IncludeComponent(
        'rees46:view-handler',
        '.default',
        array(
            'item_id' => $arResult["ID"]
        )
    );
endif ?>

Сохраните.

Обратите внимание, что в некоторых версиях 1С Битрикс переменная $arResult["ID"] может отсутствовать и вместо нее может быть переменная $ElementID либо другая. Важно в этом коде передавать именно идентификатор товара. Убедитесь в правильности имени переменной и ее существовании.

Если вы испытываете затруднения с установкой этого кода, свяжитесь с нами по адресу support@rees46.com.

4.4.3. Отредактируйте шаблон компонента "Элементы раздела (bitrix:catalog.section)"

  1. Перейдите на страницу просмотра любой категории.
  2. Убедитесь, что режим "Правки" включен.
  3. Наведите мышь на область страницы под заголовком категории и подождите пока не появится серый плавающий блок с шестеренкой справа. Рядом с шестеренкой будет выпадающий список. Кликните в него и найдите в списке элемент "Элементы раздела (bitrix:catalog.section)". Кликните в него и выберите "Редактировать шаблон компонента".
  4. Вставьте в шаблон  следующий код. Обратите внимание, что код необходимо вставить в конце шаблона таким образом, чтобы он был размещён вне любого другого кода, заключённого в <? ... ?> или <?php ... ?>.
<?php if(IsModuleInstalled("mk.rees46") && $arResult["ID"]):
    $APPLICATION->IncludeComponent(
        'rees46:category-handler',
        '.default',
        array(
            'category_id' => $arResult["ID"]
        )
    );
endif ?>

Сохраните.

Обратите внимание, что в некоторых версиях 1С Битрикс переменная $arResult["ID"] может отсутствовать и вместо нее может быть переменная $ElementID либо другая. Важно в этом коде передавать именно идентификатор категории. Убедитесь в правильности имени переменной и ее существовании.

Если вы испытываете затруднения с установкой этого кода, свяжитесь с нами.

4.5. Установка блоков рекомендаций

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

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

Проверка выполняется так:

  1. Включаете консоль разработчика в вашем браузере.
  2. Находите вкладку Network (или "Сеть"), в которой при обновлении страницы отображаются происходящие запросы.
  3. Включаете режим фильтрации только XHR-запросов.
  4. Проверяете, есть ли запросы, которые уходят на api.rees46.com.

5.1. Проверка отправки событий

  1. Перейдите на страницу просмотра товара.
  2. Убедитесь, что уходит запрос на адрес api.rees46.com/push


5.2. Проверка запроса рекомендаций

  1. Перейдите на главную страницу и убедитесь, что уходит один запрос на api.rees46.com/recommend.
  2. Перейдите на страницу категории и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  3. Перейдите на страницу товара и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  4. Перейдите на страницу корзины и убедитесь, что уходит один запрос на api.rees46.com/recommend.

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

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

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

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

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

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

8. Если вы используете систему контроля версий

Раздел для разработчиков

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

%document_root%/bitrix/components/rees46
%document_root%/include/rees46-handler.php
  • No labels