This module allows you to create breadcrumbs based on menu items instead of page paths. You can choose which menu to use, customize the home link, and control whether to include the current page and disabled or structural menu items in the breadcrumb trail.
Introduction
The Crouton module replaces the path-based breadcrumb builder in Drupal core with a menu-based alternative. With Crouton, you have the flexibility of defining your breadcrumbs using menu items.
Crouton works by processing the active menu trail for the configured menu and turning it into a set of breadcrumb links. Each link uses the label and target of their corresponding menu item, allowing for maximum flexibility.
Features
- Allows you to use any menu for breadcrumbs, even if that menu is not exposed to users.
- Uses the label of each menu item in the active trail, allowing for breadcrumb labels to be decoupled from the target content.
- With a properly structured template, the current page is automatically marked with
aria-current="page"if present in the breadcrumb links. - Allows you to configure whether to display a link for the Home page and the current page in the breadcrumb.
- Allows you to configure whether to use disabled menu items.
- Allows you to configure whether to display structural-only menu items.
Configuration
- Configure the module's permissions by clicking "Permissions" after locating the module in Drupal's module installation interface.
- Configure the module's settings by clicking "Configure" after locating the module in Drupal's module installation interface.
The following settings are available for configuration:
- Breadcrumb menu: The menu to use when building breadcrumbs. If no menu is selected, breadcrumbs will be built by the next applicable breadcrumb builder (effectively disabling this module).
- Prepend a breadcrumb for the front page: When enabled, a "Home" breadcrumb will be added to the front of the breadcrumb list. The name of this link can be changed with interface translation.
- Append a breadcrumb for the current page: When enabled, a breadcrumb for the current page will be included at the end of the breadcrumb list.
- Use disabled menu items: When enabled, the breadcrumb builder will produce breadcrumbs for ancestral menu items which are disabled. If both this setting and the active menu item are disabled, breadcrumbs will be built by the next applicable breadcrumb builder.
- Hide plain-text breadcrumbs: When enabled, the breadcrumb builder will ignore
<nolink>menu links.
Ask your assistant about Crouton
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.