ModX Tutorial

Changing the net, one site at a time…

Wayfinder einbinden
tutorialtutorialwwwwarning-icon 
1. Allgemeines:
 
 
Wayfinder ist ein MODx-Snippet, dessen Hauptzweck die Erzeugung von Navigationsmenüs ist, die sich automatisch anpassen, wenn Änderungen am MODx-Dokumentenbaum vorgenommen werden.

Bei jedem Aufruf von Wayfinder scannt er einen angegebenen Bereich des MODx-Dokumentenbaums, ermittelt alle Dokumente, die vorgegebene Bedingungen erfüllen und gibt eine formatierte Liste dieser Dokumente aus.
Die Formatierung der Ausgabe ist template-gesteuert und kann Kombinationen von HTML, CSS und JavaScript enthalten, was zu einem enormen Grad an Flexibilität führt. Auf diese Weise hat man große Kontrolle über den Inhalt, das Aussehen und das Verhalten des erzeugten Outputs.

Da man mehrfache Aufrufe von Wayfinder auf einer einzelnen Seite machen kann, die sich auf verschiedene Abschnitte des Dokumenten-Baums beziehen können, kann man mehrere Navigationsmenüs oder Dokument-Listen auf ein und derselben Seite haben. Zum Beispiel möchten Sie vielleicht ein Hauptmenü am oberen Rand der Seite haben und dann links und rechts Untermenüs für Produkte, Serviceleistungen, Teams, Rollen usw. -- wobei jedes die Dokumente eines anderen Teils des Dokumenten-Baums auflistet. Zusätzlich wollen Sie vielleicht eine Brotkrumen-Zeile haben. All dies kann auf derselben Seite vorkommen.

Quelle: modx.cms
2. Einfacher Wayfinder Call
#af33b7

Der Call [ [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.

Um alle Nachkommen-Ebenen auflisten zu lassen, kann man entweder Wayfinder ohne den &level-Parameter aufrufen, oder man setzt &level=`0`.

Der Wayfinder-Aufruf mit dem &startItem-Parameter-Wert "0" sagt Wayfinder, am "root" des MODx-Dokumenten-Baums zu beginnen und (soweit möglich) alle Dokumente des gesamten Baums aufzulisten.

Wayfinder-Call:

<div="nav-container"><!--Start Navigation-->
[ [Wayfinder? &startId=`0`]]
</div><!--End Navigation-->

 

3. Anzahl gezeigter Ebenen festlegen
 
Der Snippet-Call: [ !Wayfinder? &startId=`0` &level=`1`! ] lässt Wayfinder nur die unmittelbaren Child-Dokumente der StartId `0` auflisten.

Der Snippet-Call: [ !Wayfinder? &startId=`XXX` &level=`2`! ] lässt Wayfinder die Child-Dokumente und die zwei Hierarchie-Ebene der Dokumente, die von der StartId `0`ausgehen, auflisten.
 
4. zweite Navigationshierarchie:
 

 

 

Bei der zweiten Navigationshierarchie wird dem Wayfinder nicht die StartId Null, sondern die des Ultimate parents der Ebene 1 gegeben.

Das heißt, dass das Menü im Div-Tag mit der ID "navcontainer" nur eine Hierarchieebene an Dokumenten darstellt, die dem jeweiligen übergeordneten Parent-Dokument zugeordnet ist.

Wayfinder-CAll für die zweite Navigationshierarchie:

 

<div id="navcontainer2"><!--Start Second Navigation-->
<ul><li>[ !Wayfinder?startId=`[ [UltimateParent?topLevel=`1`]]`]]</ul></li>
</div><!--End SecondNavigation-->

 

 

 

Achtung!

Falls der Browser bei der Implementierung der zweiten WayFinder Hierarchie NICHTS anzeigt, kann es sein, dass dieser  "<ul>" und "<li>"-Tags benötigtt !!!

Also mal ausprobieren: erst den Call in <ul>, dannn in <li>-Tags  und wenn immer noch nicht in <ul> und <li>-Tags setzen.

 

top-icon

 


download-icon< Download der Wayfinder-Calls