Meerdere Menu’ s

show_menu2, versie 4.9 x

Show_Menu2 is een codefragment voor de CMS WebsiteBaker. Sinds WebsiteBaker 2.7 is het inbegrepen bij het CMS.
de voormalige show_menu functie is volledig vervangen en uitgebreid met show_menu2. Alle gegevens die nodig zijn om het menu aan te maken, worden gegenereerd door een enkele database query. Door uitgebreide aanpassingsmogelijkheden van de gegenereerde HTML-code alle mogelijke menu types (lijsten, paneermeel, sitemaps, enz.) kan worden gegenereerd.

• installatie
• Show_Menu2
• FAQ
• functie
• HTML-uitvoer
• Parameter
• geavanceerde opties
• Format Strings
• Conditionele opmaak
• Formatter

INSTALLATIONup

omdat show_menu2 gewoonlijk aanwezig is in WebsiteBaker, is geen installatie vereist. Als het, in tegenstelling tot de verwachtingen, niet bestaat, kunt u het hier downloaden.

SHOW_MENU2up

om show_menu2 te gebruiken moet u de sjabloon wijzigen waar u het menu wilt laten verschijnen. Let op: als oude menuaanroepen worden vervangen, moeten de overeenkomstige nieuwe parameters die show_menu2 nodig heeft ook worden gebruikt.

in de meeste gevallen is de standaard aanroep met ten minste 4 parameters van show_menu2 voldoende. In dit geval worden de standaardwaarden gebruikt, dit maakt een menu dat de huidige pagina en de subpagina ‘ s van de huidige pagina weergeeft:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

let op: de aanroep naar show_menu2 is PHP en moet normaal worden ingesloten in PHP code tekens (tenzij de aanroep al binnen PHP code):

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

dit standaardmenu maakt al een compleet menu aan op basis van een lijst met verschillende klassen die eenvoudige opmaak met behulp van CSS mogelijk maken. Bijvoorbeeld, de klasse “menu-current” wordt toegevoegd aan de <li> tag van het huidige menu-item. Bovendien bevat elk menu-item van de subitems de klasse “menu-expand”. Dit maakt het mogelijk om zeer gedifferentieerde CSS regels voor elk menu-item te maken.
bijvoorbeeld:

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

de sectie “HTML Output” bevat een gedetailleerde beschrijving van welke klassen worden toegewezen aan welk element. Door het gebruik van verschillende parameters in de show_menu2 functie aanroep, is het ook mogelijk om vrij uitgebreide en verschillende menustructuren te creëren. Als u bijvoorbeeld alleen menu-items van het hoogste niveau van de menustructuur wilt weergeven, kunt u de volgende aanroep gebruiken:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

of bijvoorbeeld om maximaal twee subniveaus van de huidige pagina weer te geven:

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

er zijn veel mogelijkheden om verschillende menustructuren te creëren. Talrijke voorbeelden zijn te vinden op de demo website: KLICK

FAQup

Q: Ik ben geen programmeur. Is er geen eenvoudigere documentatie?
A: Nee, want dit is al de eenvoudige documentatie.

V: Hoe kan ik een vervolgkeuzemenu aanmaken?
A: Dit heeft niets te maken met show_menu2. Om een drop-down menu te maken hoeft u alleen de CSS-code van de betreffende template aan te passen. De nodige aanpassingen zijn te vinden in bijvoorbeeld de” allcss2 ” template van de WebsiteBaker Addon Repository -> https://addon.websitebaker.org/

V: Waarom verdwijnt het menu nadat ik de zoekfunctie in een meertalige WebsiteBaker pagina heb gebruikt?
A: de benodigde regels ontbreken in het gebruikte sjabloon:

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

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

Q: meertalig? Dat klinkt geweldig. Hoe doe je het?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

Q: elke keer dat een pagina wordt aangeroepen, genereert SM2 het volgende waarschuwingsbericht:
” show_menu2 error: $aOptions is ongeldig. Geen vlaggen van groep 1 geleverd!”
A: De verkeerde waarden of een verkeerd aantal waarden werden doorgegeven aan de functie.
zie de sectie PARAMETERS voor de juiste flag waarden om door te geven aan de parameter $aOptions.

V: Hoe gebruik ik een andere klasse/afbeelding/kleur/widget voor elk item in een menu?
A: Gebruik de format string in de $ aItemOpen string. Maak een unieke klasse of id voor elk menu-item, dan verwijzen naar dat item in uw CSS of Javascript om te doen wat je wilt.
om een unieke klasse toe te voegen voor elk menu-item (of vergelijkbaar):

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

