Weiterführende Themen

• 3.1 Mehrsprachigkeit
• 3.2 Weiterleitung nach Login
• 3.3 Templates
• 3.4 Voreinstellungen
• 3.5 Goodies
• 3.6 Automatische Erstellung

Templates

Die von mod_menu erzeugten Menüs lassen sich beliebig anpassen und auch völlig neue gestalten. Diese können einfach gehalten werden (z.B. nur eine Liste von Links durch Zeilenschaltungen getrennt) oder auch extrem komplex und grafiklastig und dennoch 100% variabel sein.

Als Anregungen und Basis zur Erstellung eigener Templates werden einige Templates als Vorlagen mitgliefert. Diese sind in eigenen Verzeichnissen im Verzeichnis templates abgespeichert.

Die Menü-Templates werden geparst, d.h. es werden wie bei PHP übliche bestimmte Bereiche durch Daten ergänzt und ggf. so lange wiederholt, bis der Seiteninhalt vollständig ist.

Dabei gibt es vier verschiedene Templates, in denen unterschiedliche Platzhalter zum Einsatz kommen:

• Vertikales Menü
• Horizontales Menü
• Level Wechsel
• Level Ende

Neben den Platzhaltern gibt es in den Templates für das vertikale und horizontale Menü noch ein paar Schlüsselworte, die der Steuerung dienen:

< !-- START_MOD_MENU_NAVIGATION -- > kennzeichnet den Beginn des Templates
< !-- ENDE_MOD_MENU_NAVIGATION -- > kennzeichnet das Ende
Diese sind unbedingt erforderlich und es darf nichts außerhalb dieser Grenzen stehen.

< !-- START_NAVITEM -- > ist der Beginn eines Menüeintrages
< !-- ENDE_NAVITEM -- > ist das Ende
Dieser Bereich wird so oft wiederholt, bis alle Menüpunkte dargestellt wurden

Ob innerhalb dieser Bereiche jetzt Tabellen, HTML-Listen oder was auch immer positioniert werden, ist dem Autor überlassen.

Innerhalb der Templates stehen folgende Platzhalter zur Verfügung, die durch das Parsen ersetzt werden:

ACHTUNG:

Diese Platzhalter enthalten keine Zeilenumbrüche, auch wenn Ihr Bildschirm oder Programm das weismachen will! Also Vorsicht bei Programmen wie Dreamweaver, die selbsttätig den Code verändern!

Folgende Platzhalter kommen in den Templates für das Vertikale und Horizontale Menü zum Einsatz:

• ### NAV_TEXT ###
  ist die Beschriftung des Menüpunktes
• ### NAV_LINK ###
  ist der Link des Menüpunktes
• ### NAV_PRE ###
  ist der Präfix, der zum Einrücken benutzt werden kann
• ### NAV_MARK ###
  ist die Grundfarbe des Elementes, wenn nicht ### NAV_HOVER ### aktiv ist
• ### NAV_LEVEL ###
  ist der Menülevel von 1 bis 4, der z.B. für das Anlegen individuelles CSS-Styles (.style1 durch class="style### NAV_LEVEL ###") benutzt werden kann
• ### NAV_GRFX_ID ###
  fällt mir gerade nicht mehr ein ;o)
• ### NAV_NEXT_LEVEL ###
  bindet das durch $levchange_template in nav_extras.php bzw. Levelwechsel-Template definierte Zwischenelement ein
• ### NAV_END ###
  bindet das durch $levend_template in nav_extras.php bzw. Levelend-Template definierte Schlußelement ein
• ### NAV_HOVER ###
  ist die Hoverfarbe des Hintergrundes und kann durch style-Anweisungen wie onmouseover=this.style.backgroundColor="### NAV_HOVER ###" onMouseOut=this.style.backgroundColor="" benutzt werden
• ### NAV_CLASS ###
  bindet die unter "Klassen" definierten CSS-Klassen ein
  • class_main (Hauptpunkt)
  • class_base (nicht aktiver Hauptpunkt)
  • class_highlight (aktueller Menüpunkt)
  • class_header (übergeordneter Menüpunkt)
• ### NAV_DIR ###
  trägt das Modul-Verzeichnis ein
• ### TEMPL_DIR ###
  trägt das aktuelle Template-verzeichnis ein
• ### NAV_TARGET ###
  ist das Target eines externen Links. Dabei wird das komplette Attribut in der Form target="..." erzeugt
• ### NAV_ACTIVE ###
  ist ein zusätzliches Attribut, das die Werte "active" und "nonactive" annehmen kann und z.B. zur Klassendefinition oder für spezielle Icons verwendet werden kann (diese Werte können in navigation.php angepasst werden)
• ### NAV_LOGIN ###
  ist ein automatisch generierter Login/Logout-Link, der innerhalb des Navigationstemplates gesetzt werden kann

Folgende Platzhalter kommen in den Templates für den Levelwechsel zum Einsatz:

• ### NAV_SHIFT ###
  enthält bei einem Levelwechsel einen String, der sich zusammensetzt aus "neuer Level"+"_"+"vorheriger Level", bei einem Wechsel von Level 1 auf 2 (also "aufwärts") wäre dies "2_1", bei einem Abwärtswechsel von Level 3 auf Level 1 dann also "1_3". SOmit lassen sich für alle Levelkombinationen entsprechende Elemente, z.B. Grafiken, erstellen
• ### NAV_DIR ###
  trägt das Modul-Verzeichnis ein
• ### TEMPL_DIR ###
  trägt das aktuelle Template-verzeichnis ein

Folgende Platzhalter kommen in den Templates für das Levelende zum Einsatz:

• ### NAV_END ###
  gibt den aktuellen Level aus für das Schlußelement, falls bei diesem Level das Ende der Navigation erreicht ist 
• ### NAV_DIR ###
  trägt das Modul-Verzeichnis ein
• ### TEMPL_DIR ###
  trägt das aktuelle Template-verzeichnis ein

 

Es müssen bei weitem nicht alle Platzhalter verwendet werden!!!