/yii2-promocode

CRUD, widgets and services for give discount to clients

Primary LanguagePHPApache License 2.0Apache-2.0

Yii2-promocode

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

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

Установка

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

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

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

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

И выполнить

php composer update

Миграция:

php yii migrate --migrationPath=vendor/dvizh/yii2-promocode/src/migrations

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

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

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

    '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

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

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;

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

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

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

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

Виджеты

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

Целую, пока!