受注ステータスのカスタマイズ

受注ステータスの拡張 #3325

受注対応状況の流れも合わせてご確認ください。

基本の拡張方法

Symfony Workflow Componentを利用して実装しています。

ステータス遷移時に行う処理を追加するには、ステータス遷移時のイベントを実装します。 ステータスの遷移はapp/config/eccube/packages/order_state_machine.phpに定義しています。

イベントを実装することで受注の遷移時に任意の処理を追加できます。

遷移元	遷移先	イベント
新規受付	入金済み	workflow.order.transition.pay
新規受付, 入金済み	対応中	workflow.order.transition.packing
新規受付, 対応中, 入金済み	キャンセル	workflow.order.transition.cancel
キャンセル	対応中	workflow.order.transition.back_to_in_progress
新規受付, 対応中, 入金済み	発送済み	workflow.order.transition.ship
発送済み	返品	workflow.order.transition.return
返品	発送済み	workflow.order.transition.cancel_return

• 例) 返品時の処理を追加したいとき
  • workflow.order.transition.return イベントを受け取る EventSubscriberInterface を実装します。

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Eccube\Entity\Order;
use Symfony\Component\Workflow\Event\Event;

class SampleTransitionListener implements EventSubscriberInterface
{
    /**
     * 返品時の処理.
     *
     * @param Event $event
     */
    public function onReturn(Event $event)
    {
        /* @var Order $Order */
        $Order = $event->getSubject();
        .... /* 処理を実装する */
    }

    /**
     * {@inheritdoc}
     */
    public static function getSubscribedEvents()
    {
        return ['workflow.order.transition.return' => 'onReturn'];
    }
}

参考

EC-CUBE のデフォルトのイベントは src/Eccube/Service/OrderStateMachine.php に実装されています。

Using Events