meniuri Multiple

show_menu2, versiunea 4.9 x

Show_Menu2 este un fragment de cod pentru WebsiteBaker CMS. Deoarece WebsiteBaker 2.7 este inclus cu CMS.
fosta funcție show_menu este complet înlocuită și extinsă cu show_menu2. Toate datele necesare pentru a crea meniul este generat de o singură interogare bază de date. Prin posibilități extinse de ajustare a codului HTML generat toate tipurile de meniu posibile (liste, pesmet, sitemap-uri, etc.) pot fi generate.

• instalare
• folosind Show_Menu2
• Întrebări frecvente
• funcție
• ieșire HTML
• parametru
• Opțiuni avansate
• șiruri de Format
• formatare condiționată
• Formatter

installationup

deoarece show_menu2 este de obicei prezent în WebsiteBaker, nu este necesară instalarea. Dacă, contrar așteptărilor, nu există, îl puteți descărca aici.

utilizarea SHOW_MENU2up

pentru a utiliza show_menu2 trebuie să modificați șablonul în care doriți să apară meniul. Vă rugăm să rețineți: dacă apelurile de meniu vechi sunt înlocuite, trebuie folosiți și parametrii noi corespunzători de care are nevoie show_menu2.

în majoritatea cazurilor, apelul standard cu cel puțin 4 parametri ai show_menu2 este suficient. În acest caz sunt utilizate valorile implicite, aceasta creează un meniu care afișează pagina curentă și subpaginile paginii curente:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

vă rugăm să rețineți: apelul la show_menu2 este PHP și trebuie să fie în mod normal închise în caractere de cod PHP (cu excepția cazului în apelul este deja în interiorul cod PHP):

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

acest meniu implicit creează deja un meniu complet pe bază de listă cu mai multe clase care permit formatarea ușoară folosind CSS. De exemplu, clasa „meniu-curent” este adăugată la eticheta <li> a elementului de meniu curent. În plus, fiecare element de meniu al subitemelor conține clasa „meniu-extindere”. Acest lucru permite crearea unor reguli CSS foarte diferențiate pentru fiecare element de meniu.
de exemplu:

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

secțiunea” ieșire HTML ” conține o descriere detaliată a claselor care sunt atribuite elementului. Folosind diferiți parametri în apelul funcției show_menu2, este de asemenea posibil să creați structuri de meniu destul de extinse și diferite. De exemplu, pentru a afișa numai elementele de meniu de la nivelul superior al structurii meniului, puteți utiliza următorul apel:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

sau, de exemplu, pentru a afișa până la două subniveluri ale paginii curente:

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

există o mulțime de posibilități de a crea diferite structuri de meniu. Numeroase exemple pot fi găsite pe site-ul demo: KLICK

FAQup

Î: nu sunt programator. Nu există o documentație mai simplă?
A: Nu, pentru că aceasta este deja documentația simplă.

Î: Cum pot crea un meniu derulant?
A: Acest lucru nu are nimic de-a face cu show_menu2. Pentru a crea un meniu derulant, trebuie doar să ajustați codul CSS al șablonului respectiv. Ajustările necesare pot fi găsite, de exemplu, în șablonul „allcss2” din magazia Addon WebsiteBaker-> https://addon.websitebaker.org/

Î: De ce dispare meniul după ce am folosit funcția de căutare într-o pagină WebsiteBaker multilingvă?
A: liniile necesare lipsesc în șablonul utilizat:

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

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

Î: multilingv? Sună grozav. Cum o faci?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

Î: de fiecare dată când o pagină este apelată, SM2 generează următorul mesaj de avertizare:
„show_menu2 eroare: $aoptions este nevalid. Nu există steaguri din grupa 1 furnizate!”
A: Valorile greșite sau un număr greșit de valori au fost transmise funcției.
consultați secțiunea Parametri pentru ca valorile corecte ale steagului să treacă la parametrul $aoptions.

Î: Cum folosesc o clasă/imagine/culoare/widget diferită pentru fiecare intrare dintr-un meniu?
A: utilizați șirul de format din șirul $aitemopen. Creați o clasă sau un id unic pentru fiecare element de meniu, apoi faceți referire la acel element din CSS sau Javascript pentru a face orice doriți.
pentru a adăuga o clasă unică pentru fiecare element de meniu (sau similar):

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

