Menu Pager adds a block for each menu that adds previous and next link navigation based on the current page.
It does this by flattening the menu tree to calculate which links should come before and after the menu link corresponding to the current page. This can optionally be restricted to links with the same parent as the active menu link (by default, it uses traverses the entire menu tree).
A port of this module is available for Backdrop CMS
API
Menu Pager provides a simple API for retrieving previous and next links for a given menu item.
$navigation = menu_pager_get_navigation($menu_link);
// $navigation['previous'] and $navigation['next'] will contain the links
There are hooks to ignore certain paths from appearing in menu pagers.
Out-of-the-box support is included to ignore <nolink>
and <separator>
paths from Special Menu Items and <firstchild>
from Menu Firstchild.
Add your own paths with hook_menu_pager_ignore_paths($menu_name)
and hook_menu_pager_ignore_paths_alter(&$paths, $menu_name)
.
Drupal 8 New features
- Override the templates for next and previous links
- Custom next and previous label option in block configuration
Project information
- Module categories: Content Display
- 174 sites report using this module
- Created by joelstein on , updated
- Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Development version: 3.x-dev updated 5 May 2023 at 00:57 UTC
Development version: 7.x-1.x-dev updated 25 Mar 2019 at 08:23 UTC