wiele Menu

show_menu2, wersja 4.9 x

Show_Menu2 jest fragmentem kodu dla WebsiteBaker CMS. Od WebsiteBaker 2.7 jest dołączony do CMS.
poprzednia funkcja show_menu jest całkowicie zastąpiona i rozszerzona o show_menu2. Wszystkie dane wymagane do utworzenia menu są generowane przez jedno zapytanie do bazy danych. Dzięki rozbudowanym możliwościom dostosowania generowanego kodu HTML wszystkie możliwe typy menu (listy, bułka tarta, mapy witryn, itp.) mogą być generowane.

• instalacja
• używanie Show_Menu2
• FAQ
• funkcja
• wyjście HTML
• parametr
• Opcje zaawansowane
• formatowanie ciągów
• formatowanie warunkowe
• formatowanie

instalacjaup

ponieważ show_menu2 jest zwykle obecny w websitebaker, nie jest wymagana instalacja. Jeśli wbrew oczekiwaniom nie istnieje, możesz go pobrać tutaj.

używając SHOW_MENU2up

aby użyć show_menu2 musisz zmodyfikować szablon, w którym ma się pojawić menu. Uwaga: Jeśli stare wywołania menu są zastępowane, należy również użyć odpowiednich nowych parametrów, których potrzebuje show_menu2.

w większości przypadków wystarczy standardowe wywołanie z co najmniej 4 parametrami show_menu2. W tym przypadku używane są wartości domyślne, to tworzy menu, które wyświetla bieżącą stronę i podstrony bieżącej strony:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

Uwaga: wywołanie show_menu2 to PHP i zwykle musi być zamknięte w znakach kodu PHP (chyba że wywołanie jest już wewnątrz kodu PHP):

 <?php show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM); ?>

to domyślne menu tworzy już kompletne menu na podstawie listy z kilkoma klasami, które umożliwiają łatwe formatowanie za pomocą CSS. Na przykład klasa „menu-current” jest dodawana do znacznika <li> bieżącego elementu menu. Dodatkowo każdy element menu podpunktów zawiera klasę „menu-expand”. Pozwala to na tworzenie bardzo zróżnicowanych reguł CSS dla każdego elementu menu.
na przykład:

li.menu-expand { font-weight: bold; }li.menu-current { background: red; }

sekcja „HTML Output” zawiera szczegółowy opis klas przypisanych do danego elementu. Używając różnych parametrów w wywołaniu funkcji show_menu2, możliwe jest również tworzenie dość rozbudowanych i różnych struktur menu. Na przykład, aby wyświetlić tylko pozycje menu z górnego poziomu struktury menu, można użyć następującego wywołania:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

lub, na przykład, aby wyświetlić do dwóch podpoziomów bieżącej strony:

show_menu2(0, SM2_CURR+1, SM2_CURR+2, SM2_TRIM);

istnieje wiele możliwości tworzenia różnych struktur menu. Liczne przykłady można znaleźć na stronie demo: KLICK

FAQup

P: nie jestem programistą. Czy nie ma prostszej dokumentacji?
A: Nie, ponieważ jest to już prosta dokumentacja.

P: Jak mogę utworzyć rozwijane menu?
A: to nie ma nic wspólnego z show_menu2. Aby utworzyć rozwijane menu, musisz tylko dostosować kod CSS odpowiedniego szablonu. Niezbędne korekty można znaleźć np. w szablonie „allcss2” z repozytorium dodatków WebsiteBaker-> https://addon.websitebaker.org/

P: Dlaczego menu zniknie po skorzystaniu z funkcji wyszukiwania na wielojęzycznej stronie internetowej?
A: brak niezbędnych linii w użytym szablonie:

<input type="hidden" name="referrer" value="" />

<input type="hidden" name="referrer" value="<?php echo defined('REFERRER_ID')?REFERRER_ID:PAGE_ID;?>" />

P: wielojęzyczny? Brzmi świetnie. Jak ty to robisz?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

