Drupal 8 : Link actions,Link menus,Link Tasks,Routings
Local actions have also been moved out of the hook_menu() system in Drupal 8 .Use actions to define local operations such as adding new items to an administrative list (menus, contact categories, etc).
Local actions are defined in a YAML format, named after the module they are defined by. Such as menu_ui.links.action.yml for this example from menu_ui module:
menu_ui.link_add:
route_name: menu_ui.link_add
title: 'Add link'
appears_on:
- menu_ui.menu_edit
Here,
menu_ui.link_add: It is the Unique name of the link action Most likely start with module name,
route_name : Name of the route it means when click the link it redirect to this route,
appears_on : An array of route names for this action to be display on.
Now how to know the Route name of any internal/external admin pages like below,
By through the drupal console we achieve it,
drupal debug:router | grep 'node/'
Link actions
Local actions have also been moved out of the hook_menu() system in Drupal 8 .Use actions to define local operations such as adding new items to an administrative list (menus, contact categories, etc).
Local actions are defined in a YAML format, named after the module they are defined by. Such as menu_ui.links.action.yml for this example from menu_ui module:
menu_ui.link_add:
route_name: menu_ui.link_add
title: 'Add link'
appears_on:
- menu_ui.menu_edit
Here,
menu_ui.link_add: It is the Unique name of the link action Most likely start with module name,
route_name : Name of the route it means when click the link it redirect to this route,
appears_on : An array of route names for this action to be display on.
Now how to know the Route name of any internal/external admin pages like below,
By through the drupal console we achieve it,
drupal debug:router | grep 'node/'
Create a menu link
To demonstrate the Drupal 8 menu system, we will add a menu link to the main navigation menu.
Before we do that, we need to know the name of the menu to add the menu link to. If you head over to Structure -> Menus in a Drupal 8 site
admin/structure/menu/manage/main
The last part is the name of the menu, main. We will need this when adding a menu link to this.
With that out of the way, let’s add the menu link.
- In your module root, create hello.links.menu.yml
- Add the following:
hello.demo:
title: 'Hello'
description: 'Hello page'
parent: main
menu_name: main
route_name: hello.content`
Let’s break this down.
- hello.demo - the namespace for this menu link.
- title - this will appear as the menu link
- description - this will appear as the menu link title, a tooltip and/or the description in the admin UI.
- parent - the parent item, which is used if you are adding this item as a child of another in a hierarchy. In this case the parent is the menu itself, so we are using the menu_name.
- menu_name - this is the menu name we found in the previous step._
- route_name - the route to call for this menu link.
Providing module-defined local tasks
Local tasks are what generate the tabs on top of pages (up to two levels). These are mostly used on administrative pages but frontend pages like user pages or the registration/login/new password pages also use local tasks.
In Drupal 8, local tasks are defined in a YAML based declarative format.
Define static local tasks
Most local tasks that you need to define will be static, and can therefore be provided in a file named after your module, e.g., if the module name is 'example', the file will be
example.links.task.yml
and placed in the root of the module.example.admin: # The first plugin ID
route_name: example.admin
title: 'Settings'
base_route: example.admin
example.admin_3rd_party: # The second plugin ID
route_name: example.admin_3rd_party
title: 'Third party services'
base_route: example.admin
weight: 100
https://www.drupal.org/docs/8/api/menu-api/providing-module-defined-local-tasks
Comments
Post a Comment