Бесплатно
Загрузите дополнение из админки вашего сайта.
Как загрузить?
Автор дополнения
Руслан
Пакетов
1
Закачек
26
Автор дополнения
Пакетов
1
Закачек
26
Версия 1.1.11-pl
Дата выпуска 28.05.2020
Загрузки 26
Просмотры 1 421
Внимание, этот компонент требует версию PHP 5.6 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.4 !
КОМПОНЕНТ НЕ КОНФЛИКТУЕТ С ДРУГИМИ КОМПОНЕНТАМИ БОНУСОВ И УДАЧНО ИХ ДОПОЛНЯЕТ

Интересная и очень полезная статья про правильное использование бонусной программы www.retail.ru/rbc/pressreleases/pervaya-sistema-bonusnaya-sistema-skidok/

Компонент маркетинга(реферально-бонусная система основанная на кешбэке собственной монетой твоего магазина и персональных промокодах для учета рефералов от количества которых зависит индивидуальный процент кешбэка) приводящего клиентов для магазинов основанных на miniShop2 — msReferralProgramCoin

По просьбам пользователей добавлено:
  • В контекстное меню списка товаров добавлены пункты массовой установки и снятия флага участия товара в бонусной программе у выбранных в этом списке товаров
  • Две настройки приветственного бонуса при регистрации:
    1. Само количество бонусных монет зачисляемых на баланс покупателя при регистрации (по умолчанию 0).
    2. Флаг зачисления приветственных бонусов только в том случае если введен валидный промокод пригласившего, что усилит мотивацию ввода промокода пригласившего!

  • Для простоты установки и контроля флаг участия товара в бонусной программе кешбэка добавлен в саму таблицу товаров в дополнение к чекбоксу на вкладке «Свойства товара».
  • Массовое ручное начисление/списание бонусных монет с баланса пользователей.
  • В компонент добавлен пересчет бонусов к начислению и списанию и соответственно пересчет общей суммы заказа с учетом списываемых бонусных монет и стоимости доставки при редактировании заказа в панели управления сайтом!
  • Добавлена настройка количественного отношения бонусной монеты к валюте магазина с показом пользователю сколько одной единице бонусной монеты будет приходиться частей(1, 0.1, ...) валюты магазина.
в версии 1.2.0 будет добавлено:
  • Регистрация по рефссылке в дополнение к уже имеющейся регистрации по персональному промокоду пригласившего.

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

Уточнение по механизму начисления и списания монет с новыми возможностями:
  • В последней версии 1.1.6 добавлена кратность монет т.е. если в настройке прописать 100 то 1 коин будет стоить 0.01 валюты магазина, и если у покупателя установлен процент кешбэка 3% и покупка на $1000(товарами отмеченными для участия в бонусной) то ему на баланс придет 3000 монет.
  • Оплата корзины идет по настроенному максимальному проценту оплаты корзины т.е. если настроено, что монетами можно оплатить 30% корзины то при покупке на $10 с установленным чекбоксом оплаты монетами сумма заказа станет $7 и на балансе останется 2700 монет из предыдущего пункта.
  • Приветственные монеты можно добавить в панели управления сайтом, но, думаю в версии 1.1.7 добавлю настройку в которой можно внести количество приветственных бонусов при регистрации ;)
  • Статусов золотой, платиновый… нет, но можно доработать за доп оплату.
  • Название монеты сам придумываете в настройках.

