sakhlab/yii2-order

yii2-order it's a module for site cart order

Yii2-order

Это модуль для реализации функцинала заказа на сайте. Сейчас в заказ попадают элементы корзины, советую в качестве сервиса корзины использовать модуль pistol88/yii2-cart., _(*1)

Функционал:, _(*2)

• Добавление заказа, просмотр и управление заказами в админке
• Управление полями заказа в админке
• Управление способами доставки и оплаты в админке

Установка

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

php composer require pistol88/yii2-order "*"

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

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

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

php composer update

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

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

Далее, связываем модуль с корзиной. Устанавливаем pistol88/yii2-cart и добавляем в начало конфига вашего приложения:, _(*7)

yii::$container->set('pistol88\order\interfaces\Cart', 'pistol88\order\drivers\Pistol88Cart');

Чтобы связать модуль с другой корзиной:, _(*8)

yii::$container->set('pistol88\order\interfaces\Cart', 'app\objects\Cart');

app\objects\Cart должен содержать класс, имплементирующий \pistol88\order\interfaces\Cart., _(*9)

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

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

    'modules' => [
        'order' => [
            'class' => 'pistol88\order\Module',
            'layoutPath' => 'frontend\views\layouts',
            'successUrl' => '/page/thanks', //Страница, куда попадает пользователь после успешного заказа
            'ordersEmail' => 'test@yandex.ru', //Мыло для отправки заказов
        ],
        //...
    ]

Все настройки модуля:, _(*11)

• orderStatuses - статусы (по умолчанию: 'new' => 'Новый', 'approve' => 'Подтвержден', 'cancel' => 'Отменен', 'process' => 'В обработке', 'done' => 'Выполнен')
• defaultStatus - статус нового заказа (по умолчанию 'new')
• successUrl - урл, куда будет перенаправлен покупатель в случае успешной покупки (по умолчанию /order/info/thanks/)
• ordersEmail - почта администратора, туда уходят письма с заказами
• robotEmail - e-mail робота (по умолчанию no-reply@localhost)
• robotName - имя почтового робота (по умолчанию Robot)
• orderColumns - массмв полей для вывода. Кастомные поля добавляются как массив, содержащий ID и наименование поля: ['field' => 2, 'label' => 'Автомобиль']
• dateFormat - формат даты (по умолчанию d.m.Y H:i:s)

• cartService - имя компонента, в которой реализована корзина (по умолчанию cart). Интерфейс смотреть в pistol88/yii2-cart., _(*12)

• currency - валюта, по умолчанию рубли, _(*13)

• currencyPosition - позиция значка валюты относительно цены (before или after)
• priceFormat - формат цены (по умолчанию [2, '.', ''])
• adminRoles - список ролей, которые имеют доступ в CRUD заказа (по умолчанию ['admin', 'superadmin'])

Сервисы

Модуль автоматически инжектит в yii2 (в Service locator) компонент order (сервис), который доступен глобально через yii::$app->order и предоставляет следующие сервисы:, _(*14)

• get($id) - получить заказ по ID
• getStatInMoth($month) - получить статистику заказов за месяц
• getStatByDate($date) - получить статичтику заказов за день
• getStatByDatePeriod($dateStart, $dateStop) - получить статистику заказов за период
• getStatByModelAndDatePeriod($model, $dateStart, $dateStop) - получить статистику заказов определенной модели за период

Виджеты

За вывод формы заказа отвечает виджет pistol88\order\widgets\OrderForm, _(*15)

<?=OrderForm::widget();?>

Кнопка "заказ в один клик" - pistol88\order\widgets\OneClick:, _(*16)

<?=OneClick::widget(['model' => $model]);?>

Триггеры

В Module:, _(*17)

• create - создание заказа
• delete_order - удаление заказа
• delete_element - удаление элемента заказа

Пример использования через конфиг:, _(*18)

    'order' => [
        'class' => 'pistol88\order\Module',
        'on create' => function($event) {
            send_sms(...); //Отправляем СМС оповещение
        },
    ],

Онлайн оплата

Чтобы добавить способ оплаты, перейдите в ?r=/order/payment-type/index, добавьте новый способ, где в поле "Виджет" укажите класс виджета, который будет отдавать форму оплаты. Виджеты оплаты устанавливаются отдельно., _(*19)

• Paymaster.ru: pistol88/yii2-paymaster
• Liqpay: pistol88/yii2-liqpay
• Сбербанк: pistol88/yii2-sberbank-payment