Navigationsaufruf

(bitCMS v.1.0)

muShowNavigation( navfile, navtemplate [, mode] [, showstructbutton] [, output] )Die Funktion muShowNavigation() oder muGetNavigation() erzeugt, wie der Name schon sagt, die Navigation einer Seite. Folgende Parameter sind möglich:

navfile (string) - Pfad zur Datei, wo die Navigationsstruktur gespeichert ist. Übelicherweise etwas wie /de/templates/nav/navitems.dat.php
navtemplate (string) - Pfad zur Templatedatei für diese Navigation. Üblicherweise etwas wie /de/templates/nav/navstates.tpl
mode (string) - gibt den Modus an, wie die Navigation dargestellt werden soll. Standardmässig auf 1-5|sub (in bitCMS Versionen < 1.15 1|sub) gesetzt. Folgende Modi sind möglich:

x-y|sub|z - hier wird die Navigation ab Level x ausgegeben (x muss natürlich durch den entsprechenden Navigatiosnlevel ersetzt werden). Ist ein Navigationspunkt gewählt, werden auch dessen Unterpunkt (sub) dem Navigationstemplate entsprechend angezeigt.
Ab Version 1.15 kann mit z der Level angegeben werden, bis zu dem alle Navigationspunkte angezeigt werden, auch wenn noch gar kein Navigationspunkt gewählt ist.
Ab Version 2.3 kann mit y die Anzeige der Unterpunkte zusätzlich limitiert werden. 1-3|sub würde somit nur Punkte aus den Navigationsstufen 1 bis 3 anzeigen.
x|all - hier wird die vollständige Navigation ab Level x angezeigt, egal ob ein entsprechender Navigationspunkt gewählt ist oder nicht. Dies ist üblich bei einer Sitemap Darstellung, wo man eben die gesamte Navigation ausgeklappt präsentiert bekommt.

showstructbutton (boolean) - mit Hilfe dieses Flags kann gesteuert werde, ob der Struktur bearbeiten Button bei der Navigation in eingeloggtem Zustand angezeigt werden soll. Dieser wert ist standardmässig auf true gesetzt, der Button wird somit angezeigt, wollen Sie dies verhindern, zB bei mehreren Navigationaufrufen auf einer Seite, müssen Sie den Wert auf false setzen.
output (boolean) - bei true wird die Navigation mittels echo ausgegeben, bei false gibt die Funktion die Navigation als String zurück.

Die Funktion muShowNavigation() gibt als Resultat einen HTML String aus oder zurück (je nachdem wie output gesetzt ist), der die gesamte Navigation enthält.

Sehen Sie auch: Navigationstemplate

Code Beispiele

Folgenden PHP Code ist an der Stelle auf einer Seite einzufügen, an welcher die Navigation angezeigt werden soll. Dieser Aufruf unten zeigt die Navigation ab Stufe 1 und, falls Navigationspunkte gewählt sind, deren Unterpunkte.
<? muShowNavigation("/de/templates/nav/navitems.dat.php", "/de/templates/nav/navstates.tpl", "1|sub", false);?>

Wollen Sie eine Navigation, ähnlich dieser hier auf der bitCMS Seite, wo die Navigationspunkte der Stufe 2 und 3 an einer anderen Stelle angezeigt werden als die Punkte der Stufe 1, fügen Sie an der Stelle wo die Stufe 1 hin soll

<? muShowNavigation("/de/templates/nav/navitems.dat.php", "/de/templates/nav/navstates.tpl", "1-1|sub", true);?>ein und an jener Stelle, wo die Unterpunkte angezeigt werden sollen
<? muShowNavigation("/de/templates/nav/navitems.dat.php", "/de/templates/nav/navstates.tpl", "2|sub", false); ?>

Das Setzen von false als letzter Parameter bewirkt nun, dass der Struktur bearbeiten Button nur einmal - nämlich bei dem ersten Navigationsaufruf (Stufe 1) - angezeigt wird.