… crearea elementelor de meniu cum ar fi …

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

referință acest lucru în CSS ca:

a.p45 { color: red; }

pentru a adăuga un ID unic pentru fiecare element de meniu (sau similar):

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

… crearea elementelor de meniu cum ar fi …

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

referință acest lucru în CSS ca:

a#p45 { color: red; }

rețineți că ID – ul poate fi utilizat numai dacă acel meniu este generat și afișat o singură dată pe pagină (deoarece ID-ul HTML trebuie să fie unic într-o pagină).

FUNCTIONup

apelul complet și valorile implicite ale parametrilor pentru show_menu2 sunt după cum urmează:

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

secțiunea „Parametri” conține o descriere detaliată a fiecărui parametru individual.
fiecare parametru trebuie utilizat absolut corect. Următoarele reguli vă pot ajuta:

$aMenu = 0 este cea mai bună valoare în majoritatea cazurilor.
$aStart trebuie să fie fie un ID de pagină, fie o valoare care începe cu „SM2_”.
$amaxlevel poate obține numai valori începând cu”SM2_”.
$ aOptions cu excepția câtorva cazuri speciale sunt permise numai valori care încep cu „SM2_”.
toți ceilalți parametri conțin etichetele (HTML)care controlează ieșirea meniului.
pornind de la $aitemopen fiecare parametru poate fi trecut valoarea false pentru a obține valoarea implicită respectivă.

aceasta poate fi utilizată, de exemplu, pentru a crea o listă numerotată, în timp ce valorile implicite sunt încă utilizate pentru elementele de meniu individuale:

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

vă rugăm să rețineți: până la și inclusiv $aOptions toți parametrii trebuie să fie transmise în mod explicit!

ieșire HTML

ieșirea HTML depinde în mare măsură de parametrii care sunt transmiși funcției. Indiferent de aceasta, clasele ulterioare sunt întotdeauna utilizate pentru fiecare meniu, prin care elementele de meniu individuale pot avea, de asemenea, mai multe clase, dacă este necesar.

exemplu de ieșire 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

parametrul $aoptions poate fi utilizat în două moduri. În primul rând, așa cum este descris mai sus în secțiunea Parametri, acest tip ar trebui să fie suficient pentru marea majoritate a cazurilor de utilizare. Cu toate acestea, pentru a putea aborda opțiunile speciale în cazuri speciale, valorile necesare trebuie furnizate ca o matrice asociativă.
vă rugăm să rețineți: steagurile SM2_ * sunt, de asemenea, necesare aici și trebuie transmise ca ‘steaguri’.

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

FORMAT STRINGSup

următoarele etichete pot fi utilizate în șirurile de format pentru $aitemopen și $aMenuOpen și ar trebui înlocuite cu textul corespunzător.

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

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

'<li class="">'

'<ul class="">'

următoarele etichete sunt disponibile numai dacă este setat steagul SM2_ALLINFO.

Formatare condiționată

instrucțiunea de formatare condiționată poate lua una dintre următoarele forme:

condiția este o combinație a uneia sau mai multor comparații booleene.
dacă este necesară mai mult de o comparație, aceasta trebuie combinată cu celelalte comparații
pot fi legate folosind || (boolean sau – sau) sau && (boolean și – și).

o singură comparație constă din operandul stâng, operatorul și operandul drept.
de ex.X == Y – unde X este operandul stâng, == operatorul și Y operandul drept.

dacă se adaugă o clauză else, aceasta va fi executată în toate celelalte cazuri.
de exemplu, ” foo ” este întotdeauna executat atunci când verificarea if este greșită, deci:

vă rugăm să rețineți:
toate verificările vor fi efectuate în ordinea în care sunt notate, deoarece:

• nu există nicio verificare pentru bucle posibile (toate verificările sunt întotdeauna executate).
• controalele nu sunt grupate (paranteze de controale nu sunt acceptate)
• ambele aceste lucruri au aceeași valoare.

FORMATTERup

atenție: aceasta este o caracteristică avansată și rar utilizată!

cu cunoștințe extinse în programarea PHP, este posibil să utilizați formatarea predefinită
a show_menu2 cu propria dvs.
În include.php de show_menu2 puteți vedea cum să scrie formatatorul.
API-ul care trebuie utilizat arată astfel:

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

site-ul Webbakereste lansat sub Licența Publică Generală GNU