系统学习magento二次开发，推荐小册：《Magento中文全栈二次开发 》

1. 理解Magento 2的订单状态与状态码

在Magento 2中，订单有两个主要的状态变量：state和status。state代表订单的生命周期阶段（如新订单、处理中、已完成等），而status则提供了关于订单当前状态的更具体信息（如待付款、已发货等）。

Magento 2已经预定义了一些常见的订单状态和状态码，如STATE_NEW、STATE_PENDING_PAYMENT、STATE_PROCESSING、STATE_COMPLETE等。这些定义在app/code/Magento/Sales/Model/Order.php中。

2. 创建自定义状态

要在Magento 2中创建自定义的订单状态，你需要修改核心文件或创建一个模块来扩展现有的功能。以下是基于模块开发的方法：

2.1 创建模块

首先，你需要创建一个新的Magento 2模块。假设你的模块命名为Vendor_CustomOrderStatus。

1. 创建模块目录结构：

   app/code/Vendor/CustomOrderStatus
   ├── etc
   │   └── module.xml
   ├── registration.php
   └── Setup
       └── InstallData.php
   

2. 编写module.xml：

   <?xml version="1.0"?>
   <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
       <module name="Vendor_CustomOrderStatus" setup_version="1.0.0">
       </module>
   </config>
   

3. 编写registration.php：

   <?php
   \Magento\Framework\Component\ComponentRegistrar::register(
       \Magento\Framework\Component\ComponentRegistrar::MODULE,
       'Vendor_CustomOrderStatus',
       __DIR__
   );
   

2.2 添加自定义状态

1. 在Setup/InstallData.php中定义自定义状态： 使用安装脚本（InstallData.php）来添加自定义的订单状态和状态码。

   <?php
   namespace Vendor\CustomOrderStatus\Setup;
   
   use Magento\Framework\Setup\InstallDataInterface;
   use Magento\Framework\Setup\ModuleContextInterface;
   use Magento\Framework\Setup\ModuleDataSetupInterface;
   use Magento\Sales\Model\ResourceModel\Order\Status as OrderStatusResource;
   use Magento\Sales\Model\StatusFactory;
   
   class InstallData implements InstallDataInterface
   {
       private $orderStatusResource;
       private $statusFactory;
   
       public function __construct(
           OrderStatusResource $orderStatusResource,
           StatusFactory $statusFactory
       ) {
           $this->orderStatusResource = $orderStatusResource;
           $this->statusFactory = $statusFactory;
       }
   
       public function install(ModuleDataSetupInterface $setup, ModuleContextInterface $context)
       {
           $this->orderStatusResource->saveStatus(
               $this->statusFactory->create()
                   ->setLabel('On Shipping')
                   ->setStatus('on_shipping')
                   ->setIsVisibleOnFront(true)
           );
   
           // 可以根据需要添加更多状态
       }
   }
   

   注意：这里的setLabel和setStatus方法需要根据你的需求来设置。setLabel是前端显示的文本，setStatus是系统的内部状态码。

2.3 刷新缓存和重新索引

完成上述步骤后，你需要刷新Magento的缓存并重新索引数据，以确保你的更改生效。

1. 清理缓存： 通过Magento的后台或使用命令行工具bin/magento cache:clean。

2. 重新索引： 使用命令行工具bin/magento indexer:reindex来重新索引数据。

3. 在后端和前端使用自定义状态

一旦自定义状态被添加到系统中，你就可以在Magento 2的后端和前端看到并使用它了。在订单管理界面中，你应该能够选择和使用新的状态。

4. 注意事项