Menu Pager
Menu Pager adds navigation links to your site's menus, allowing users to easily move between pages that are related within the menu structure. It can be configured to consider the entire menu or just a specific section, and offers API and hooks for more advanced customization.
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