DokuWiki

It's better when it's simple

User Tools

Site Tools


breadcrumbs

Breadcrumbs

In DokuWiki you will never get lost because you always leave some breadcrumbs behind which show you the way back.

DokuWiki can display two kinds of breadcrumbs: tracking and hierarchical breadcrumbs.

Tracking Breadcrumbs

This is the default. Breadcrumbs display a list of pages you just visited in a wiki. This makes most sense for pages with a flat namespace hierarchy. Tracking Breadcrumbs are prefixed with the word Trace: • .

The number of tracking breadcrumbs to be shown can be set with the breadcrumbs option.

Hierarchical Breadcrumbs

Hierarchical breadcrumbs are common in typical CMS driven sites with deep navigation structures. If your wiki features strict hierarchical namespaces, you might want to use these bookmarks. When enabled they are prefixed with the words You are here:.

Hierarchical breadcrumbs can be enabled with the youarehere option.

Configuration

  • The text block Trace: for tracking breadcrumbs and You are here: for hierarchical breadcrumbs cannot be customized through the Configuration Manager. However, they can be edited or removed by overriding the language configuration. For example:
    • The English (en) text for Trace: can be altered within file conf/lang/en/lang.php by adding $lang['breadcrumbs'] = “” (to display no prefix text) or $lang['breadcrumbs'] = “Recent:” (to alter the prefix text).
    • The English (en) text for You are here: can be altered within file conf/lang/en/lang.php by adding $lang['youarehere'] = “” (to display no prefix text) or $lang['youarehere'] = “Current Destination:” (to alter the prefix text).
  • How and where the breadcrumb block is rendered is mainly the responsibility of the template.
  • The template mikio with a highly customizable configuration has a setting breadcrumbPrefixText for your customization: Note though that this is only a single prefix used for all breadcrumb types and not individually per hierarchical breadcrumbs and tracking_breadcrumbs.
  • If you'd like to customize it in your plugin of choice
    • ask the author, to make it customizable,
    • or find the string in the template and overwrite it as a quick hack to get what you want
    • or alternatively try to see what the localization has to offer in that regard.

Development

The breadcrumbs are stored in the user session. Template developers should make sure to provide space for both types of breadcrumbs by using the tpl_breadcrumbs() and tpl_youarehere() functions.

breadcrumbs.txt · Last modified: by 65.128.47.89

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki