README

添加功能以在网站上提供折扣（促销代码、优惠券），稳定与 dvizh/cart 一起工作。

该模块可以通过行为动态更改订单价格，根据应用的优惠券类型：累积、"百分比折扣"、"金额折扣"。

安装

执行以下命令

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，在配置中连接 cart 时，必须添加行为 dvizh\promocode\behaviors\Discount 到 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'],
    ]

小部件

向用户输出促销代码输入表单

再见，直到下一次！