Hinweis
Das Modul ist ab Version 5  nicht mehr enthalten. Das neue Modul Tree ist leichter zu benutzen bei komplexeren Navigationsstrukturen.

Einführung
Das Modul übernimmt die Darstellung von Menüpunkten. Dabei ist eine kombinierte Darstellung von Haupt- und Unterpunkten genauso möglich wie eine getrennte.

Templates
Für jede Ebene der Website-Struktur müssen drei Templates angelegt werden:
menu/button_X - inaktiver Menüpunkt
menu/button_aktiv_X - aktiver Menüpunkt
menu/between_button_X - wird zwischen zwei Menüpunkten der gleichen Ebene ausgegeben.

Das X gibt dabei die Ebene an. Für Ebene zweiwerden z.B. folgende Templates benutzt:
menu/button_2, menu/button_aktiv_2 und menu/between_button_2.

Hinweis: Um nicht Templates für unendlich viele Ebenen anlegen zu müssen, kann die maximal verwendete Template-Ebene mit dem Parameter maxtemplate beschränkt werden (sieh unten).

In den Templates werden die folgenden Platzhalter ersetzt:
{name} - der Name der Seite
{link} - ein Link zur Seite
{position} - Position der Seite
{title} - Überschrift der Seite
{date} -Das Datum der Seite
{description} - Beschreibung der Seite (Dialog Meta -> Description)
{keywords} - Schlüsselwörter der Seite (Dialog Meta -> Keywords)

Beispiel
Es gibt zwei Seiten im System:
1.
Name=Homepage
Position=001
Überschrift=eforia CMS Demo
Datum=05.05.2001
Description=First Page
Keywords=cms

2.
Name=Testpage
Position=002
Überschrift=eforia CMS Test
Datum=05.10.2001
Description=Test Page
Keywords=test

Die Templates der ersten Ebene:
menu/button_1:

menu/button_aktiv_1:

menu/between_button_1:

Eingebunden ist das Menü ganz einfach mit {execmacro="menu"} ohne Parameter. Ist die erste Seite aktuell (aktiv), wird folgendes ausgegeben:
1. menu/button_aktiv_1 mit Ersetzung der Felder von Seite 1
2. menu/between_button_1
3. menu/button_1 mit Ersetzung der Felder von Seite 2

Das ergibt folgenden Code:

Wobei {-url-} durch die URL zum Aufruf der jeweiligen Seite ersetzt ist.


Aufruf
Der Aufrufstring ist{execmacro="menu" param="param"}.

Parameter:
Für param sind folgende Parameter erlaubt:

maxtemplate=Ebene
Für jede Ebene werden die Templates menu/button_X, menu/button_aktiv_X und menu/between_button_X benötigt. Um hier nicht unnötig viele Templates definieren zu müssen, gibt man maxtemplate an. Bei tieferen Ebenen wird dann automatisch diese Ebene genommen.

mainonly
Gibt an, dass nur die Ebene 1 ausgegeben wird. Das ist dan sinnvoll, wenn Haupt- und Untermenü getrennt werden sollen. Typischer Anwendungsfall sind Navigationen, bei denen die Hauptpunkte am oberen und die Unterpunkte am linken Bildschirmrand untergebracht sind. Mit mainonly werden nur die Hauptpunkte ausgegeben.

subonly
Gibt an, dass Ebene 1 nicht ausgegeben wird (also nur die Unterpunkte). subonly ist quasi das Gegenstück zu mainonly.

levelX
Es wird nur die Ebene X ausgegeben.


Die einzelnen Werte werden mit Strichpunkt (;) getrennt.

Beispiel:
{execmacro="menu" param="maxtemplate=3"}
Stellt ein Menü über alle Ebenen dar, benutzt aber maximal Template _3.

{execmacro="menu" param="mainonly"}
Stellt nur die Menüpunkte der obersten Ebene dar.

{execmacro="menu" param="maxtemplate=3;subonly"}
Stellt ein Menü über alle Ebenen außer der Ersten dar, benutzt maximal Template _3.


Hinweis:
Auf der Seite Tools gibt es eine Hilfsfunktion, um die Menü-Templates zentral und einfacher verwalten zu können.


INI-Datei:
Einstellungen in menu.ini: