flera menyer

show_menu2, version 4.9 x

Show_Menu2 är ett kodavsnitt för CMS WebsiteBaker. Sedan WebsiteBaker 2.7 det ingår i CMS.
den tidigare show_menu-funktionen ersätts helt och utökas med show_menu2. Alla data som krävs för att skapa menyn genereras av en enda databasfråga. Genom omfattande justeringsmöjligheter för den genererade HTML-koden alla möjliga menytyper (listor, ströbröd, webbplatskartor, etc.) kan genereras.

• Installation
• använda Show_Menu2
• FAQ
• funktion
• HTML-utmatning
• Parameter
• Avancerade alternativ
• formatsträngar
• villkorlig formatering
• Formaterare

installationup

eftersom show_menu2 vanligtvis finns i WebsiteBaker krävs ingen installation. Om det, i motsats till förväntningarna, inte existerar, kan du ladda ner det här.

använda SHOW_MENU2up

för att använda show_menu2 måste du ändra mallen där du vill att menyn ska visas. Observera: om gamla menysamtal ersätts måste motsvarande nya parametrar som show_menu2 behöver också användas.

i de flesta fall är standardsamtalet med minst 4 parametrar för show_menu2 tillräckligt. I det här fallet används standardvärdena, detta skapar en meny som visar den aktuella sidan och undersidorna på den aktuella sidan:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

observera: samtalet till show_menu2 är PHP och måste normalt bifogas PHP – kodtecken (såvida inte samtalet redan finns i PHP-kod):

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

den här standardmenyn skapar redan en komplett meny på listbasis med flera klasser som möjliggör enkel formatering med CSS. Till exempel läggs klassen ”meny-aktuell” till taggen <li> för det aktuella menyalternativet. Dessutom innehåller varje menyalternativ i underobjekten klassen ”meny-expandera”. Detta gör det möjligt att skapa mycket differentierade CSS-regler för varje menyalternativ.
till exempel:

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

avsnittet” HTML-utgång ” innehåller en detaljerad beskrivning av vilka klasser som tilldelas vilket element. Genom att använda olika parametrar i show_menu2 – funktionsanropet är det också möjligt att skapa ganska omfattande och olika menystrukturer. Om du till exempel bara vill visa menyalternativ från den översta nivån i menystrukturen kan du använda följande samtal:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

eller, till exempel, för att visa upp till två undernivåer på den aktuella sidan:

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

det finns många möjligheter att skapa olika menystrukturer. Många exempel finns på demowebbplatsen: klicka

FAQup

F: Jag är inte en programmerare. Finns det ingen enklare dokumentation?
A: Nej, för det här är redan den enkla dokumentationen.

F: Hur kan jag skapa en rullgardinsmeny?
A: Detta har inget att göra med show_menu2. För att skapa en rullgardinsmeny behöver du bara justera CSS-koden för respektive Mall. De nödvändiga justeringarna finns t. ex. i mallen ”allcss2” från WebsiteBaker Addon Repository -> https://addon.websitebaker.org/

f: varför försvinner menyn efter att jag har använt sökfunktionen på en flerspråkig WebsiteBaker-sida?
A: de nödvändiga raderna saknas i mallen som används:

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

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

f: flerspråkig? Det låter bra. Hur gör du det?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

F: varje gång en sida anropas genererar SM2 följande varningsmeddelande:
”show_menu2-fel: $aOptions är ogiltigt. Inga flaggor från grupp 1 levereras!”
A: Fel värden eller fel antal värden skickades till funktionen.
se avsnittet Parametrar för de korrekta flaggvärdena som ska överföras till parametern $aOptions.

F: Hur använder jag en annan klass/bild/färg/widget för varje post i en meny?
A: använd formatsträngen i $aItemOpen-strängen. Skapa en unik klass eller id för varje menyalternativ och referera sedan till det objektet i din CSS eller Javascript för att göra vad du vill.
för att lägga till en unik klass för varje menyalternativ (eller liknande):

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

… skapa menyalternativ som …

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

referera till detta i din CSS som:

a.p45 { color: red; }

för att lägga till ett unikt ID för varje menyalternativ (eller liknande):

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

… skapa menyalternativ som …

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

referera till detta i din CSS som:

a#p45 { color: red; }

Observera att ID endast kan användas om den menyn genereras och visas en gång bara på sidan (eftersom HTML-ID måste vara unikt på en sida).

FUNCTIONup

det fullständiga samtalet och standardparametervärdena för show_menu2 är följande:

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

avsnittet ”Parametrar” innehåller en detaljerad beskrivning av varje enskild parameter.
varje parameter måste användas helt korrekt. Följande regler kan hjälpa till:

$aMenu = 0 är det bästa värdet i de flesta fall.
$aStart måste vara antingen ett sid-ID eller ett värde som börjar med ”SM2_”.
$aMaxLevel kan bara få värden som börjar med ”SM2_”.
$aOptions förutom några speciella fall är endast värden som börjar med ”SM2_” tillåtna.
alla andra parametrar innehåller (HTML)taggar som styr utdata från menyn.
från $aItemOpen kan varje parameter skickas värdet falskt för att få respektive standardvärde.

detta kan till exempel användas för att skapa en numrerad lista, medan standardvärdena fortfarande används för de enskilda menyalternativen:

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

Observera: upp till och med $aOptions alla parametrar måste skickas explicit!

HTML-utmatning

HTML-utmatningen beror till stor del på vilka parametrar som skickas till funktionen. Oavsett detta används efterföljande klasser alltid för varje meny, varvid enskilda menyalternativ också kan ha flera klasser om det behövs.

exempel på HTML-utdata:

<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

parametern $aoptions kan användas på två sätt. För det första, som beskrivits ovan i avsnittet Parametrar, bör denna typ vara tillräcklig för de allra flesta användningsfall. För att kunna adressera specialalternativen i speciella fall måste de nödvändiga värdena anges som en associativ array.
Observera: sm2_* – flaggorna krävs också här och måste skickas som ’flaggor’.

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

FORMAT STRINGSup

följande taggar kan användas i formatsträngarna för $aItemOpen och $aMenuOpen och bör ersättas med motsvarande text.

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

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

'<li class="">'

'<ul class="">'

följande taggar är endast tillgängliga om flaggan SM2_ALLINFO är inställd.

Villkorsstyrd formatering upp

villkorsstyrd formatering kan ha ett av följande formulär:

villkoret är en kombination av en eller flera booleska jämförelser.
om mer än en jämförelse krävs måste den kombineras med de andra jämförelserna
kan länkas med || (boolean or – OR) eller && (boolean and – AND).

en enda jämförelse består av vänster operand, operatören och höger operand.
t.ex. X == Y – där X är den vänstra operanden, == operatören och Y den högra operanden.

om en else-klausul läggs till kommer den att utföras i alla andra fall.
till exempel körs ”foo” alltid när if-kontrollen är fel, så:

Observera:
alla kontroller kommer att utföras i den ordning de noteras, eftersom:

• det finns ingen kontroll för möjliga slingor (alla kontroller utförs alltid).
• kontroller är inte grupperade (parenteser av kontroller stöds inte)
• båda dessa saker har samma värde.

FORMATTERup

Obs: Detta är en avancerad och sällan använd funktion!

med omfattande kunskaper i PHP-programmering är det möjligt att använda den fördefinierade
formatering av show_menu2 med din egen.
i inkludera.php av show_menu2 du kan se hur man skriver formateraren.
API: et som måste användas ser ut så här:

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 släppt under GNU General Public License