Drupal 8 模块开发:使用 .links.menu.yml 文件向菜单中添加链接

按照《Drupal 8 模块开发入门教程》创建的小模块 hello_world 已经添加了新页面,接下来使用 .links.menu.yml 文件实现向管理菜单中添加链接,方便管理员通过菜单访问 Hello World 页面。

在 hello_world 模块根目录下创建 hello_world.links.menu.yml 文件,在文件中写入以下内容:

hello_world.admin:
  title: 'Hello World settings'
  description: 'Menu link example'
  parent: system.admin_config_development
  route_name: hello_world.content
  weight: 100
  • title: 菜单项名称
  • description: 菜单项描述
  • parent: 父级菜单路由
  • route_name: 链接对应的路由(示例中使用的路由在 hello_world.routing.yml 中已定义过)
  • weight: 菜单项权重,用于决定菜单项显示的先后顺序

除了使用 .links.menu.yml 文件定义菜单项链接外,还可以 *.links.task.yml, *.links.contextual.yml, *.links.action.yml 等文件定义Tab标签,Contextual链接等

文件创建完成之后,清空 Drupal 缓存,便可在“管理 > 配置 > 开发”菜单下找到我们此次新增的 Hello World settings 菜单项了(如下图)

Drupal 8模块开发 添加菜单项链接

提示:如果清空 Drupal 缓存后菜单项没有显示出来,注意检查文件名是否正确,同时可以查看“报告 > 最新日志信息”,也许会有实用的报错信息。

看完了?还不过瘾?点此向作者提问
打赏一下,鼓励Ta创作更多好内容!