Add custom breadcrumbs

Author: Hubert Prein

services/AmNavService.php

@@ -426,7 +426,7 @@ private function _setActiveNodes($nodes)
 
         foreach ($nodes as $node) {
             if ($node['elementType'] == 'Asset') { continue; }
-            
+
             $url = ! empty($node['elementId']) ? $node['elementUrl'] : $node['url'];
             $url = str_replace('{siteUrl}', '', $url);
             $url = str_replace('__home__', '', $url);
@@ -703,10 +703,16 @@ private function _buildNavHtml($nodes, $parentId = 0, $level = 1)
     private function _buildBreadcrumbsHtml()
     {
         // Get active elements
-        $activeElements = $this->_getActiveElements();
+        $nodes = $this->_getActiveElements();
+
+        // Do we have custom nodes?
+        $customNodes = $this->_getParam('customNodes', false);
+        if ($customNodes && is_array($customNodes) && count($customNodes)) {
+            $nodes = array_merge($nodes, $customNodes);
+        }
 
         // Create breadcrumbs
-        $length = count($activeElements);
+        $length = count($nodes);
         $breadcrumbs = "\n" . sprintf('<%1$s%2$s%3$s xmlns:v="http://rdf.data-vocabulary.org/#">',
             $this->_getParam('wrapper', 'ol'),
             $this->_getParam('id', false) ? ' id="' . $this->_getParam('id', '') . '"' : '',
@@ -721,9 +727,12 @@ private function _buildBreadcrumbsHtml()
             );
         }
 
-        foreach ($activeElements as $index => $element) {
-            $childClasses = array();
+        foreach ($nodes as $index => $node) {
+            $nodeTitle = is_array($node) ? (isset($node['title']) ? $node['title'] : Craft::t('Unknown')) : $node->title;
+            $nodeUrl = is_array($node) ? (isset($node['url']) ? $node['url'] : '') : $node->url;
 
+            // Gather node classes
+            $childClasses = array();
             if ($this->_getParam('classDefault', false)) {
                 $childClasses[] = $this->_getParam('classDefault', '');
             }
@@ -733,21 +742,21 @@ private function _buildBreadcrumbsHtml()
                 $childClasses[] = $this->_getParam('classFirst', 'first');
                 $breadcrumbs .= sprintf("\n" . '<li%1$s typeof="v:Breadcrumb"><a href="%2$s" title="%3$s" rel="v:url" property="v:title">%3$s</a></li>',
                     $childClasses ? ' class="' . implode(' ', $childClasses) . '"' : '',
-                    $element->url,
-                    $this->_getParam('renameHome', $element->title)
+                    $nodeUrl,
+                    $this->_getParam('renameHome', $nodeTitle)
                 );
             }
             // Last
             elseif ($index == $length - 1)
             {
                 $childClasses[] = $this->_getParam('classLast', 'last');
                 $breadcrumb = sprintf('<span property="v:title">%1$s</span>',
-                    $element->title
+                    $nodeTitle
                 );
                 if ($this->_getParam('lastIsLink', false)) {
                     $breadcrumb = sprintf('<a href="%1$s" title="%2$s" rel="v:url" property="v:title">%2$s</a>',
-                        $element->url,
-                        $element->title
+                        $nodeUrl,
+                        $nodeTitle
                     );
                 }
                 $breadcrumbs .= sprintf("\n" . '<li%1$s typeof="v:Breadcrumb">%2$s</li>',
@@ -758,8 +767,8 @@ private function _buildBreadcrumbsHtml()
             else {
                 $breadcrumbs .= sprintf("\n" . '<li%1$s typeof="v:Breadcrumb"><a href="%2$s" title="%3$s" rel="v:url" property="v:title">%3$s</a></li>',
                     $childClasses ? ' class="' . implode(' ', $childClasses) . '"' : '',
-                    $element->url,
-                    $element->title
+                    $nodeUrl,
+                    $nodeTitle
                 );
             }
         }

translations/nl.php

@@ -57,6 +57,7 @@
     'The URL of this node.' => 'De URL van deze node.',
     'There are no navigations yet.' => 'Er zijn nog geen navigaties.',
     'There are no nodes yet.' => 'Er zijn nog geen nodes.',
+    'Unknown' => 'Onbekend',
     'Whether non-admins can add, edit and delete navigations.' => 'Of gebruikers die geen systeembeheerders zijn, navigaties kunnen toevoegen, wijzigen en verwijderen.',
     'Whether non-admins can delete nodes from a specific level. Leave blank if you don’t care.' => 'Of gebruikers die geen systeembeheerders zijn, de nodes vanaf een specifiek niveau kunnen verwijderen. Laat leeg als dit niet uitmaakt.',
     'Whether non-admins can move nodes from a specific level. Leave blank if you don’t care.' => 'Of gebruikers die geen systeembeheerders zijn, de nodes vanaf een specifiek niveau kunnen verplaatsen. Laat leeg als dit niet uitmaakt.',

variables/AmNavVariable.php

@@ -122,12 +122,14 @@ public function getNodeById($id)
      * - id             ID for the breadcrumbs wrapper.
      * - class          Class name for the breadcrumbs wrapper.
      * - classDefault   Default class name for every breadcrumb.
-     * - classFirst     Class name for the first breadcrumb. 
+     * - classFirst     Class name for the first breadcrumb.
      * - classLast      Class name for the last breadcrumb.
      * - wrapper        Wrapper element without the < and >.
      * - beforeText     Text before the first item, like 'You are here:'.
      * - renameHome     Change the title of the home entry.
      * - lastIsLink     Whether the last breadcrumb should be a link.
+     * - customNodes    Add custom nodes after the elements are handled.
+     *                  [ { title: 'A title', url: 'an url' }, { title: 'A title', url: 'an url' } ]
      *
      * @return string
      */