Index: trunk/CHANGELOG =================================================================== --- trunk/CHANGELOG (revision 858) +++ trunk/CHANGELOG (revision 859) @@ -10,20 +10,22 @@ # = Bugfix ! = Update/Change -------------------------------------- 2.7.1 ------------------------------------- -18-Sep-2008 Thomas Hornik -+ Added captcha-reload -16-Sep-2008 Thomas Hornik -# search: fixed windows-related regex issue +------------------------------------- 2.7.1 ------------------------------------- 19-Aug-2008 Matthias Gallas +! updated show_menu2 to version 4.7 +18-Sep-2008 Thomas Hornik ++ Added captcha-reload +16-Sep-2008 Thomas Hornik +# search: fixed windows-related regex issue +19-Aug-2008 Matthias Gallas ! updated to latest FCKEditor version 2.6.3 02-Aug-2008 Thomas Hornik -# fixed sorting order of search-results +# fixed sorting order of search-results 25-Jul-2008 Thomas Hornik -# fixed an issues related to search, changed one SQL inner join (to use USING instead of WHERE) -! added $database = new Database(); in front of output-filter +# fixed an issues related to search, changed one SQL inner join (to use USING instead of WHERE) +! added $database = new Database(); in front of output-filter 05-Jul-2008 Thomas Hornik -# fixed MODI_DATE/PUBLISHED_DATE issue in news-module. Added PUBLISHED_TIME, removed PUBL_DATE,PUBL_TIME. Thanks to forum-member timorotha +# fixed MODI_DATE/PUBLISHED_DATE issue in news-module. Added PUBLISHED_TIME, removed PUBL_DATE,PUBL_TIME. Thanks to forum-member timorotha 02-Jul-2008 Christian Sommer ! updated to latest FCKEditor version 2.6.2 01-Jul-2008 Thomas Hornik Index: trunk/wb/modules/show_menu2/info.php =================================================================== --- trunk/wb/modules/show_menu2/info.php (revision 858) +++ trunk/wb/modules/show_menu2/info.php (revision 859) @@ -1,7 +1,4 @@ Module aufrufen. -4. Wenn bereits eine frühere Version von show_menu2 installiert ist, diese über "Modul deinstallieren" auswählen und deinstallieren. -5. Im Abschnitt "Modul installieren" das im Schritt 1 heruntergeladene zip-File auswählen und installieren. +4. Wenn bereits eine frühere Version von show_menu2 installiert ist, diese über + "Modul deinstallieren" auswählen und deinstallieren. +5. Im Abschnitt "Modul installieren" das im Schritt 1 heruntergeladene zip-File + auswählen und installieren. + 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. +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. -In den meisten Fällen genügt bereits der Standardaufruf ohne weitere Parameter von show_menu2. In diesem Fall werden die Vorgabewerte verwendet, dies erzeugt ein Menü das die aktuelle Seite und die Unterseiten der aktuellen Seite anzeigt: +In den meisten Fällen genügt bereits der Standardaufruf ohne weitere Parameter +von show_menu2. In diesem Fall werden die Vorgabewerte verwendet, dies erzeugt +ein Menü das die aktuelle Seite und die Unterseiten der aktuellen Seite anzeigt: - show_menu2(); + show_menu2(); -Bitte beachten: der Aufruf von show_menu2 ist PHP und muss normalerweise in PHP-Codezeichen eingeschlossen werden (ausser der Aufruf erfolgt bereits innerhalb von PHP Code): +Bitte beachten: der Aufruf von show_menu2 ist PHP und muss normalerweise in PHP- +Codezeichen eingeschlossen werden (ausser der Aufruf erfolgt bereits innerhalb +von PHP Code): -Dieses Vorgabe Menü erzeugt bereits ein komplettes Menü auf Listenbasis mit etlichen Klassen, die eine leichte 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". Dies erlaubt es sehr differenzierte CSS Regeln für die einzelnen Menüpunkte aufzustellen. +Dieses Vorgabe Menü erzeugt bereits ein komplettes Menü auf Listenbasis mit +etlichen Klassen, die eine leichte 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: +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); @@ -41,11 +70,58 @@ show_menu2(0, SM2_CURR+1, SM2_CURR+2); -Es gibt jede Menge Möglichkeiten, um die unterschiedlichten Menüstrukturen zu erzeugen, zahlreiche Beispiele dazu findet man auf der Demo-Website: http://code.jellycan.com/sm2test/ +Es gibt jede Menge Möglichkeiten, um die unterschiedlichsten Menüstrukturen zu +erzeugen. Zahlreiche Beispiele dazu findet man auf der Demo-Website: http:// +code.jellycan.com/sm2test/ + +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 nichts mit show_menu2 zu tun. Um ein Drop-Down Menü zu erzeugen muß + lediglich der CSS-Code des jeweiligen Templates angepaßt werden. Die nötigen + Anpassungen findet man z.B. im "allcss2" Template aus dem WB Addon + Repository -> http://addons.websitebaker.org/pages/templates.php + + +Q: Warum verschwindet das Menü nachdem ich in einer mehrsprachigen WB-Site die + Suchfunktion benutzt habe? +A: Im verwendeten Template fehlen die notwendigen Zeilen: + + 1. Im WB Admin Backend: Optionen -> 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: http://help.websitebaker.org/pages/de/advanced-doku/designer-guide/mehrsprachige-webseiten.php + + +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. + + + FUNKTION ======== + Der komplette Aufruf und die Vorgabe Parameterwerte für show_menu2 sind wie folgt: show_menu2( @@ -52,7 +128,7 @@ $aMenu = 0, $aStart = SM2_ROOT, $aMaxLevel = SM2_CURR+1, - $aFlags = SM2_TRIM, + $aOptions = SM2_TRIM, $aItemOpen = '[li][a][menu_title]', $aItemClose = '
    • ', $aMenuOpen = '[ul]', @@ -61,22 +137,44 @@ $aTopMenuOpen = false ) -Im Abschnitt "Parameter" findet sich eine detaillierte Beschreibung jedes einzelnen Parameters. -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: +Im Abschnitt "Parameter" findet sich eine detaillierte Beschreibung jedes +einzelnen Parameters. +Jeder Parameter muß absolut korrekt verwendet werden. Folgende Regeln können +dabei helfen: -show_menu2(0, SM2_ROOT, SM2_ALL, SM2_ALL, false, false, '
      ', '
    '); + $aMenu = 0 ist in den meisten Anwendungsfällen der beste Wert. + + $aStart muß 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. -Bitte beachten: bis einschliessich $aFlags müssen alle Parameter explizit übergeben werden! + 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 einschliesslich $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 erforderlich, auch mehrere Klassen erhalten können. +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 + KLASSE ZUORDNUNG ------------ ------------------------------------------------------- - menu-top Nur der erste Menüpunkt + 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. @@ -85,10 +183,11 @@ 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: + 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. + 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 @@ -137,58 +236,59 @@ PARAMETER ========= $aMenu - Nummer des Menüs. Dies ist nützlich um mehrere Menüs auf einer Seite zu verwenden. + 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: + 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 unterhalbe der obersten Ebene - SM2_ROOT+2 Beginnt zwei Ebenen unterhalbe der obersten Ebene + 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 + 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 + 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 + 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_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_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 + 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_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 Starting level only (same as SM2_START) - SM2_MAX+1 Maximum of starting level and 1 level. + SM2_MAX Nur die Startebene (gleiche Wirkung wie SM2_START) + SM2_MAX+1 Die Startebene und eine Ebene darunter. -$aFlags +$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. + sowohl TRIM als auch PRETTY zu definieren, verwendet man: (SM2_TRIM | SM2_PRETTY). GROUP 1 ------- @@ -233,7 +333,7 @@ ------- Diese Flags sind optional, sie können in beliebiger Anzahl kombiniert werden. - SM2_NUMCLAss Fügt die nummerierten Menüklassen "menu-N" und + 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. @@ -247,18 +347,19 @@ 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. + 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. Dies ist besonders nützlich - beim Debuggen der Menüausgabe. + 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 al kompletten String aus. + 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 + Dieses Flag kann bei Bedarf mit jedem Flag aus der Gruppe 1 kombiniert werden. SM2_ESCAPE Wendet htmlspecialchars auf den Menüstring an. @@ -266,26 +367,30 @@ sein um eine valide HTML Ausgabe zu erzeugen. SM2_NOESCAPE Dies ist das Standarverhalten und existiert nur aus Gründen der - Abwärtskompatibiltät. + Abwärtskompatibilität. + 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 Kompatibiltät zur Website Baker - Standardfunktion show_menu() zu gewährleiten. + '[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 + 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. Im Abschnitt "Formatter" findet sich dazu eine detailierte - Beschreibung. Wenn hier ein Formatter angegeben wird, werden alle Argumente - nach $aItenOpen ignoriert. + 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 schliesst jeden Menüpunkt ab. + 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. @@ -298,7 +403,7 @@ verwendet. $aMenuClose - Dieser String schliesst jedes Menü ab. + 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. @@ -311,11 +416,37 @@ 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 werden durch den entsprechenden Text ersetzt. +verwendet werden und sollen durch den entsprechenden Text ersetzt werden. [a] tag ohne Klasse: '' [ac] tag mit Klasse: '' @@ -322,23 +453,27 @@ [li]
  • tag mit Klasse: '
  • ' [ul]