több menük

show_menu2, version 4.9 x

Show_Menu2 egy kódrészlet a CMS WebsiteBaker. A WebsiteBaker 2.7 óta a CMS tartalmazza.
a korábbi show_menu függvényt teljesen lecseréljük és kiterjesztjük a show_menu2-re. A menü létrehozásához szükséges összes adatot egyetlen adatbázis-lekérdezés generálja. A generált HTML kód kiterjedt beállítási lehetőségeivel minden lehetséges menütípus (listák, zsemlemorzsa, webhelytérképek stb.) lehet generálni.

• telepítés
• használata Show_Menu2
• GYIK
• funkció
• HTML kimenet
• paraméter
• Speciális beállítások
• formátum Strings
• feltételes formázás
• formázó

installationup

mivel a show_menu2 általában jelen van a websitebakerben, nincs szükség telepítésre. Ha a várakozásokkal ellentétben nem létezik, itt letöltheti.

a SHOW_MENU2up használata

a show_menu2 használatához módosítani kell a sablont, ahol a menü megjelenik. Kérjük, vegye figyelembe: ha a régi menühívásokat kicseréli, akkor a show_menu2 megfelelő új paramétereit is használni kell.

a legtöbb esetben a standard hívás legalább 4 paramétere show_menu2 elegendő. Ebben az esetben az alapértelmezett értékeket használja, ez létrehoz egy menüt, amely megjeleníti az aktuális oldalt és az aktuális oldal aloldalait:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

kérjük, vegye figyelembe: a show_menu2 hívása PHP, és általában PHP kód karakterekkel kell ellátni (kivéve, ha a hívás már PHP kódban van):

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

ez az alapértelmezett menü már létrehoz egy teljes menüt a lista alapján több osztály, amely lehetővé teszi a könnyű formázás CSS. Például a “menu-current” osztály hozzáadódik az aktuális menüpont <li> címkéjéhez. Ezenkívül az alelemek minden menüpontja tartalmazza a “menu-expand”osztályt. Ez lehetővé teszi, hogy nagyon differenciált CSS szabályokat hozzon létre minden menüponthoz.
például:

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

a “HTML kimenet” szakasz részletes leírást tartalmaz arról, hogy mely osztályok vannak hozzárendelve az elemhez. A show_menu2 függvényhívás különböző paramétereinek felhasználásával meglehetősen kiterjedt és különböző menüstruktúrák is létrehozhatók. Ha például csak a menüszerkezet legfelső szintjén lévő menüelemeket szeretné megjeleníteni, használhatja a következő hívást:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

vagy például az aktuális oldal legfeljebb két alszintjének megjelenítéséhez:

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

nagyon sok lehetőség van különböző menüstruktúrák létrehozására. Számos példa található a demo weboldalon: KLICK

FAQup

k: nem vagyok programozó. Nincs egyszerűbb dokumentáció?
A: Nem, mert ez már az egyszerű dokumentáció.

K: Hogyan hozhatok létre legördülő menüt?
A: ennek semmi köze a show_menu2-hez. A legördülő menü létrehozásához csak a megfelelő sablon CSS-kódját kell módosítania. A szükséges beállítások megtalálhatók például a WebsiteBaker Addon Repository” allcss2 ” sablonjában-> https://addon.websitebaker.org/

K: Miért tűnik el a menü, Miután többnyelvű WebsiteBaker oldalon használtam a keresési funkciót?
A: a szükséges sorok hiányoznak a használt sablonból:

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

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

K: többnyelvű? Ez remekül hangzik. Hogy csinálod?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

k: minden egyes oldal meghívásakor az SM2 a következő figyelmeztető üzenetet generálja:
” show_menu2 hiba: a $aOptions érvénytelen. Nincs zászló a csoportból 1 szállítva!”
A: Rossz értékeket vagy rossz számú értéket adtak át a függvénynek.
lásd a paraméterek részben a megfelelő flag értékeket, hogy adja át a $aOptions paraméter.

k: hogyan használhatok egy másik osztályt/képet/színt/widgetet a menü minden egyes bejegyzéséhez?
V: használja a formátum karakterláncot a $aItemOpen karakterláncban. Hozzon létre egy egyedi osztályt vagy azonosítót minden menüponthoz, majd hivatkozzon erre az elemre a CSS-ben vagy a JavaScriptben, hogy bármit megtegyen.
egyedi osztály hozzáadása minden menüponthoz (vagy hasonlóhoz):

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

