Login
Neu hier? Registrieren.
Benutzung
Der minimale Wayfinder-Aufruf
Der Snippet-Aufruf
[!Wayfinder? &startId=`0`!]
erzeugt eine ungeordnete Liste aller Dokumente im MODx-Dokumenten-Baum, die MODx dem momentanen Nutzer zu sehen erlaubt. Das bedeutet, dass solche Dokumente nicht aufgelistet werden, die unveröffentlicht, für diesen Nutzer nicht autorisiert oder für die Anzeige in Menüs versteckt sind. Die von Wayfinder erzeugte ungeordnete Liste wird so eingerückt, dass die im MODx-Dokumenten-Baum vorhandene Hierarchie wiedergegeben wird.
Für viele Webentwickler ist dieser Output alles, was sie brauchen, da die meisten zeitgenössischen Techniken zum Erstellen einfallsreicher Navigationsmenüs vom Formatieren ungeordneter Listen mittels CSS Gebrauch machen. Für Beispiele siehe http://www.cssplay.co.uk/ und http://css.maxdesign.com.au/.
Wayfinder als Ersatz für DropMenu verwenden
Manche älteren Templates verwenden vielleicht das missbilligte Snippet DropMenu statt den WayFinder. Das DropMenu-Snippet ist in MODx 0.9.5 oder höher nicht enthalten. Diese Templates können oft sehr einfach an den Gebrauch des Wayfinder anstelle des DropMenu angepasst werden.
- Dieser DropMenu-Aufruf:
-
[!DropMenu? startDoc=`0` &levelLimit=`1`!]
- kann ersetzt werden durch:
-
[!Wayfinder? &startId=`0` &level=1!]
In der Mitte des MODx-Dokumenten-Baums beginnen
Der Wayfinder-Aufruf mit dem &startItem-Parameter-Wert "0" sagt Wayfinder, an der Wurzel (root) des MODx-Dokumenten-Baums zu beginnen und (soweit möglich) alle Dokumente des gesamten Baums aufzulisten. Man kann jedoch Wayfinder auch an jeder gewünschten Stelle des Baumes starten lassen, indem man den Parameter &startItem auf die ID desjenigen Dokuments setzt, das sich eine Ebene über der befindet, in der das Listing beginnen soll. Somit listet Wayfinder stets die Nachkommen des Dokuments auf, das im &startItem-Parameter angegeben ist; dieses "Start-"-Dokument selbst wird jedoch nicht mit in die Liste aufgenommen.
Begrenzung der Anzahl gezeigter Ebenen
Als Voreinstellung listet Wayfinder alle (sichtbaren) Nachkommen des angegebenen Start-Dokuments auf, egal wie viele Ebenen tief sie im MODx-Dokumenten-Baum verschachtelt sind. Man kann dieses Verhalten mit dem Parameter &level überschreiben, mit dem man die Anzahl der Hierarchie-Ebenen angibt, die im Listing berücksicht werden sollen. Beispiel:
Der Snippet-Aufruf
[!Wayfinder? &startId=`XXX` &level=`1`!]
lässt Wayfinder nur die unmittelbaren Kinder des Dokuments mit der ID XXX auflisten.
Der Snippet-Aufruf
[!Wayfinder? &startId=`XXX` &level=`2`!]
lässt Wayfinder die Kinder und die Enkel (d.h. zwei Hierarchie-Ebenen) des Dokuments mit der ID XXX auflisten.
Um alle Nachkommen-Ebenen auflisten zu lassen, kann man entweder Wayfinder ohne den &level-Parameter aufrufen, oder man setzt &level=`0`.
CSS-Styles auf den Output anwenden
Benutzen Sie die weiter unten beschriebenen CSS-bezogenen Parameter, um CSS-Klassen auf bestimmte Teile des Wayfinder-Outputs anzuwenden, und stellen Sie dann sicher, dass die betroffene Web-Seite ein entsprechendes CSS-Stylesheet enthält oder referenziert. Es gibt auch einen Wayfinder-Parameter, der erzwingt, dass ein bestimmtes Stylesheet auf allen Seiten referenziert wird, die einen Wayfinder-Aufruf enthalten.
Benutzerdefinierte Formatierung erzeugen
Viele Nutzer finden, dass die einfache CSS-Formatierung der von Wayfinder standardmäßig ausgegebenen ungeordneten Liste ihnen genügend Flexibilität liefert. Wenn Sie jedoch die grundlegende HTML-Struktur des Wayfinder-Outputs geändert haben wollen, können Sie eigene Templates erstellen, die Wayfinder zwingen, HTML-Tabellen, XML-Daten oder so ziemlich jedes andere textbasierte Format, das Sie vielleicht brauchen, auszugeben.
Siehe dazu die Abschnitte weiter unten über Template-Parameter und über Templates und Platzhalter.
JavaScript-Verhalten auf den Wayfinder-Output anwenden
JavaScripts und JavaScript-Aufrufe können in jedes von Ihnen erstellte Template eingebettet werden. Und es gibt auch einen Wayfinder-Parameter, der erzwingt, dass eine bestimmte JavaScript-Datei in jeder Web-Seite referenziert wird, die einen Wayfinder-Aufruf enthält.