This is an old revision of the document!
Table of Contents
Breadcrumbs
In DokuWiki you never get lost because you always leave some breadcrumbs behind which show you the way back. Unlike in the fairy tale there are no birds in DokuWiki.
Breadcrumb Types
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.
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.
Problems
By setting some options in the php.ini file, breadcrumbs doesn't work anymore - it shows only the last visited page, not the requested 10 pages. After removing the php.ini, everything works fine. [Dani, 2008-09-13]
On my production server, anonymous users only saw a breadcrumb trail of 1 page: the current page. To allow them to see the complete trail of $conf['breadcrumbs'], I changed line 166 in inc/auth.php.
if(!$silent) msg($lang['badlogin'],-1); //auth_logoff(); auth_logoff(true); // CHANGED return false;
Now both anonymous and logged in users see the breadcrumb trail.
[John, 2009-10-26]