P: przy każdym wywołaniu strony, SM2 generuje następujący komunikat ostrzegawczy:
” show_menu2 error: $aoptions is invalid. Nie dostarczono FLAG z grupy 1!”
A: Błędne wartości lub niewłaściwa liczba wartości zostały przekazane do funkcji.
patrz sekcja parametry dla poprawnych wartości znaczników, które należy przekazać do parametru $aOptions.

P: Jak użyć innej klasy/obrazu/koloru / widżetu dla każdej pozycji w menu?
a: użyj łańcucha formatu w łańcuchu $aitemopen. Utwórz unikalną klasę lub identyfikator dla każdego elementu menu, a następnie odwołaj się do tego elementu w CSS lub Javascript, aby zrobić, co chcesz.
aby dodać unikalną klasę dla każdego elementu menu (lub podobnego):

"<li><a href="" target="" class=" p"></a>"

… tworzenie elementów menu, takich jak …

<li><a href="/pages/foo/bar.php" target="_top" class="menu-top p45">Top Menu</a>

odwołaj się do tego w swoim CSS jak:

a.p45 { color: red; }

aby dodać unikalny identyfikator dla każdego elementu menu (lub podobnego):

"<li><a href="" target="" class=""></a>"

… tworzenie elementów menu, takich jak …

<li><a href="/pages/foo/bar.php" target="_top" class="menu-top">Top Menu</a>

odwołaj się do tego w swoim CSS jak:

a#p45 { color: red; }

zauważ, że ID może być użyte tylko wtedy, gdy to menu jest generowane i wyświetlane tylko raz na stronie (ponieważ identyfikatory HTML muszą być unikalne na stronie).

FUNCTIONup

pełne wywołanie i domyślne wartości parametrów dla show_menu2 są następujące:

show_menu2( $aMenu = 0, $aStart = SM2_ROOT, $aMaxLevel = SM2_CURR+1, $aOptions = SM2_TRIM, $aItemOpen = '</a>', $aItemClose = '</li>', $aMenuOpen = '', $aMenuClose = '</ul>', $aTopItemOpen = false, $aTopMenuOpen = false);

sekcja „parametry” zawiera szczegółowy opis każdego parametru.
każdy parametr musi być użyty absolutnie poprawnie. Poniższe zasady mogą pomóc:

$aMenu = 0 jest najlepszą wartością w większości przypadków.
$aStart musi być albo ID strony, albo wartością zaczynającą się od „SM2_”.
$aMaxLevel może pobierać tylko wartości zaczynające się od”SM2_”.
$aoptions z wyjątkiem kilku szczególnych przypadków dozwolone są tylko wartości zaczynające się od „SM2_”.
wszystkie pozostałe parametry zawierają znaczniki (HTML), które kontrolują wyjście menu.
począwszy od $aitemopen każdy parametr może być przekazany wartości false, aby uzyskać odpowiednią wartość domyślną.

można tego użyć na przykład do utworzenia numerowanej listy, podczas gdy wartości domyślne są nadal używane dla poszczególnych pozycji menu:

show_menu2(0, SM2_ROOT, SM2_ALL, SM2_ALL, false, false, '<ol>', '</ol>');

Uwaga: do $aoptions włącznie wszystkie parametry muszą być przekazane jawnie!

wyjście HTML

wyjście HTML zależy w dużej mierze od tego, które parametry są przekazywane do funkcji. Niezależnie od tego, kolejne klasy są zawsze używane dla każdego menu, przy czym poszczególne pozycje menu mogą mieć również kilka klas, jeśli to konieczne.

przykład wyjścia HTML:

<ul class="menu-top menu-0"> <li class="menu-0 menu-first"> ... </li> <li class="menu-0 menu-expand menu-parent"> ... <ul class="menu-1"> <li class="menu-1 menu-expand menu-first"> ... <ul class="menu-2"> <li class="menu-2 menu-first"> ... <li class="menu-2 menu-last"> ... </ul> </li> <li class="menu-1 menu-expand menu-parent"> ... <ul class="menu-2"> <li class="menu-2 menu-expand menu-current menu-first"> ... ** CURRENT PAGE ** <ul class="menu-3"> <li class="menu-3 menu-child menu-child-0 menu-first"> ... <ul class="menu-4"> <li class="menu-4 menu-child menu-child-1 menu-first"> ... </li> <li class="menu-4 menu-child menu-child-1 menu-last"> ... </li> </ul> </li> <li class="menu-3 menu-child menu-child-0 menu-last"> ... </li> </ul> </li> <li class="menu-2 menu-sibling menu-last"> ... </li> </ul> </li> <li class="menu-1"> ... </li> <li class="menu-1 menu-expand menu-last"> ... <ul class="menu-2"> <li class="menu-2 menu-first menu-last"> ... </li> </ul> </li> </ul> </li> <li class="menu-0 menu-last"> ... </li> </ul> 

