show_menu2, version 4.9.x ========================= Ist ein Code-Snippet WBCE CMS. Alle für die Erzeugung des Menüs erforderlichen Daten werden durch eine einzige Datenbankabfrage erzeugt. Durch umfangreiche Anpassungsmöglichkeiten des erzeugten HTML-Code können alle möglichen Menüarten (Listen, Breadcrumbs, Sitemaps, usw.) erzeugt werden. --- Deutsche Übersetzung von BerndJM. Dies ist eine weitgehend direkte Übersetzung des englischen Originals. Bei Übersetzungs- oder Interpretationsfehlern, bitte eine Email an support (--at--) wbce.org. Kleinere Aktualisierung von florian, 21.09.2018 --- INSTALLATION ============ Das Modul ist ein Coremodul und braucht nicht extra installiert zu werden. BENUTZUNG VON SHOW_MENU2 ======================== Um show_menu2 zu benutzen, muss das verwendete Template an den Stellen modifiziert werden, an denen das Menü erscheinen soll. Bitte beachten: Wenn alte Menüaufrufe ersetzt werden, müssen unbedingt auch die entsprechenden neuen Parameter verwendet werden, die show_menu2 benötigt. Achtung: Seit WBCE 1.3.1 wird der alte show_menu()-Aufruf NICHT mehr unterstützt und führt zu einem PHP-Fehler! In manchen Fällen genügt bereits der Standardaufruf ohne weitere Parameter von show_menu2. In diesem Fall werden die Vorgabewerte verwendet, diese erzeugen ein Menü, das die aktuelle Seite und die Unterseiten der aktuellen Seite anzeigt: show_menu2(); Bitte beachten: der Aufruf von show_menu2 ist PHP und muss normalerweise in PHP- Codezeichen eingeschlossen werden (außer der Aufruf erfolgt bereits innerhalb von PHP Code): Die Standardausgabe erzeugt bereits ein komplettes Menü auf Listenbasis mit etlichen Klassen, die eine Formatierung mittels CSS ermöglichen. Es wird z.B. die Klasse "menu-current" zu dem
  • -Tag des aktuellen Menüpunktes hinzugefügt. Zusätzlich erhält jeder Menüpunkt, der Unterpunkte enthält, die Klasse "menu-expand". Das erlaubt es, sehr differenzierte CSS Regeln für die einzelnen Menüpunkte aufzustellen. Zum Beispiel: li.menu-expand { font-weight: bold; } li.menu-current { background: red; } Im Abschnitt "HTML-Ausgabe" findet sich eine detaillierte Beschreibung, welche Klassen welchem Element zugeordnet werden. Durch die Verwendung von verschiedenen Parametern bei dem show_menu2 Funktionsaufruf lassen sich auch recht umfangreiche und unterschiedliche Menüstrukturen erzeugen. Um beispielsweise nur Menüpunkte aus der obersten Ebene der Menüstruktur darzustellen, könnte man folgenden Aufruf verwenden: show_menu2(0, SM2_ROOT, SM2_START); Oder um beispielsweise bis zu zwei Unterebenen der aktuellen Seite anzuzeigen: show_menu2(0, SM2_CURR+1, SM2_CURR+2); Es gibt jede Menge Möglichkeiten, um die unterschiedlichsten Menüstrukturen zu erzeugen. Zahlreiche Beispiele dazu findet man auf der Demo-Website: https://sm2.wbce-cms.org/ HÄUFIGE FRAGEN ============== Q: Ich bin kein Programmierer. Gibt es keine einfachere Dokumentation? A: Nein, denn dies hier ist bereits die einfache Dokumentation. Q: Wie kann ich ein sogenanntes Drop-Down Menü erstellen? A: Dies hat nur mittelbar etwas mit show_menu2 zu tun. Um ein Drop-Down Menü zu erzeugen, muss der CSS-Code des jeweiligen Templates angepaßt werden. Q: Warum verschwindet das Menü nachdem ich in einer mehrsprachigen Site die Suchfunktion benutzt habe? A: Im verwendeten Template fehlen die notwendigen Zeilen: 1. Im Backend: Grundeinstellungen -> Erweiterte Optionen anzeigen -> Suchoptionen -> Kopfzeile - hier direkt nach dem öffnenden
    tag folgende Zeile einfügen: 2. In der index.php des verwendeten Templates folgende Zeile unmittelbar nach dem öffnenden tag der Suche einfügen: Q: Mehrsprachig? Das klingt toll. Wie macht man das? A: https://addons.wbce.org/pages/addons.php?do=item&item=3 Q: Jedesmal wenn eine Seite aufgerufen wird, erzeugt SM2 folgende Warnmeldung: "show_menu2 error: $aOptions is invalid. No flags from group 1 supplied!" A: Der Funktion wurden die falschen Werte oder eine falsche Anzahl an Werten übergeben. Siehe den Abschnitt PARAMETER für die korrekten Flag Werte die dem $aOptions Parameter zu übergeben sind. Q: How do I use a different class/picture/color/widget for each entry in a menu? A: Use the [page_id] format string in the $aItemOpen string. Create a unique class or id for each menu item, then reference that item in your CSS or Javascript to do whatever you want. To add a unique class for each menu item (or similar): "
  • [menu_title]" ... creating menu items like ...
  • Top Menu Reference this in your CSS like: a.p45 { color: red; } To add a unique ID for each menu item (or similar): "
  • [menu_title]" ... creating menu items like ...
  • Top Menu Reference this in your CSS like: a#p45 { color: red; } Note that the ID can only be used if that menu is generated and displayed one time only on the page (because HTML ID's must be unique within a page). FUNKTION ======== Der komplette Aufruf und die Vorgabe Parameterwerte für show_menu2 sind wie folgt: show_menu2( $aMenu = 0, $aStart = SM2_ROOT, $aMaxLevel = SM2_CURR+1, $aOptions = SM2_TRIM, $aItemOpen = '[li][a][menu_title]', $aItemClose = '
  • ', $aMenuOpen = '[ul]', $aMenuClose = '', $aTopItemOpen = false, $aTopMenuOpen = false ) Im Abschnitt "Parameter" findet sich eine detaillierte Beschreibung jedes einzelnen Parameters. Jeder Parameter muss absolut korrekt verwendet werden. Folgende Regeln können dabei helfen: $aMenu = 0 ist in den meisten Anwendungsfällen der beste Wert. $aStart muss entweder eine page ID oder ein Wert der mit "SM2_" beginnt sein. $aMaxLevel kann nur Werte erhalten, die mit "SM2_" beginnen. $aOptions bis auf einige wenige Spezialfälle sind hier nur Werte die mit "SM2_" beginnen zulässig. Alle weiteren Parameter enthalten die (HTML)Tags die die Ausgabe des Menüs steuern. Ab $aItemOpen kann jedem Parameter der Wert false übergeben werden um den jeweiligen Vorgabewert zu erhalten. Dies kann beispielsweise verwendet werden um eine nummerierte Liste zu erzeugen, während für die einzelnen Menüpunkte trotzdem die Vorgabewerte Verwendung finden: show_menu2(0, SM2_ROOT, SM2_ALL, SM2_ALL, false, false, '
      ', '
    '); Bitte beachten: bis einschließlich $aOptions müssen alle Parameter explizit übergeben werden! HTML-AUSGABE ============ Die HTML-Ausgabe hängt wesentlich davon ab, welche Parameter an die Funktion übergeben werden. Unabhängig davon werden nachfolgende Klassen grundsätzlich für jedes Menü verwendet, wobei einzelne Menüpunkte, wenn es erforderlich ist, auch mehrere Klassen erhalten können. KLASSE ZUORDNUNG ------------ ------------------------------------------------------- menu-top Nur der erste Menüpunkt. menu-parent Jeder Hauptmenüpunkt. menu-current Nur der Menüpunkt der aktuellen Seite. menu-sibling Alle "Geschwister" der aktuellen Seite. menu-child Jedes Untermenü der aktuellen Seite. menu-expand Jedes Menü das Untermenüs hat. menu-first Der erste Punkt eines jeden Menüs oder Untermenüs. menu-last Der letzte Punkt eines jeden Menüs oder Untermenüs. Folgende Klassen werden nur hinzugefügt, wenn das SM2_NUMCLASS Flag gesetzt ist: menu-N Jeder Menüpunkt, wobei das N für die ABSOLUTE Menütiefe, beginnend bei 0, des jeweiligen Menüpunktes steht. Die oberste Ebene ist also immer menu-0, die nächste Ebene menu-1 usw. menu-child-N Jedes Untermenü der aktuellen Seiten, wobei das N für die RELATIVE Tiefe des Untermenüs, beginnend bei 0, steht. Beispiel einer HTML-Ausgabe: PARAMETER ========= $aMenu Nummer des Menüs. Diese ist nützlich um mehrere Menüs auf einer Seite zu verwenden. Menü Nummer 0 ist das Vorgabemenü der aktuellen Seite, SM2_ALLMENU gibt alle im System verwendeten Menüs zurück. $aStart Gibt an, ab welcher Ebene die Erzeugung des Menüs beginnen soll. In den meisten Fällen wird dies die oberste Ebene des anzuzeigenden Menüs sein. Es kann einer der folgenden Werte verwendet werden: SM2_ROOT+N Beginnt N Ebenen unterhalb der obersten Ebene, z.B.: SM2_ROOT Beginnt auf der obersten Ebene SM2_ROOT+1 Beginnt eine Ebene unterhalb der obersten Ebene SM2_ROOT+2 Beginnt zwei Ebenen unterhalb der obersten Ebene SM2_CURR+N Beginnt N Ebenen unterhalb der aktuellen Ebene, z.B.: SM2_CURR Beginnt auf der aktuellen Ebene. Alle Geschwister der aktuellen Ebene SM2_CURR+1 Beginnt eine Ebene unterhalb der aktuellen Ebene mit allen Unterebenen page_id Verwendet die Seite mit der angegebenen page id als Elternelement. Alle Untermenüs dieser Seite werden angezeigt. (Die page id kann ermittelt werden, wenn man die Seite im Admin-Backend editiert, sie steht dann in der Adresszeile des Browsers: http://SITE/admin/pages/modify.php?page_id=35 $aMaxLevel Die maximale Anzahl der Ebenen die angezeigt werden. Die Anzeige beginnt ab der in $aStart festgelegten Ebene, bis hin zu der hier festgelegten Ebene. SM2_ALL Keine Beschränkung, alle Ebenen werden angezeigt SM2_CURR+N Zeigt immer die aktuelle Seite + N Ebenen. SM2_CURR Aktuelle Ebene (keine Unterebene) SM2_CURR+3 Alle übergeordneten + aktuelle + 3 Unterebenen SM2_START+N Beginnt immer auf der Startebene + N Ebenen. Die Ebenen werden unabhängig davon angezeigt,egal auf welcher Ebene sich die aktuelle Seite befindet. SM2_START Eine einzelne Ebene ab der Startebene. SM2_START+1 Startebene + eine Ebene darunter. SM2_MAX+N Zeigt höchstens N Ebenen ab der Startebene. Ebenen unterhalb der aktuellen Ebene werden nicht angezeigt. SM2_MAX Nur die Startebene (gleiche Wirkung wie SM2_START) SM2_MAX+1 Die Startebene und eine Ebene darunter. $aOptions Spezielle Flags für verschiedene Menügenerierungs Optionen. Sie können mittels einer ODER Verknüpfung (|) miteinander kombiniert werden. Um beispielsweise sowohl TRIM als auch PRETTY zu definieren, verwendet man: (SM2_TRIM | SM2_PRETTY). GROUP 1 ------- Aus dieser Gruppe muss stets genau ein Flag angegeben werden. Diese Flags bestimmen auf welche Weise die Geschwisterelemente im Menübaum in der Ausgabe unterdrückt werden. SM2_ALL Zeigt alle Zweige des Menübaums A-1 -> B-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 A-2 -> B-3 -> B-4 SM2_TRIM Zeigt alle Geschwistermenüs der Seite im aktuellen Pfad. Alle Untermenüs von Elemnten die sich nicht im Pfad befinden werden entfernt. A-1 -> B-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 A-2 SM2_CRUMB Zeigt den Breadcrumb Pfad des Menüs an, also den aktuellen Menüpunkt sowie alle Menüpunkte die dorthin führen. A-1 -> B-2 -> C-2 (CURRENT) SM2_SIBLING Wie SM2_TRIM, es werden aber nur Geschwistermenüs der aktuellen Seite angezeigt. Alle anderen Punkte werden unterdrückt. A-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 GROUP 2 ------- Diese Flags sind optional, sie können in beliebiger Anzahl kombiniert werden. SM2_NUMCLASS Fügt die nummerierten Menüklassen "menu-N" und "menu-child-N hinzu. SM2_ALLINFO Lädt alle Felder aus der Seitentabelle der Datenbank. Dies verursacht einen ziemlich hohen Speicherverbauch und sollte deshalb nur mit Bedacht verwendet werden. Dadurch werden z.B. die Keywords, die Seitenbeschreibung sowie all die anderen Informationen verfügbar, die normalerweise nicht geladen werden. Bitte beachten: dieses Flag muss beim ERSTEN Aufruf von schow_menu2 für die jeweilige Menü ID verwendet werden, oder in Verbindung mit SM2_NOCACHE, sonst zeigt es keine Wirkung. SM2_NOCACHE Die aus der Datenbank gelesenen Daten werden bei erneutem Aufruf von show_menu2 nicht wiederverwendet sondern erneut aus der Datenbank gelesen. SM2_PRETTY Bringt die HTML-Ausgabe des Menüs mittels Leerzeichen und Zeilenumbrüchen in eine gut lesbare Form. Das ist besonders nützlich beim Debuggen der Menüausgabe. SM2_BUFFER Gibt den HTML-Code nicht direkt aus, sondern speichert ihn intern zwischen und gibt ihn als kompletten String aus. SM2_CURRTREE Schliesst alle anderen Toplevelmenüs von der Betrachtung aus. Es werden nur Menüpunkte des aktuellen Menüzweiges dargestellt. Dieses Flag kann bei Bedarf mit jedem Flag aus der Gruppe 1 kombiniert werden. SM2_ESCAPE Wendet htmlspecialchars auf den Menüstring an. Dies kann bei älteren Websitebaker Installationen erforderlich sein um eine valide HTML Ausgabe zu erzeugen. SM2_SHOWHIDDEN Hidden pages are usually hidden all of the time, including when they are active (i.e. current page or a parent page). Use private pages for time when you want pages to be hidden except when active. However for compatibility with release 4.8, supply this flag to enable hidden pages to become visible when they are active. SM2_XHTML_STRICT Stellt die XHTML-Kompatibilität der Links sicher indem in per [a] oder [ac] formatierten Links die Targetangabe entfernt und das Argument title="[page_titel]" eingefügt wird. Bei manuell zusammengestellten Links ist der Designer selbst für die XHTML-Konformität zuständig. SM2_NO_TITLE Unterdrückt die Ausgabe des Inhaltes des Title-Attributes bei [a] oder [ac] formatierten links. Im XHTML-Strikt Modus wird 'title' mit einen   ausgegeben. Für diesen Parameter gibt es auch einen erweiterten Modus, bei dem die Optionen als assoziatives Array übergeben werden. Näheres dazu im Abschnitt ERWEITERTE OPTIONEN. Für die meisten Anwendungsfälle wird dies jedoch NICHT benötigt. $aItemOpen Dies legt den Formatstring fest, mit dem jeder einzelne Menüeintrag begonnen wird. Für den allerersten Menüeintrag kann mittels $aTopItemOpen ein anderer Formatstring definiert werden. Wenn dieser Parameter auf false gesetzt wird, wird der Vorgabe Formatstring '[li][a][menu_title]' verwendet um die Kompatibilität zur Website Baker Standardfunktion show_menu() zu gewährleisten. Da die Formatierung mittels CSS-Klassen oftmals einfacher ist, wenn sie auf den tag angewendet werden, empfiehlt es sich hier folgenden Formatstring zu verwenden: '
  • [ac][menu_title]'. Dieser Parameter kann auch als Instanz eine Formatierungklasse für das Menü verwendet werden. Die nähere Beschreibung dazu findet sich im Abschnitt FORMATTER. Wenn hier ein Formatter angegeben wird, werden alle Argumente nach $aItemOpen ignoriert. $aItemClose Dieser String schließt jeden Menüpunkt ab. Bitte beachten: dies ist kein Formatstring und es werden keine Schlüsselworte ersetzt! Wenn dieser Parameter auf false gesetzt ist, wird die Vorgabe '
  • ' verwendet. $aMenuOpen Mit diesem Formatstring wird eine Liste von Menüeinträgen geöffnet. Für das erste Menü kann mittels $aTopMenuOpen ein davon abweichender Formatstring definiert werden. Wenn dieser Parameter auf false gesetzt ist wird der Vorgabewert '[ul]' verwendet. $aMenuClose Dieser String schließt jedes Menü ab. Bitte beachten: dies ist kein Formatstring und es werden keine Schlüsselworte ersetzt! Wenn dieser Parameter auf false gesetzt ist, wird die Vorgabe '' verwendet. $aTopItemOpen Der Formatstring für den allerersten Menüpunkt. Wenn dieser Parameter auf false gesetzt wird, wird der selbe Formatstring wie bei $aItemOpen verwendet. $aTopMenuOpen Der Formatstring für das erste Menü. Wenn dieser Parameter auf false gesetzt wird, wird der selbe Formatstring wie bei $aMenuOpen verwendet. ERWEITERTE OPTIONEN =================== Der Parameter $aOptions kann auf zweierlei Arten verwendet werden. Zum einen, wie oben im Abschnitt PARAMETER beschrieben, diese Art sollte für die allermeisten Anwendungsfälle ausreichen. Um allerdings in speziellen Fällen die Sonderoptionen ansprechen zu können, müssen die erforderlichen Werte als assoziatives Array bereitgestellt werden. Bitte beachten: Die SM2_* Flags sind auch hierbei erforderlich und müßen als 'flags' übergeben werden. 'flags' **ZWINGEND ERFORDELICH** Dies sind die Flags die oben im Abschnitt PARAMETER unter $aOptions beschrieben wurden. 'notrim' Hiermit wird eine Anzahl von Ebenen festegelegt, die relativ bezogen auf die in $aStart festgelegte Menüebene, immer angezeigt werden. Dies bewirkt, daß für diese Ebenen das SM2_TRIM Flag ignoriert wird. Um dieses Array zu verwenden, empfiehlt es sich es erst anzulegen und dann den $aOptions parameter mit dem angelegten Array zu beliefern: $options = array('flags' => (SM2_TRIM|...), 'notrim' => 1); show_menu2(0, SM2_ROOT, SM2_CURR+1, $options); FORMAT STRINGS ============== Die folgenden Tags können in den Formatstrings für $aItemOpen und $aMenuOpen verwendet werden und sollen durch den entsprechenden Text ersetzt werden. [a] tag ohne Klasse: '' [ac] tag mit Klasse: '' [li]
  • tag mit Klasse: '
  • ' [ul]