dvizh / yii2-promocode
CRUD, widget and services to give discount to clients
This package's canonical repository appears to be gone and the package has been frozen as a result.
Installs: 1 644
Dependents: 4
Suggesters: 0
Security: 0
Stars: 6
Watchers: 5
Forks: 4
Open Issues: 2
Type:yii2-extension
Requires
- php: >=5.4.0
- kartik-v/yii2-widget-datepicker: @dev
- yiisoft/yii2: *
- yiisoft/yii2-bootstrap: *
This package is not auto-updated.
Last update: 2024-09-29 01:22:49 UTC
README
Добавление функционала скидок (промокодов, купонов) на сайт, стабильно работает с 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'], ]
Виджеты
Вывод формы ввода промокода для пользователя:
Целую, пока!