Breadcrumb Navigation SilverStripe 4.0

Maintainers

• Marijn Kampf (Nickname: marijnkampf)

http://www.exadium.com/tools/silverstripe/modules/breadcrumb-navigation/

Sponsored by Exadium Web Development

Introduction

Self contained Breadcrum Navigation module, allowing you to control breadcrumbs using templates, rather than from code.

Requirements

• SilverStripe Trunk SilverStripe 4.0

For SS 3 version see https://github.com/marijnkampf/Silverstripe-Module-BreadcrumbNavigation/tree/SS3

For SS 2.4 version see https://github.com/marijnkampf/Silverstripe-Module-BreadcrumbNavigation/tree/2.4

Install and setup

• BreadcrumbNavigation should be in your sites root folder.
• Set options in your mysite/_config/breadcrumbs.yml

---
Name: my-breadcrumbs-settings
After:
  - exadium-breadcrumbs-settings
---

#Override values here
Exadium\BreadcrumbNavigation\BreadcrumbNavigation:
  includeHome: false
  includeSelf: true
  maxDepth: 10
  stopAtPageType: false
  showHidden: false
  homeURLSegment: home

• In your template include either: <% include BreadcrumbNavigationTemplate %> or <% include BreadcrumbNavigationTemplateAllLinked %>

Advanced use

If you would like to add additional items to the Breadcrumb trail (e.g. for URL parameter actions) you can use AddBreadcrumbAfter($object) and AddBreadcrumbBefore($object) functions. You only need to define the attributes you use in your templates. These are Link and MenuTitle for the supplied templates. Define isSelf if you are not linking the current page.

	$do = new DataObject();
	$do->Link = $this->Link() . "show";
	$do->MenuTitle = "Menu title";
	$do->isSelf = true;
	$this->AddBreadcrumbAfter($do);