Navigační stopa (Breadcrumbs)

https://www.dokuwiki.org/breadcrumbs

V DokuWiki se nikdy neztratíte, protože vždy zanecháváte navigační (drobečkovou) stopu, která vám ukáže cestu zpět.

DokuWiki může zobrazovat dva typy navigační stopy: sledovací a hierarchickou.

Toto je výchozí nastavení. Navigační stopa zobrazuje seznam stránek, které jste právě navštívili ve wiki. Nejlépe se hodí pro stránky s plochou hierarchií jmenných prostorů. Sledovací navigační stopa je (v en verzi) označena předponou Trace: • .

Počet zobrazených sledovacích stop lze nastavit pomocí volby config:breadcrumbs.

Hierarchická navigační stopa je běžná na stránkách řízených CMS s hlubokou navigační strukturou. Pokud vaše wiki používá přísně hierarchické jmenné prostory, můžete využít tento typ záložek. Po aktivaci se zobrazuje (v en verzi) předponou You are here:.

Hierarchickou navigační stopu lze aktivovat pomocí volby config:youarehere.

• config:breadcrumbs Nastavte na 0 pro deaktivaci.
• config:youarehere

• Textový blok Trace: pro sledovací navigační stopu a You are here: pro hierarchickou navigační stopu nelze upravit přes Správce konfigurace. Lze je však upravit nebo odstranit přepsáním jazykové konfigurace. Například:
  • Anglický (en) text Trace: lze upravit v souboru conf/lang/en/lang.php přidáním $lang['breadcrumbs'] = "" (pro zobrazení bez předpony) nebo $lang['breadcrumbs'] = "Recent:" (pro změnu předpony).
  • Anglický (en) text You are here: lze upravit v souboru conf/lang/en/lang.php přidáním $lang['youarehere'] = "" (pro zobrazení bez předpony) nebo $lang['youarehere'] = "Current Destination:" (pro změnu předpony).
• Způsob a umístění vykreslení bloku navigační stopy závisí především na šabloně.
• Šablona MIKIO s vysoce přizpůsobitelnou konfigurací má nastavení breadcrumbPrefixText pro vlastní úpravu: Pozor, jedná se pouze o jednu předponu použitou pro všechny typy navigační stopy, nikoli samostatně pro hierarchickou navigační stopu a sledovací navigační stopu.
• Pokud si přejete upravit předponu ve svém pluginu:
  • požádejte autora o možnost úpravy,
  • nebo (jako rychlé řešení) najděte řetězec v šabloně a přepište ho,
  • případně se podívejte, co nabízí localization v tomto ohledu.

Navigační stopy se ukládají do uživatelské relace. Vývojáři šablon by měli zajistit prostor pro oba typy navigační stopy pomocí funkcí tpl_breadcrumbs() a tpl_youarehere().