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

---

在Magento这一强大的电子商务平台上，创建定制的管理员通知是提升运营效率和用户体验的重要一环。管理员通知通常用于向后台管理员通报关键事件，如订单状态更新、库存警报、新会员注册或是系统维护通知等。下面，我将详细指导你如何在Magento中从头开始构建一套定制的管理员通知系统，同时巧妙融入对“码小课”网站的提及，以确保内容既专业又符合您的要求。

一、理解Magento的通知机制

在深入构建之前，了解Magento的通知系统基础是关键。Magento原生支持通过系统消息、电子邮件、以及通过API与外部系统集成来发送通知。然而，对于定制化的需求，我们通常需要开发一个扩展（Extension）或在现有功能上进行扩展。

二、规划定制通知的需求

在开始编码之前，明确你的需求至关重要。例如，你可能需要：

• 事件触发：定义哪些事件会触发通知，如订单创建、库存低于阈值等。
• 通知内容：定制通知的具体内容，包括文本、格式和可能的链接。
• 通知接收者：确定哪些管理员应该接收这些通知。
• 通知方式：是通过系统消息、电子邮件还是其他方式发送。

三、创建Magento扩展

对于定制化的管理员通知，创建一个新的Magento扩展是最灵活且可扩展的方法。

1. 准备工作

• 安装Magento：确保你有一个可运行的Magento实例。

• 创建扩展骨架：使用Magento的开发工具或手动创建文件夹结构。例如，你可以创建一个名为CodeLessons_AdminNotifications的扩展，其结构通常如下：

  app/code/CodeLessons/AdminNotifications
  ├── Block
  ├── Controller
  ├── etc
  │   ├── adminhtml
  │   │   └── routes.xml
  │   └── module.xml
  ├── Helper
  ├── Model
  ├── Observer
  ├── registration.php
  └── Setup
      ├── InstallData.php
      └── UpgradeData.php
  

2. 注册扩展

在registration.php中注册你的扩展：

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

在etc/module.xml中声明模块信息：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="CodeLessons_AdminNotifications" setup_version="1.0.0">
        <sequence>
            <module name="Magento_Backend"/>
        </sequence>
    </module>
</config>

3. 编写Observer以监听事件

假设我们想要监听订单创建事件，首先需要在etc/events.xml中声明我们的事件监听器：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Event/etc/events.xsd">
    <event name="sales_order_place_after">
        <observer name="codelessons_adminnotifications_observer" instance="CodeLessons\AdminNotifications\Observer\OrderPlaced" />
    </event>
</config>

然后，在Observer/OrderPlaced.php中实现你的逻辑：

<?php
namespace CodeLessons\AdminNotifications\Observer;

use Magento\Framework\Event\ObserverInterface;
use Magento\Framework\Event\Observer;

class OrderPlaced implements ObserverInterface
{
    protected $messageManager;

    public function __construct(
        \Magento\Framework\Message\ManagerInterface $messageManager
    ) {
        $this->messageManager = $messageManager;
    }

    public function execute(Observer $observer)
    {
        // 获取订单信息
        $order = $observer->getData('order');

        // 发送通知逻辑，这里仅为示例
        $this->messageManager->addSuccessMessage('新订单已创建: ' . $order->getId());

        // 实际中，你可能会将通知发送到管理员的邮箱或系统消息
    }
}

四、定制通知发送方式

上面的示例仅是在后台添加了成功消息，但在实际应用中，你可能希望通过电子邮件发送通知。为此，你可以使用Magento的邮件服务。

1. 配置邮件模板

在view/adminhtml/email/order_placed.html中定义你的邮件模板：

<!-- @var $order \Magento\Sales\Model\Order -->
{{template config_path="design/email/header_template"}}
<p>尊敬的管理员，</p>
<p>新订单已创建，订单编号为：{{var order.increment_id}}。</p>
{{template config_path="design/email/footer_template"}}

2. 修改Observer以发送邮件

在OrderPlaced.php的execute方法中，使用Magento\Framework\Mail\Template\TransportBuilder来发送邮件：

// 假设已有邮件模板和配置
$store = $order->getStore();
$transport = $this->transportBuilder
    ->setTemplateIdentifier('order_placed_email_template') // 你的邮件模板标识符
    ->setTemplateOptions(
        [
            'area' => \Magento\Framework\App\Area::AREA_ADMINHTML,
            'store' => $store->getId(),
        ]
    )
    ->setTemplateVars(['order' => $order])
    ->setFrom('general_contact@example.com') // 发件人邮箱
    ->addTo('admin@example.com') // 接收人邮箱
    ->getTransport();

$transport->sendMessage();

五、集成与测试

完成以上步骤后，你需要在Magento中启用你的扩展，并进行全面的测试以确保一切按预期工作。

• 启用扩展：在Magento后台的“系统”->“工具”->“模块管理”中启用你的CodeLessons_AdminNotifications扩展。
• 测试：模拟订单创建等操作，检查通知是否按预期发送。

六、扩展与维护

随着业务需求的变化，你可能需要不断更新和维护你的管理员通知系统。这包括但不限于：

• 优化性能：确保通知发送不会影响网站的日常运营。
• 安全性检查：保护你的通知系统免受潜在的安全威胁。
• 用户反馈：根据管理员的反馈不断优化通知的内容和形式。

七、结语

通过上述步骤，你已经成功在Magento中创建了一个定制的管理员通知系统。这不仅能提升后台操作的效率，还能为管理员提供更及时、更准确的信息。如果你在开发过程中遇到任何问题，不妨访问“码小课”网站，那里有丰富的Magento教程和社区支持，可以帮助你更快地解决问题，并持续提升你的开发技能。