Magento 2 开发内容目录

本章节讨论如何在后台左侧导航菜单条添加自定义链接。

首先要理解后台菜单的结构及每个菜单项的交互方式。菜单是分为层级式的父子结构。在左侧导航菜单条直接显示的是第0层,当你点击第0层菜单项时会显示出对应更高层级的分组子菜单项。如下图是店铺Store菜单,Stores就是第0层直接显示在左侧导航条上,点击Stores之后子菜单就会展开显示:Settings、Attributes、Taxes等,以及它们的子子菜单项(Settings就有子项:All Stores、Configuration、Terms and Conditions、Order Status)。

stores menu

在前端时路由名称的格式为:{router_name}_{controller_name}_{actions_name},后台路由格式也一样,但需要指定一个不同的名称以便让系统知道调用的是后台的路由。

菜单到底如何添加?接下来继续使用之前的Hello World模块进行演示菜单项的添加。

添加菜单使用 menu.xml 配置文件步骤如下:

第一步 创建 menu.xml

文件: app/code/Aqrun/HelloWorld/etc/adminhtml/menu.xml

代码:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Backend:etc/menu.xsd">
    <menu>
    </menu>
</config>

第二步 配置菜单项

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Backend:etc/menu.xsd">
    <menu>
        <add id="Aqrun_HelloWorld::helloworld" title="你好世界"
             module="Aqrun_HelloWorld" sortOrder="51"
             resource="Aqrun_HelloWorld::helloworld"/>
        <add id="Aqrun_HelloWorld::post" title="文章管理"
             module="Aqrun_HelloWorld" sortOrder="10"
             action="aqrun_helloworld/post" resource="Aqrun_HelloWorld::post"
             parent="Aqrun_HelloWorld::helloworld"/>
        <add id="Aqrun_HelloWorld::hello_configuration" title="参数设置"
             module="Aqrun_HelloWorld" sortOrder="99"
             parent="Aqrun_HelloWorld::helloworld"
             action="adminhtml/system_config/edit/section/helloworld"
             resource="Aqrun_HelloWorld::helloworld_configuration"/>
    </menu>
</config>

配置文件中,我们添加了名为“你好世界”的第0级菜单,以及它的两个子菜单项“文章管理”和“参数设置”。 在 menu.xml 文件中会定义很多 ‘add’ 节点来向后台添加菜单项,它的结构如下:

<add id="Aqrun_HelloWorld::post" title="Manage Posts" 
    module="Aqrun_HelloWorld" 
    sortOrder="10" action="aqrun_helloworld/post" 
    resource="Aqrun_HelloWorld::post"
    parent="Aqrun_HelloWrld::helloworld"/>

属性解释:

你也可以添加一些其它子菜单,会和店铺菜单一样的格式显示。

最后要提的是菜单的图标,显示在0级菜单名称的上面。这些图标是 ‘Admin Icons’ 字体生成的,更多关于图标的内容查看这个链接

第三步 清空缓存

要确保自定义菜单正常显示需要清除一下缓存运行 php bin/magento cache:clean

本例显示结果如图:

helloworld