ReferralProgramCoin — реферально-бонусная система основанная на кешбэке собственной монетой твоего магазина и персональных промокодах:

  1. Название вашей бонусной монеты (прописывается в системных настройках) вы придумываете сами.
  2. Устанавливаете сами максимальный процент (прописывается в системных настройках) от суммы заказа который покупатель может оплатить бонусными монетами.
  3. Отмечаете товары с суммы покупок которых вычисляется кешбэк возвращаемый вашей бонусной монетой на бонусный баланс покупателя.
  4. Устанавливаете сами стартовый процент кешбэка (прописывается в системных настройках) от суммы покупок товаров (с которых разрешено возвращать кешбэк) возвращаемый бонусными монетами на бонусный баланс покупателя.
  5. В панели управления сайтом вы можете каждому покупателю индивидуально устанавливать процент кешбэка (например в зависимости от суммы его покупок или от количества(это количество вы будете видеть там-же в панели управления сайтом непосредственно в строке данных покупателя с возможностью отсортировать по нему список покупателей) привлеченных им покупателей по своему промокоду.
  6. Покупатель делится своим персональным красивым и защищенным от подделки промокодом привязывая тем самым пришедших покупателей к себе в рефералы по количеству которых менеджер сайта принимает решение увеличить индивидуальный процент кешбека этого покупателя.
  7. Промокод покупателя нигде не хранится, а генерируется динамически из идентификатора пользователя в базе данных сайта и его времени создания в этой базе, что исключает случайный ввод случайным пользователем валидного промокода! И такой промокод выглядит удобочитаемым и удобно вводимым так как первая буква названия вашей монеты используется в качестве первой буквой промокода как декорация и не важно на каком языке она будет введена покупателем пришедшем поэтому промокоду так как при разборе названия промокода для поиска его владельца первая буква не участвует. Пример промокода монеты Viscoin — V16R25 и как вы уже догадались при вводе промокода за владельцем этого промокода закрепляется этот покупатель, что может сыграть важную роль при установке владельцу этого промокода индивидуального процента кешбэка.
  8. Вы сами выбираете на каких статусах заказов учитывать и на каких статусах заказов списывать кешбэк(бонусы) на бонусном балансе покупателя который рассчитывается «на лету»(динамически за миллисекунды).
  9. А так-же в панели управления сайтом вы можете независимо от заказов добавить или списать произвольное количество бонусных монет с бонусного баланса покупателя.
  10. В панели управления сайтом на странице компонента «Управление кешбэком» в сортировку по рейтингу(количеству приглашенных) включаются покупатели которые привели более одного реферала.
  11. Покупатель может произвести оплату заказа с использованием монет. Оплата монетами происходит в один клик, модуль самостоятельно рассчитывает число монет. Покупатель может отменить оплату монетами если передумал также одним кликом.
  12. И самое главное — установка и настройка компонента ОЧЕНЬ простая(нет необходимости лезть в сниппеты и чанки корзины и менять там что-то по сложной инструкции, а добавить нужный сниппет на нужную страницу и всё!):
  • на странице корзины для возврата кешбэка монетами на баланс покупателя и добавления механизма оплаты корзины монетами
  • на странице товара для показа количества получаемых монет с покупки бонусного товара по индивидуальному проценту кешбэка пользователя
  • на странице бонусной или профиля пользователя для показа информации по балансу и другой информации этой программы.


Внимание! Компонент работает только с miniShop2 версии 2.4.14 и выше! На нижних версиях будут проблемы из-за отсутствия события msOnBeforeSaveOrder.

СКАЧАТЬ


БЫСТРЫЙ СТАРТ

1. Настройки пространства имен msreferralprogramcoin


Название: URL коннектора
Ключ: msrpc_connector_url
Значение по умолчанию: [[+assetsBasePath]]connector.php
Даёт возможность подключить свой обработчик Ajax запросов от форм компонента.


Название: URL для подключаемых стилей
Ключ: msrpc_css_url
Значение по умолчанию: [[+cssBasePath]]main.css
Даёт возможность подключить свой css-файл стилей.


Название: URL для подключаемого файла js
Ключ: msrpc_js_url
Значение по умолчанию: [[+jsBasePath]]web/msrpcincluder.js
Даёт возможность подключить свои js-скрипты.


Название: Начальный процент начисления бонусных монет
Ключ: msrpc_default_pr_payroll_coins
Значение по умолчанию: 3
Стартовый процент кешбэка(возврат бонусной монетой части суммы покупок бонусных товаров) по умолчанию (администратор(менеджер) в панели управления сайтом имеет возможность поменять процент конкретному пользователю посмотрев по нему например количество привлеченных им пользователей) при регистрации нового пользователя или при вступлении в бонусную программу если пользователь зарегистрировался до установки компонента.


Название: Максимальный процент оплаты корзины бонусными монетами
Ключ: msrpc_max_pr_cart_paid_by_coins
Значение по умолчанию: 30
Максимальный процент суммы корзины которую можно оплатить набранными бонусными монетами.


Название: Статусы заказов зачисления бонусных монет
Ключ: msrpc_order_statuses_for_inc_coins
Значение по умолчанию: 3
Статусы заказов на которых начисленные этими заказами бонусные монеты учитываются на балансе пользователя(баланс рассчитывается на лету(динамически)).
По умолчанию статус «Доставляется» т.е. если будет другой статус включая «Отменен» монеты начисленные этим заказом не будут включаться в баланс пользователя.


Название: Статусы заказов списания бонусных монет
Ключ: msrpc_order_statuses_for_dec_coins
Значение по умолчанию: 1,2,3
Статусы заказов на которых списанные этими заказами бонусные монеты учитываются в механизме списания с баланса пользователя(баланс рассчитывается на лету(динамически)).
По умолчанию статус «Отменен» исключен из механизма списания т.е. на этом статусе монеты списываемые этим заказом не будут списываться с баланса пользователя.


Название: Название бонусной монеты
Ключ: msrpc_name_bonus_coin
Значение по умолчанию: Coin
Название бонусной монеты — это название будет использоваться везде где идет речь о бонусной монете.


Название: Отношение монеты к валюте магазина
Ключ: msrpc_ratio_of_coins
Значение по умолчанию: 1
Отношение(делитель(целое число)) бонусной монеты при использовании которого реализуется количественное отношение бонусной монеты к валюте магазина. Например если делитель = 10 тогда 1 бонусная монета = 0,1 валюты магазина.


Название: Количество приветственных монет
Ключ: msrpc_welcome_coins_for_registration
Значение по умолчанию: 0
Введите количество(целое число) монет зачисляемых пользователю при регистации или 0.


Название: Приветственные монеты только с промокодом
Ключ: msrpc_welcome_coins_if_promocode
Значение по умолчанию: Нет
Установите «Да» если необходимо начислять приветственные монеты при регистрации только если введен валидный промокод.


ФОРМИРОВАНИЕ И ИСПОЛЬЗОВАНИЕ НАЗВАНИЯ ПРОМОКОДА
(ВАЖНО! НИКАКИХ ОТДЕЛЬНЫХ ТАБЛИЦ ИЛИ ПОЛЕЙ ХРАНЕНИЯ СВЯЗЕЙ ПРОМОКОДА И ЕГО ВЛАДЕЛЬЦА ПРИ ТАКОМ ПОДХОДЕ НЕ ТРЕБУЕТСЯ!):


  • ради декоративного эффекта берется первая буква названия бонусной монеты(не важно на каком языке она будет так как при разборе названия промокода для поиска пользователя(чей промокод) первый символ из названия промокода будет удален);
  • к первой букве названия монеты добавляется id пользователя(чей промокод) из таблицы modUser;
  • к полученной в первых двух шагах строке добавляется буква R(в качестве отделителя окончания названия);
  • после буквы R(не важно в каком регистре будут пользователи её вводить равно как и первую букву названия промокода) добавляется две цифры таймштампа(createdon) пользователя(чей промокод) из таблицы modUser.
  • При вводе промокода пришедшим пользователем для проверки введенного промокода на реальное его существование берется число до буквы R и в таблице modUser ищется пользователь по id равным полученному числу и если пользователем с этим id найден проверяются две последние цифры таймштампа(createdon) на соответствие оставшимся после буквы R символам названия промокода и если они идентичны то промокод считается валидным и пришедший пользователь закрепляется за владельцем введенного промокода как его реферал.


2. Установка сниппета информации по бонусной программе текущего пользователя
(например на отдельную страницу бонусной программы или на отдельную страницу профиля пользователя или разнести частями информацию по разным вкладкам профиля пользователя)


Необходимо перетащить сниппет msReferralProgramCoin в нужное место контекста ресурса или прописать его там таким образом(так как в нём имеются настройки по умолчанию):

[[!msReferralProgramCoin?]]


  • частично на одной вкладке профиля выводим в низу данных сниппета количество рефералов без списка имён рефералов(убираем &tplItem=`msrpcItem`) и формы ввода промокода реферера(убираем &tplForm):
    [[!msReferralProgramCoin?
        &tplItem=`0`
        &tplForm=`0`
    ]]
  • частично на другой вкладке выводим только список имен рефералов обёрнутый в список с надписью количества рефералов:
    [[!msReferralProgramCoin?
        &tplBalance=`0`
        &tplPromo=`0`
        &tplForm=`0`
    ]]
  • частично на третьей вкладке выведем форму ввода промокода реферера:
    [[!msReferralProgramCoin?
        &tplBalance=`0`
        &tplPromo=`0`
        &tplItem=`0`
        &tplList=`0`
    ]]


3. Включение товара в бонусную программу


В панели управления сайтом в форме редактирования товара на вкладке «Свойства товара» необходимо установить флаг «Участвует в бонусной программе» для участия этого товара в бонусной программе кешбэка.


4. (необязательно)Установка поля ввода промокода при регистрации пользователя


Необходимо перетащить сниппет msrpcInputReferrerPromoCode в нужное место формы или чанка регистрации или прописать его там таким образом(так как в нём имеются настройки по умолчанию):

[[!msrpcInputReferrerPromoCode?]]

Пример использования в чанке формы регистрации для компонента Login:
[[!+reg.error.msrpc_referrer_promocode]]
[[!msrpcInputReferrerPromoCode?]]


5. Установка индивидуального процента кешбэка пользователям в панели управления сайтом и ручное добавление и списание бонусных монет с баланса пользователя(или выбранных пользователей)


Необходимо зайти в раздел менеджера сайта «Пакеты/Управление кешбэком» и откроется страница «Управление балансом».

В данном интерфейсе вы можете редактировать в самой ячейке(двойной клик на ней) процент кешбэка(нулевое значение — использование процента по умолчанию) и добавлять или списывать монеты с баланса пользователя(или выбранных пользователей) в окне открываемом по клику на меню «Добавить или списать монеты» в выпадающем меню по клику правой кнопкой мыши на нужной строке.


6. Установка сниппета корзины


Необходимо прописать вывод сниппета

[[!msrpcCart]]
в нужном месте на странице корзины (есть возможность передать свои чанки по структуре чанков msrpcCart.tpl и msrpcCartInfo.tpl
[[!msrpcCart?
    &tpl=`свой чанк`
    &tplInfo=`свой чанк инфо`
]]
)


7. Установка сниппета информации в карточке товара о количестве полученных монет при покупке этого товара


Необходимо прописать вывод сниппета

[[!msrpcProduct]]
в нужном месте шаблона товара (есть возможность передать свой чанк по структуре чанка msrpcProduct.tpl
[[!msrpcProduct?
    &tpl=`свой чанк`
]]
и возможность передать непосредственно цену для расчета монет
[[!msrpcProduct?
    &price=(ваша цена)
]]
(например вычисляя цену другим сниппетом
[[!msrpcProduct?
    &price=[[!getPrice?
               &id=[[*id]]
           ]]
]]
))


8. Вывод информации о начислении и списании бонусных монет в заказе


Для вывода информации о списанных монетах и монетах к начислению по текущему заказу необходимо в любое место шаблона заказа вставить сниппет

[[!msrpcOrder]]
(есть возможность передать свой чанк по структуре чанка msrpcOrderInfo.tpl
[[!msrpcOrder?
    &tpl=`свой чанк`
]]
)

Если вы выводите заказы списком своим сниппетом и своим чанком то для вывода количества списанных монет необходимо выводить поле msrpc_payroll_dec из массива данных заказа как родное поле таблицы заказов и аналогично поле монет к начислению — msrpc_payroll_inc

СКАЧАТЬ

1.1.11-pl - (28.05.2020)

  • Добавлен пересчет списываемых монет при оплате монетами при удалении товара из корзины

1.1.9-pl - (23.05.2020)

  • В контекстное меню списка товаров добавлены пункты массовой установки и снятия флага участия товара в бонусной программе у выбранных в этом списке товаров

1.1.8-pl - (20.05.2020)

  • Для простоты установки и контроля флаг участия товара в бонусной программе кешбэка добавлен в саму таблицу товаров в дополнение к чекбоксу на вкладке "Свойства товара"
  • Добавлено массовое ручное начисление/списание бонусных монет с баланса пользователей

1.1.7-pl - (18.05.2020)

  • Добавлены две настройки приветственного бонуса при регистрации:
    1. Само количество бонусных монет зачисляемых на баланс покупателя при регистрации (0 по умолчанию).
    2. Флаг зачисления приветственных бонусов только в том случае если введен валидный промокод пригласившего, что усилит мотивацию ввода промокода пригласившего!
  • Поправлен показ списываемых монет в корзине

1.1.6-pl - (13.05.2020)

  • Поправлен показ количества монет при настройке кратности монет

1.1.5-pl - (11.05.2020)

  • Добавлена настройка количественного отношения бонусной монеты к валюте магазина с показом пользователю сколько одной единице бонусной монеты будет приходиться частей(1, 0.1, ...) валюты магазина

1.1.4-pl - (11.05.2020)

  • В компонент добавлен пересчет бонусов к начислению и списанию и соответственно пересчет общей суммы заказа с учетом списываемых бонусных монет и стоимости доставки при редактировании заказа в панели управления сайтом!

1.1.3-pl - (09.05.2020)

  • Исправлен ресолвер создания допполей таблиц при установке компонента

1.1.2-pl - (07.05.2020)

  • Добавлено подключение лексикона для флага участия товара в программе

1.1.1-pl - (28.04.2020)

  • Добавлено Ajax обновление информации о списываемых и начисляемых монетах в сниппете для корзины при изменении состава корзины

1.1.0-pl - (27.04.2020)

  • Добавлен механизм начисления и списания монет в корзине и сниппет для выбора покупателем оплаты или не оплаты монетами и показа информации по монетам
  • Добавлен сниппет для карточки товара показывающий количество монет кешбэка по текушему индивидуальному проценту на товары участвующие в программе
  • Добавлен сниппет для страницы заказа показывающий информацию по списанным и начисленным монетам

1.0.2-beta - (20.04.2020)

  • Добавлена возможность установки индивидуального процента кешбэка прямо в ячейке таблицы и окно ручного начисления и списания монет
  • Добавлена возможность включать и исключать участие товара в программе установкой флага "Участвует в бонусной программе" на странице редактирования товара на вкладке "Свойства товара"

1.0.1-beta - (15.04.2020)

  • Добавлена страница компонента в менеджере для установки индивидуального процента кешбэка

1.0.0-beta - (15.04.2020)

  • Базовая версия 1.0.

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