dvizh/yii2-promocode

CRUD, widget and services to give discount to clients

Yii2-promocode

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

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

Установка

Выполнить команду, _(*3)

php composer require dvizh/yii2-promocode "@dev"

Или добавить в composer.json, _(*4)

"dvizh/yii2-promocode": "@dev",

И выполнить, _(*5)

php composer update

Миграция:, _(*6)

php yii migrate --migrationPath=vendor/dvizh/yii2-promocode/src/migrations, _(*7)

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

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

В targetModelList указать модели для привязки промокода, _(*9)

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

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

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

Добавление промокода для текущего пользователя:, _(*11)

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

Очистить текущий промокод пользователя:, _(*12)

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

Проверить, введен ли промокод:, _(*13)

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

Получить текущий промокод:, _(*14)

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

Получить процент скидки текущий:, _(*15)

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

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

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

Чтобы скидка применялась для отдельных моделей необходимо добавить поведение dvizh\promocode\behaviors\DiscountToElement для cart при подключении компонента в конфиге:, _(*17)

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

Виджеты

Вывод формы ввода промокода для пользователя: =\dvizh\promocode\widgets\Enter::widget();?>, _(*18)

Целую, пока!, _(*19)