README

在网站上添加折扣（促销码、优惠券）功能，稳定地与 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，在配置中连接 cart 时需要添加 pistol88\promocode\behaviors\Discount 行为

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

为了将折扣应用于单独的模型，需要在配置中连接组件时添加 pistol88\promocode\behaviors\DiscountToElement 行为

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

小部件

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

暂时全部！