pistol88/yii2-promocode

Добавление функционала промокодов (купонов) на сайт, работает с pistol88/cart и pistol88/order

dev-master 2017-04-24 05:56 UTC

Requires

• php: >=5.4.0
• kartik-v/yii2-widget-datepicker: @dev
• pistol88/yii2-cart: *
• pistol88/yii2-order: *
• yiisoft/yii2: *
• yiisoft/yii2-bootstrap: *

BSD-3-Clause

• Ilya Pistol

• application
• coupons
• yii2
• pistol88
• yii2-promocode
• promocodes

README

Разработка модуля с 24.04.2017 ведется здесь: dvizh/yii2-promocode. Рекомендую устанавливать модуль из репозиторий Dvizh, именно там находится последняя версия.

Yii2-promocode

Добавление функционала скидок (промокодов, купонов) на сайт, стабильно работает с pistol88/cart.

Модуль умеет через Behavior динамически менять цену заказа, исходя из вида примененного купона: накопительный, "процент скидки", "сумма скидки".

Установка

Выполнить команду

php composer require pistol88/yii2-promocode "*"

Или добавить в composer.json

"pistol88/yii2-promocode": "*",

И выполнить

php composer update

Миграция:

php yii migrate --migrationPath=vendor/pistol88/yii2-promocode/migrations

Подключение и настройка

В конфигурационный файл приложения добавить модуль promocode

В targetModelList указать модели для привязки промокода

    'modules' => [
        //..
        'promocode' => [
            'class' => 'pistol88\promocode\Module',
            'informer' => 'pistol88\cart\widgets\CartInformer', // namespace to custom cartInformer widget
            'informerSettings' => [], //settings for custom cartInformer widget
            'usesModel' => 'dektrium\user\models\User', //Модель пользователей
            //Указываем модели, к которым будем привязывать промокод
            'targetModelList' => [
                'Категории' => [
                    'model' => 'pistol88\service\models\Category',
                    'searchModel' => 'pistol88\service\models\category\CategorySearch'
                ],
                'Продукты' => [
                    'model' => 'pistol88\shop\models\Product',
                    'searchModel' => 'pistol88\shop\models\product\ProductSearch'
                ],            
            ],
        ],
        //..
    ]

Использование

Чтобы управлять промокодами, нужно перейти к контроллеру модуля: ?r=promocode/promo-code

Добавление промокода для текущего пользователя:

yii::$app->promocode->enter($promocode);

Очистить текущий промокод пользователя:

yii::$app->promocode->clear()

Проверить, введен ли промокод:

if(yii::$app->promocode->has())

Получить текущий промокод:

yii::$app->promocode->getCode()

Получить процент скидки текущий:

$persent = yii::$app->promocode->get()->promocode->discount;

Чтобы скидка применялась для pistol88/cart, необходимо добавить поведение pistol88\promocode\behaviors\Discount для cart при подключении cart в конфиге:

    'cart' => [
        'class' => 'pistol88\cart\Cart',
        'as PromoDiscount' => ['class' => 'pistol88\promocode\behaviors\Discount'],
    ]

Чтобы скидка применялась для отдельных моделей необходимо добавить поведение pistol88\promocode\behaviors\DiscountToElement для cart при подключении компонента в конфиге:

    'cart' => [
        'class' => 'pistol88\cart\Cart',
        //'as PromoDiscount' => ['class' => 'pistol88\promocode\behaviors\Discount'],
        'as ElementDiscount' => ['class' => 'pistol88\promocode\behaviors\DiscountToElement'],
    ]

Виджеты

Вывод формы ввода промокода для пользователя:

Целую, пока!