当前位置：首页 > 文章列表 > 文章 > php教程 > Magento2订单页添加自定义按钮方法

Magento2订单页添加自定义按钮方法

2025-08-15 16:27:29 0浏览收藏

想为你的Magento 2后台订单页添加自定义按钮，实现特定功能吗？本文为你提供一份详细的教程，手把手教你如何在Magento 2订单详情页添加自定义按钮并触发事件。从创建模块、配置路由，到编写控制器和插件，本文将一步步引导你完成设置，让你轻松掌握自定义按钮的添加技巧。更重要的是，本文还考虑了启用 "Add Secret Key to URLs" 的情况，确保你的解决方案安全可靠。无论你是Magento 2新手还是有一定经验的开发者，都能从本文中获益，打造更符合业务需求的Magento 2后台管理系统。快来学习吧！

Magento 2：向订单详情页添加自定义功能按钮

本文档详细介绍了如何在 Magento 2 后台的订单详情页面添加一个自定义按钮，并实现点击后触发特定功能。通过本文，你将学习如何创建模块、配置路由、编写控制器和插件，最终实现自定义按钮的功能。同时，本文也考虑了启用 "Add Secret Key to URLs" 的情况，提供更全面的解决方案。

创建模块

首先，我们需要创建一个自定义模块。按照 Magento 2 的模块结构，创建以下文件：

注册文件 (registration.php)

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

这个文件告诉 Magento 2 注册名为 MG_Dropship 的模块。

模块配置文件 (etc/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="MG_Dropship" setup_version="1.0.0"/>
</config>

这个文件声明了模块的名称和版本。

配置依赖注入 (DI)

接下来，我们需要通过 di.xml 文件配置依赖注入，以便在订单详情页添加自定义按钮。

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
   <type name="Magento\Sales\Block\Adminhtml\Order\View">
       <plugin name="addCustomButton" type="MG\Dropship\Plugin\Sales\Block\Adminhtml\Order\Button"/>
   </type>
</config>

这个配置使用了一个插件（MG\Dropship\Plugin\Sales\Block\Adminhtml\Order\Button）来拦截 Magento\Sales\Block\Adminhtml\Order\View 类的 beforeSetLayout 方法，从而可以在订单详情页添加自定义按钮。

配置路由

我们需要定义一个路由，以便处理自定义按钮的点击事件。

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
    <router id="admin">
        <route id="mg_dropship" frontName="mg_dropship">
            <module name="MG_Dropship" />
        </route>
    </router>
</config>

这个文件定义了一个名为 mg_dropship 的 admin 路由，frontName 也设置为 mg_dropship。

创建控制器

我们需要创建一个控制器来处理自定义按钮的点击事件。

<?php
namespace MG\Dropship\Controller\Adminhtml\Order;

class Index extends \Magento\Sales\Controller\Adminhtml\Order
{
    /**
     * @var \Psr\Log\LoggerInterface
     */
    protected $logger;

    /**
     * Index constructor.
     *
     * @param \Magento\Backend\App\Action\Context $context
     * @param \Magento\Framework\Registry $coreRegistry
     * @param \Magento\Framework\App\Response\Http\FileFactory $fileFactory
     * @param \Magento\Sales\Model\Order\Email\Sender\OrderSender $orderSender
     * @param \Magento\Backend\Model\View\Result\ForwardFactory $resultForwardFactory
     * @param \Magento\Framework\View\Result\PageFactory $resultPageFactory
     * @param \Psr\Log\LoggerInterface $logger
     */
    public function __construct(
        \Magento\Backend\App\Action\Context $context,
        \Magento\Framework\Registry $coreRegistry,
        \Magento\Framework\App\Response\Http\FileFactory $fileFactory,
        \Magento\Sales\Model\Order\Email\Sender\OrderSender $orderSender,
        \Magento\Backend\Model\View\Result\ForwardFactory $resultForwardFactory,
        \Magento\Framework\View\Result\PageFactory $resultPageFactory,
        \Psr\Log\LoggerInterface $logger
    ) {
        $this->logger = $logger;
        parent::__construct($context, $coreRegistry, $fileFactory, $orderSender, $resultForwardFactory, $resultPageFactory);
    }

    /**
     * Execute action
     *
     * @throws \Magento\Framework\Exception\LocalizedException|\Exception
     */
    public function execute()
    {
        // In case you want to do something with the order
        $order = $this->_initOrder();
        if ($order) {
            try {
                // TODO: Do something with the order
                $this->messageManager->addSuccessMessage(__('We did something!'));
            } catch (\Magento\Framework\Exception\LocalizedException $e) {
                $this->messageManager->addErrorMessage($e->getMessage());
            } catch (\Exception $e) {
                $this->messageManager->addErrorMessage(__('We can\'t process your request' . $e->getMessage()));
                $this->logger->critical($e);
            }

            return $this->resultRedirectFactory->create()->setPath(
                'sales/order/view',
                [
                   'order_id' => $order->getEntityId()
                ]
             );  
          }

        return $this->resultRedirectFactory->create()->setPath('sales/*/');
    }

    /**
     * @return bool
     */
    protected function _isAllowed()
    {
        return $this->_authorization->isAllowed('MG_Dropship::order_dosomething');
    }
}

这个控制器继承自 Magento\Sales\Controller\Adminhtml\Order，并重写了 execute 方法。在 execute 方法中，你可以编写自定义逻辑来处理订单。关键是使用 $this->_initOrder() 来初始化订单对象。同时，需要实现 _isAllowed 方法来控制访问权限。

创建插件

我们需要创建一个插件来向订单详情页添加自定义按钮。

<?php
namespace MG\Dropship\Plugin\Sales\Block\Adminhtml\Order;

use Magento\Sales\Block\Adminhtml\Order\View as OrderView;

class Button
{
    public function beforeSetLayout(OrderView $subject)
    {
        if ($subject->getOrder()) {
            $message = __('Are you sure you want to Do Something?');
            $subject->addButton(
                'do_something',
                [
               'label' => __('Do Something'),
               'class' => 'do_something',
               'onclick' => "confirmSetLocation('{$message}', '{$subject->getUrl('mg_dropship/order/index')}')"
               ]
            );
        }
    }
}

这个插件拦截了 Magento\Sales\Block\Adminhtml\Order\View 类的 beforeSetLayout 方法，并使用 $subject->addButton 方法添加了一个名为 do_something 的按钮。onclick 属性定义了点击按钮后执行的 JavaScript 代码，它会弹出一个确认框，并在确认后跳转到 mg_dropship/order/index 路由。

定义权限

为了控制用户访问自定义功能的权限，需要在 etc/adminhtml/acl.xml 文件中定义权限规则。

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Acl/etc/acl.xsd">
    <acl>
        <resources>
            <resource id="Magento_Backend::admin">
                <resource id="Magento_Sales::sales">
                    <resource id="Magento_Sales::orders">
                        <resource id="MG_Dropship::order_dosomething" title="Do Something" sortOrder="10" />
                    </resource>
                </resource>
            </resource>
        </resources>
    </acl>
</config>

这个文件定义了一个名为 MG_Dropship::order_dosomething 的权限规则，你需要在后台配置用户角色，授予他们这个权限才能访问自定义功能。

启用 "Add Secret Key to URLs" 的情况

当启用 "Add Secret Key to URLs" 时，Magento 会自动在 URL 中添加一个 secret key，以增加安全性。以上代码已经兼容这种情况，$subject->getUrl('mg_dropship/order/index') 会自动生成包含 secret key 的 URL。