Внимание!

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

Yii2-order

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

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

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

Установка

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

php composer require pistol88/yii2-order "*"

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

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

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

php composer update

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

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

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

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

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

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

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

Установка как модуля

Если Вы планируете вносить множество измененией в код, лучшей практикой будет установить расширение как модуль., _(*11)

Клонируете с Github расширение в нужную папку:, _(*12)

git clone https://github.com/pistol88/yii2-order.git

В composer.json добавляете путь до модуля:, _(*13)

"autoload": {
    "psr-4": {
      "pistol88\\order\\": "common/modules/order"
    }
  }

Запускаете update:, _(*14)

php composer update

Делаете миграции:, _(*15)

php yii migrate --migrationPath=common/modules/order/migrations

Добавляете в конфиг:, _(*16)

'bootstrap' => ['pistol88\order\Bootstrap'],

Связываете с корзиной, как описано выше., _(*17)

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

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

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

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

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., _(*20)
currency - валюта, по умолчанию рубли, _(*21)
currencyPosition - позиция значка валюты относительно цены (before или after)
priceFormat - формат цены (по умолчанию [2, '.', ''])
adminRoles - список ролей, которые имеют доступ в CRUD заказа (по умолчанию ['admin', 'superadmin'])

Сервисы

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

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

Виджеты

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

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

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

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

Триггеры

В Module:, _(*25)

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

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

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

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

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