PARAMETERup

$aMenu

$aStart

$aMaxLevel

$Aoptions

 A-1 -> B-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 A-2 -> B-3 -> B-4

 A-1 -> B-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 A-2 

A-1 -> B-2 -> C-2 (CURRENT)

 A-1 -> B-2 -> C-1 -> C-2 (CURRENT) -> D-1 -> D-2 -> C-3 

$aItemOpen

$aitemclose

$aMenuOpen

$aMenuClose

$aTopItemOpen

$aTopMenuOpen

Advanced OPTIONSup

parametr $aOptions można wykorzystać na dwa sposoby. Po pierwsze, jak opisano powyżej w sekcji Opcje, ten typ powinien wystarczyć dla większości przypadków użycia. Jednak w szczególnych przypadkach, aby odnieść się do specjalnych parametrów, niezbędne wartości muszą być podane jako tablica asocjacyjna.
Uwaga: flagi SM2_* są również potrzebne i powinny być przekazywane jako „flagi”.

$options = array('flags' => (SM2_TRIM|...), 'notrim' => 1); show_menu2(0, SM2_ROOT, SM2_CURR+1, $options);

FORMAT STRINGSup

następujące znaczniki mogą być używane w ciągach formatu dla $aitemopen i $aMenuOpen i powinny być zastąpione odpowiednim tekstem.

'<a href="" target="">'

'<a href="" target="" class="">'

'<li class="">'

'<ul class="">'

następujące znaczniki są dostępne tylko wtedy, gdy ustawiono flagę SM2_ALLINFO.

Formatowanie warunkowe w górę

Instrukcja formatowania warunkowego może przyjmować jedną z następujących form:

warunek jest kombinacją jednego lub więcej porównań logicznych.
jeśli wymagane jest więcej niż jedno porównanie, należy je połączyć z innymi porównaniami
można połączyć za pomocą || (boolean or – OR) lub && (boolean and – AND).

pojedyncze porównanie składa się z lewego argumentu, operatora i prawego argumentu.
np. X = = Y-gdzie X jest lewym operandem, = = operatorem, A Y prawym operandem.

jeśli dodana zostanie klauzula else, zostanie ona wykonana we wszystkich innych przypadkach.
na przykład, ” foo ” jest zawsze wykonywane, gdy sprawdzenie if jest błędne, więc:

Uwaga:
wszystkie kontrole będą wykonywane w kolejności, w jakiej są odnotowywane, ponieważ:

• nie ma sprawdzania możliwych Pętli (wszystkie sprawdzania są zawsze wykonywane).
• kontrole nie są zgrupowane (nawiasy kontroli nie są obsługiwane)
• obie te rzeczy mają tę samą wartość.

FORMATTERup

uwaga: jest to zaawansowana i rzadko używana funkcja!

dzięki rozległej wiedzy w zakresie programowania PHP możliwe jest użycie predefiniowanego
formatowania show_menu2 z własnym.
w załączeniu.php z show_menu2 możesz zobaczyć jak napisać formater.
API, które musi być użyte wygląda tak:

class SM2_Formatter{ // called once before any menu is processed to allow object initialization function initialize() { } // called to open the menu list function startList($aPage, $aUrl) { } // called to open the menu item function startItem($aPage, $aUrl, $aCurrSib, $aSibCount) { } // called to close the menu item function finishItem() { } // called to close the menu list function finishList() { } // called once after all menu has been processed to allow object finalization function finalize() { } // called once after finalize() if the SM2_NOOUTPUT flag is used function getOutput() { }};

strona wydana na licencji GNU General Public License