… létrehozása menüpontok, mint …

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

hivatkozzon erre a CSS-ben:

a.p45 { color: red; }

egyedi azonosító hozzáadása minden menüponthoz (vagy hasonlóhoz):

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

… létrehozása menüpontok, mint …

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

hivatkozzon erre a CSS-ben:

a#p45 { color: red; }

ne feledje, hogy az azonosító csak akkor használható, ha a menü csak egyszer jelenik meg az oldalon (mivel a HTML-azonosítóknak egyedinek kell lenniük az Oldalon belül).

FUNCTIONup

a teljes hívás és a show_menu2 alapértelmezett paraméterértékei a következők:

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);

a “paraméterek” szakasz minden egyes paraméter részletes leírását tartalmazza.
minden paramétert teljesen helyesen kell használni. A következő szabályok segíthetnek:

$aMenu = 0 a legtöbb esetben a legjobb érték.
$aStart oldalazonosítónak vagy “SM2_” – vel kezdődő értéknek kell lennie.
$aMaxLevel csak akkor kap értékeket kezdődő “SM2_”.
$aOptions néhány speciális eset kivételével csak az “SM2_” – vel kezdődő értékek engedélyezettek.
az összes többi paraméter tartalmazza a (HTML)címkéket, amelyek a menü kimenetét vezérlik.
$ aItemOpen – től kezdődően minden paraméter átadható a false értéknek, hogy megkapja a megfelelő alapértelmezett értéket.

ez felhasználható például számozott lista létrehozására, miközben az egyes menüelemeknél az alapértelmezett értékek továbbra is használatosak:

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

kérjük, vegye figyelembe: a $aOptions-ig minden paramétert kifejezetten át kell adni!

HTML Outputup

a HTML kimenet nagyban függ attól, hogy mely paraméterek kerülnek átadásra a függvénynek. Ettől függetlenül minden menühöz mindig a következő osztályokat használják, így az egyes menüelemeknek szükség esetén több osztálya is lehet.

példa HTML kimenetre:

<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

a $aoptions paraméter kétféleképpen használható. Először is, amint azt a paraméterek részben fentebb leírtuk, ennek a típusnak elegendőnek kell lennie a használati esetek túlnyomó többségéhez. Ahhoz azonban, hogy speciális esetekben a speciális opciókat kezelni lehessen, a szükséges értékeket asszociatív tömbként kell megadni.
kérjük, vegye figyelembe: az SM2_ * zászlók itt is kötelezőek, és ‘zászlóként’kell átadni őket.

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

FORMAT STRINGSup

a következő címkék használhatók a $aitemopen és $aMenuOpen formátumú karakterláncokban, és azokat a megfelelő szöveggel kell helyettesíteni.

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

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

'<li class="">'

'<ul class="">'

a következő címkék csak akkor érhetők el, ha az SM2_ALLINFO jelző be van állítva.

Feltételes formázás up

a feltételes formázási utasítás a következő formák egyikét öltheti:

a feltétel egy vagy több logikai összehasonlítás kombinációja.
ha egynél több összehasonlításra van szükség, akkor össze kell kapcsolni a többi összehasonlítással
összekapcsolható a || (logikai VAGY – VAGY) VAGY && (logikai ÉS – és) használatával.

egyetlen összehasonlítás a bal operandusból, az operátorból és a jobb operandusból áll.
pl. X = = Y-ahol X a bal operandus, = = az operátor és Y A jobb operandus.

ha egy else záradékot adunk hozzá, akkor minden más esetben végrehajtásra kerül.
például a” foo ” mindig végrehajtásra kerül, ha az IF ellenőrzés helytelen, így:

kérjük, vegye figyelembe:
minden ellenőrzést a feljegyzés sorrendjében hajtanak végre, mert:

• nincs ellenőrzés a lehetséges hurkokra (minden ellenőrzés mindig végrehajtásra kerül).
• az ellenőrzések nincsenek csoportosítva (az ellenőrzések zárójelei nem támogatottak)
• mindkét elem értéke azonos.

Formaterup

Figyelem: Ez egy fejlett és ritkán használt funkció!

a PHP programozás széles körű ismereteivel lehetőség van a show_menu2 előre definiált
formázásának használatára a sajátjával.
az include.php a show_menu2 láthatjuk, hogyan kell írni a formázó.
a használni kívánt API így néz ki:

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() { }};

WebsiteBakeris megjelent a GNU General Public License