Navigationsmodul

Das ty:nav Element ermöglicht das Auslesen der mit myty administrierten Seiten- bzw. Navigationsstruktur. Dabei können die verschiedenen Navigationsebenen getrennt voneinander ausgelesen werden. Unterpunkte können gleichzeitig dargestellt werden. Aktive Menüpunkte sind durch erweiterte Darstellungsoptionen gesondert visualisierbar.

Neben der Seitennavigation ist es des Weiteren möglich, auch Sitemaps und Pfadnavigationen zu erzeugen, welche der Orientierung innerhalb der Webseiten dienen und somit die Nutzerfreundlichkeit erhöhen.

Jedem Navigationspunkt können über das Navigationsmodul Schlagworte zugeordnet werden, welche dann in einem Schlagwortindex oder aber als meta-Tags im Seitenkopf ausgegeben werden können.

Mit Hilfe des ty:nav Elements ist es somit möglich, eine unterschiedlichste Navigationsmechanismen innerhalb einer Webseite dynamisch zu erzeugen.

• type - Mit type können verschiedene Navigationsmodule ausgewählt werden.
  • static - Standardmodul
• level - Mit level können Sie angeben ab welcher Ebene die Navigationstruktur angezeigt werden soll.
• mode - Bei mode= „siteuser“, werden dem angemeldetetn Siteuser alle ihm zugänglichen Seiten angezeigt.
• excluded - Alle in excluded enthaltenen Seiten werden in der Navigation nicht mit ausgegeben.
  • excluded=„topic1,topic2,topicN“ (Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird.)
• excludedNormal - Alle in excludedNormal enthaltenen Seiten werden in der Navigation nicht mit ausgegeben. Beim angemeldeten Redakteur werden diese Seiten in der Navigation angezeigt.
  • excludedNormal=„topic1,topic2,topicN“ (Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird. )
• excludedEdit - Alle in excludedEdit enthaltenen Seiten werden in der Navigation mit ausgegeben, allerdings nicht beim angemeldeten Redakteur.
  • excludedEdit=„topic1,topic2,topicN“ (Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird.)
• topic - Es werden alle Unterseiten zur Seite topic ausgegeben.
• recurse - Mit recurse=„true“ lassen sich alle Seiten der Navigationsstruktur rekursiv ausgegeben, womit beispielsweise eine Sitemap generieren werden kann. (Vorraussetzungen: ty-nav:iterate mit type=„all“)

Die Subelemente des ty:nav Elements folgen der Syntax ty-nav:name und führen spezielle Funktionen bei der Erzeugung der Navigationsstruktur aus.

• ty-nav:caption - Zeigt die Seitenbezeichnung in der aktuellen Sprache an.
• ty-nav:level - Gibt die Ebenennummer eines Navigationspunktes aus.
• ty-nav:topic - Gibt den Seitennamen aus
• ty-nav:url - Gibt den relativen Pfad zur Seite in der aktuellen Sprache aus.
• ty-nav:target - definiert das Verweisziel des Navigationspunktes (_self oder _blank).
• ty-nav:isTopic - Eingeschlossen in dieses Element kann Quelltext oder Text ausgegeben werden, wenn es sich um den aktuellen Navigationspunkt handelt.
• ty-nav:isParentTopic - Eingeschlossen in dieses Element kann Quelltext oder Text ausgegeben werden, wenn es sich um das Elternelement des aktuellen Navigationspunkt handelt.
• ty-nav:childs - der in diesem Element eingeschlossene Inhalt wird ausgegeben wenn es Unterpunkte zum aktuell gewählten Navigationspunkt gibt.
• ty-nav:iterate - zeigt alle Unterpunkte des aktuell gewählten Navigationspunktes an.
  • type - type=„all“ zeigt die Unterpunkte aller Seiten an
• ty-nav:itemNumber - Gibt die laufende Nummer eines Navigationspunktes in der aktuellen Ebene beginnend bei 0 aus.
• ty-nav:ifIterates - Der Inhalt dieses Tags wird ausgegeben, wenn Unterpunkte existieren und diese mit dem ty-nav:iterate-Tag ausgegeben werden.

Es wird die Navigationsebene 0 ausgelesen. Nicht mit ausgegeben werden die Menüpunkte mit den Seitennamen(topics) Startseite und Impressum. Hierbei ist auf Groß- und Kleinschreibung zu achten.

Jedes anzuzeigende Navigationselement wird in einen div-Container eingeschlossen, der wiederum mit einer CSS-Klasse navL0 versehen wird. Ist das Navigationselement der aktive Navigationspunkt bzw, das Elternelement eines aktiven Navigationspunktes wir der CSS-Klasse der Zusatz -a anghehängt (navL0-a).

Im verweisenden Element a wird jeweils die Ziel-URL, das Verweisziel und die Seitenbezeichnung in der aktuellen Sprache ausgegeben.

<ty:nav type="static" level="0" excluded="Startseite,Impressum">
   <div class="navL<ty-nav:level/><ty-nav:isTopic>-a</ty-nav:isTopic><ty-nav:isParentTopic>-a</ty-nav:isParentTopic>">
      <a href="<ty-nav:url/>" target="<ty-nav:target/>"><ty-nav:caption/></a>
   </div>
</ty:nav>

Es werden in einer verschachtelten Liste alle Navigationspunkte beginnend ab Ebene 1 ausgegeben. Zunächst sind dabei nur die Menüpunkte der Ebene 1 sichtbar. Wählt der Besucher einen dieser Punkte aus, dann öffnet sich das zugehörige Untermenü usw. Die Ausgabe der Untermenüs wird mit ty-nav:iterate erzeugt. Kommt die Iteration zustande, können in ty-nav:ifIterates eingeschlossen zusätzliche Elemente definiert werden. Im Folgenden wird beispielsweise eine Unterliste erzeugt.

Die Zuweisung von CSS-Klassen erfolgt analog dem vorhergehenden Beispiel.

<ul class="navigation">
   <ty:nav type="static" level="1">
      <li class="navL<ty-nav:level/>">
	<a href="<ty-nav:url/>" target="<ty-nav:target/>" class="<ty-nav:isTopic>bold</ty-nav:isTopic> 
                 <ty-nav:isParentTopic>bold</ty-nav:isParentTopic>">
            <ty-nav:caption/>
        </a>
	<ty-nav:ifIterates><ul class="navL<ty-nav:level/>"></ty-nav:ifIterates>
	   <ty-nav:iterate/>
	<ty-nav:ifIterates></ul></ty-nav:ifIterates>
      </li>
   </ty:nav>
</ul>

Es wird die komplette Navigationsstruktur ausgegeben.

<ul class="sitemap">
   <ty:nav type="static" recurse="true">
      <li>
         <a href="<ty-nav:url/>"><ty-nav:caption/></a>
	 <ty-nav:ifIterates><ul class="sitemapL<ty-nav:level/>"></ty-nav:ifIterates>
	   <ty-nav:iterate type="all"/>
	 <ty-nav:ifIterates></ul></ty-nav:ifIterates>
      </li>
   </ty:nav>
</ul> 

Erzeugen einer Pfadnavigation ausgehend von der Startseite der Webseite in folgender Form:

Sie sind hier: Startseite / Service / Impressum

   Sie sind hier: <ty:nav type="breadCrumb" prefix=" / " postfix=" " includeSelf="true"/>