pistol88/yii2-cart

yii2-cart it's a simple cart module to collect application models, that implement cart interface + widgets

Внимание!

Разработка модуля с 24.04.2017 ведется здесь: dvizh/yii2-cart. Рекомендую устанавливать модуль из репозитория Dvizh, именно там находится последняя версия., _(*1)

Yii2-cart

Это модуль корзины для Yii2 фреймворка. Позволяет добавить в корзину любую модель, имплементирующую интерфейс pistol88\cart\interfaces\CartElement, _(*2)

, _(*3)

Для добавления функционала заказа можно использовать этот модуль: pistol88/yii2-order., _(*4)

Установка

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

php composer require pistol88/yii2-cart "*"

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

"pistol88/yii2-cart": "*",

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

php composer update

Далее, мигрируем базу:, _(*8)

php yii migrate --migrationPath=vendor/pistol88/yii2-cart/migrations

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

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

    'components' => [
        'cart' => [
            'class' => 'pistol88\cart\Cart',
            'currency' => 'р.', //Валюта
            'currencyPosition' => 'after', //after или before (позиция значка валюты относительно цены)
            'priceFormat' => [2,'.', ''], //Форма цены
        ],
        //...
    ]

И модуль (если хотите использовать виджеты), _(*10)

    'modules' => [
        'cart' => [
            'class' => 'pistol88\cart\Module',
        ],
        //...
    ]

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

Можно добавлять в корзину элементы самостоятельно через компонент, а можно использовать готовые виджеты. Пример эктиона, добавляющего товар в корзину:, _(*11)

//use...
class ProductController extends Controller
{
    public function actionAddToCart($id)
    {
        //Любая модель
        $model = $this->findModel($id);
        //Кладем ее в корзину (в количестве 1, без опций)
        $cartElement = yii::$app->cart->put($model, 1, []);
    }
}

Положить в корзину можно любую модель, имплемементирующую интерфейс CartElement. Пример модели:, _(*12)

//...
class Product extends ActiveRecord implements \pistol88\cart\interfaces\CartElement
{
    //..
    public function getCartId()
    {
        return $this->id;
    }

    public function getCartName()
    {
        return $this->name;
    }

    public function getCartPrice()
    {
        return $this->price;
    }

    //Опции продукта для выбора при добавлении в корзину
    public function getCartOptions()
    {
        return [
            '1' => [
                'name' => 'Цвет',
                'variants' => ['1' => 'Красный', '2' => 'Белый', '3' => 'Синий'],
            ],
            '2' => [
                'name' => 'Размер',
                'variants' => ['4' => 'XL', '5' => 'XS', '6' => 'XXL'],
            ]
        ];
    }
    //..
}

Получить элементы корзины:, _(*13)

//...
$elements = yii::$app->cart->elements;

Виджеты

В состав модуля входит несколько виджетов. Все работают аяксом., _(*14)

= BuyButton::widget([
    'model' => $model,
    'text' => 'Заказать',
    'htmlTag' => 'a',
    'cssClass' => 'custom_class'
]) ?>


= CartInformer::widget(['htmlTag' => 'a', 'offerUrl' => '/?r=cart', 'text' => '{c} на {p}']); ?>


= TruncateButton::widget(); ?>

 ElementsList::TYPE_FULL) элементами списка.
Можно передать перечень дополнительных полей через otherFields (['Остаток' => 'amount']).
*/
?>
=ElementsList::widget(['type' => ElementsList::TYPE_DROPDOWN]);?>


=DeleteButton::widget(['model' => $item]);?>


=ChangeCount::widget(['model' => $item]);?>
 ChangeOptions::TYPE_RADIO) */ ?>
=ChangeOptions::widget(['model' => $item]);?>

Скидки

Скидки реализуются через поведение и(или) событие. Корзине можно присвоить любое поведение (в конфиге):, _(*15)

        'cart' => [
            'class' => 'pistol88\cart\Cart',
            //...
            'as discount' => [
                'class' => 'pistol88\cart\behaviors\Discount',
                'percent' => 50,
            ],
        ],

Поведение цепляется к событию EVENT_CART_COST и задает скидку (см. pistol88\cart\behaviors\Discount)., _(*16)

Можно подцепиться напрямую к событию:, _(*17)

        'cart' => [
            'class' => 'pistol88\cart\Cart',
            //...
            'on cart_cost' => function($event) {
                $event->cost = ($event->cost*50)/100;
            }
        ],

События

Все события корзины:, _(*18)

• EVENT_CART_COST - изменение общей цены
• EVENT_CART_COUNT - изменение количества
• EVENT_CART_TRUNCATE - очищение корзины
• EVENT_CART_PUT - добавление элемента
• EVENT_ELEMENT_COST - изменение цены элемента
• EVENT_ELEMENT_ROUNDING - округление цены элемента