… het creëren van menu-items zoals …

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

refereer dit in uw CSS zoals:

a.p45 { color: red; }

een unieke ID toevoegen voor elk menu-item (of vergelijkbaar)):

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

… het creëren van menu-items zoals …

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

refereer dit in uw CSS zoals:

a#p45 { color: red; }

merk op dat de ID alleen kan worden gebruikt als dat menu wordt gegenereerd en slechts één keer op de pagina wordt weergegeven (omdat HTML ID ‘ s uniek moeten zijn binnen een pagina).

FUNCTIONup

de volledige aanroep en de standaard parameterwaarden voor show_menu2 zijn als volgt:

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

het gedeelte “Parameters” bevat een gedetailleerde beschrijving van elke afzonderlijke parameter.
elke parameter moet absoluut correct worden gebruikt. De volgende regels kunnen helpen:

$aMenu = 0 is de beste waarde in de meeste gevallen.
$aStart moet een pagina-ID zijn of een waarde die begint met”SM2_”.
$aMaxLevel kan alleen waarden krijgen die beginnen met”SM2_”.
$aoptions behalve een paar speciale gevallen zijn alleen waarden die beginnen met” SM2_ ” toegestaan.
alle andere parameters bevatten de (HTML)tags die de uitvoer van het menu bepalen.
vanaf $aItemOpen kan elke parameter de waarde false worden doorgegeven om de respectievelijke standaardwaarde te krijgen.

dit kan bijvoorbeeld worden gebruikt om een genummerde lijst aan te maken, terwijl de standaardwaarden nog steeds worden gebruikt voor de afzonderlijke menu-items:

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

let op: tot en met $aOptions moeten alle parameters expliciet worden doorgegeven!

HTML-uitvoer

de HTML-uitvoer hangt grotendeels af van welke parameters aan de functie worden doorgegeven. Ongeacht dit, worden de volgende klassen altijd gebruikt voor elk menu, waarbij individuele menu-items kunnen ook meerdere klassen indien nodig.

voorbeeld van HTML-uitvoer:

<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

$Aopties

 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

de parameter $aoptions kan op twee manieren worden gebruikt. Ten eerste, zoals hierboven beschreven in de sectie PARAMETERS, moet dit type voldoende zijn voor de overgrote meerderheid van de use cases. Om de speciale opties in speciale gevallen te kunnen aanpakken, moeten de vereiste waarden echter als een associatieve array worden opgegeven.
let op: de sm2_ * vlaggen zijn hier ook verplicht en moeten worden doorgegeven als ‘vlaggen’.

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

FORMAT STRINGSup

de volgende tags kunnen worden gebruikt in de format strings voor $aItemOpen en $aMenuOpen en moeten worden vervangen door de bijbehorende tekst.

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

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

'<li class="">'

'<ul class="">'

de volgende tags zijn alleen beschikbaar als de sm2_allinfo vlag is ingesteld.

Voorwaardelijke opmaak up

het statement voorwaardelijke opmaak kan een van de volgende vormen aannemen:

de voorwaarde is een combinatie van een of meer Booleaanse vergelijkingen.
indien meer dan één vergelijking vereist is, moet deze worden gecombineerd met de andere vergelijkingen
kan worden gekoppeld met behulp van || (boolean of – OF) of && (boolean en – en).

een enkele vergelijking bestaat uit de linker operand, de operator en de rechter operand.
bijvoorbeeld X = = Y-waarbij X de linker operand is, == de operator en Y de rechter operand.

als er een else-clausule wordt toegevoegd, zal deze in alle andere gevallen worden uitgevoerd.
bijvoorbeeld, “foo” wordt altijd uitgevoerd als de if-check verkeerd is, dus:

let op:
Alle controles zullen worden uitgevoerd in de volgorde waarin ze worden vermeld, omdat:

• er is geen controle op mogelijke lussen (alle controles worden altijd uitgevoerd).
• controles zijn niet gegroepeerd (haakjes van controles worden niet ondersteund)
• beide dingen hebben dezelfde waarde.

FORMATTERup

let op: dit is een geavanceerde en zelden gebruikte functie!

met uitgebreide kennis van PHP programmeren is het mogelijk om de voorgedefinieerde
opmaak van show_menu2 te gebruiken met je eigen.
In de include.php van show_menu2 je kunt zien hoe je de formatter schrijft.
de API die gebruikt moet worden ziet er als volgt uit:

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 vrijgegeven onder de GNU General Public License