Версия 2.2.3-pl
Дата выпуска 16.09.2018
Загрузки 127
Просмотры 3 566
Внимание, этот компонент требует версию PHP 5.6 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.5 !
Модуль для интеграции популярного сервиса RetailCRM с MODX.

Ключевые особенности
  1. Плагин срабатывающий на событие onUserSave, автоматически создает новый контакт в CRM при регистрации нового пользователя в MODX. Данное событие срабатывает в том числе при оформлении заказа в интернет-магазине.
  2. Плагин срабатывающий на событие msOnCreateOrder, автоматические создает новый заказ в CRM при оформлении заказа в MiniShop2
  3. Дополнение основано на собственной библиотеке RetailCRM и в ручном режиме поддерживает ВЕСЬ функционал доступный через API RetaiCRM

Для любителей кастомизировать функционал сайта\интернет-магазина под собственные нужды это означает, что вы можете как угодно взаимодействовать с CRM, оперируя любыми данными.
Для этого доступны десятки методов.
Достаточно Вызвать приложение и указать нужны метод

Например:

//Вызываем приложение
if (!$modx->getService('modretailcrm','modRetailCrm', MODX_CORE_PATH.'components/modretailcrm/model/modretailcrm/')) {  
    $modx->log(1, '[RetailCrm] - Not found class RetailCrm');
    return;
}

$pdo = $modx->getService('pdoFetch');

$site = $modx->getOption('modretailcrm_siteCode');
$apiKey = $modx->getOption('modretailcrm_apiKey');
$crmUrl = $modx->getOption('modretailcrm_url');

$modRetailCrm = new modRetailCrm($modx, $apiKey, $crmUrl, $site);

//Получаем список всех заказов одного клиента из CRM
$filters = array();
$filter['customer'] = '+7 701 987 65 43';
$orders = $modRetailCrm->request->ordersList($filter);
//Массив $filters - позволяет фильтровать данные, указав, например, номер или Имя клиента.

//Создаем новый контакт
$customer = array();
$customer['firstName'] = 'Федор';
$customer['lastName'] = 'Бондарчук';
$customer['email'] = 'mail@mail.ru';
$customer['phones'][]['number'] =  '+7 701 987 65 43';
$modRetailCrm->request->customersCreate($customer);


Все доступные методы и их параметры вы можете просмотреть в API RetaiCRM. У Сервиса отличная документация.

Основное преимущество — гибкость в разработке


Главная идея — в том, что мы можем используя существующую библиотеку, передавать в CRM любые данные с сайта, и наоборот получать любую информацию из CRM. Возможности очень гибкие. Мы никак не привязаны к MiniShop2, например.
Можно написать собственные сниппеты и плагины работающие с ShopKeeper.
Совсем не обязательно вообще привязываться к интернет-магазинам.
Совсем простой сниппет позволит создавать в CRM контакт при заполнении классической контактной формы на сайте (пример я написал выше).

Предварительная настройка


Естественно у вас должен быть аккаунт в RetailCRM.
В системных настройках сайта (раздел modretailcrm) Вам нужно указать
  1. API ключ. Получите его в RetailCRM — Настройки — Интеграция — Ключи доступа к API
  2. адрес вашей CRM
  3. символьный код сайта
Все эти данные Вы можете посмотреть в личном кабинете в разделе настройки — магазины

Больше примеров на modx.pro

История modRetailCRM 2.2.3 - (16.08.2018)

  • Исправлена ошибка с падением сайта при заполненном API KEY и пустом URL CRM

2.2.2 - (23.08.2018)

  • Исправлена ошибка разбиения имени на ФИО
  • Добавлена подсказка для получения модификаций msOptionsPrice

2.2.1 - (11.06.2018)

  • В выгрузку заказов добавлен передача способа доставки и способа оплаты

2.2.0 - (10.06.2018)

  • В объект msDelivery, добавлено дополнительное поле retailcrm_delivery_code, позволяющее указать символьный код доставки из настроек retailCRM, что дает возможность передавать способ доставки при заказе.
  • В объект msPayment, добавлено дополнительное поле retailcrm_payment_code, позволяющее указать символьный код способа оплаты из настроек retailCRM, что дает возможность передавать способ оплаты при заказе.

2.1.0 - (1.06.2018)

  • Отключена передача способа доставки и оплаты и за ошибки на стороне RetailCRM
  • Исправлена передача общей стоимости нескольки разных тоаров
  • Добавлена передача стоимости доставки
  • Добавлена передача веса товара
  • Добавлено разбинение Строки ФИО на отдельные поля
  • Добавлена проверка на существование пользователя на стороне RetailCRM

2.0.0-beta - (19.11.2017)

  • Базовая версия 2.0.
  • Полностью переписанный компонент

Последние обсуждения в сообществе MODX.pro