flere menuer

vis_menu2, version 4.9

Vis_menu2 er et kodestykke til CMS Hjemmesidebaker. Siden Hjemmesidebaker 2.7 det er inkluderet i CMS.
den tidligere vis_menu funktion er helt erstattet og udvidet med vis_menu2. Alle data, der kræves for at oprette menuen, genereres af en enkelt databaseforespørgsel. Ved omfattende justeringsmuligheder for den genererede HTML-kode alle mulige menutyper (lister, brødkrummer, sitemaps osv.) kan genereres .

• Installation
• brug af Visning_menu2
• Ofte stillede spørgsmål
• funktion
• HTML-udgang
• Parameter
• Avancerede indstillinger
• Formatstrenge
• betinget formatering
• Formatter

installationup

da visning2 normalt findes på hjemmesidebaker, kræves der ingen installation. Hvis det i modsætning til forventningerne ikke eksisterer, kan du hente det her.

brug af Vis_menu2up

for at bruge vis_menu2 skal du ændre skabelonen, hvor menuen skal vises. Bemærk: Hvis gamle menuopkald udskiftes, skal de tilsvarende nye parametre, som vis_menu2 har brug for, også bruges.

i de fleste tilfælde er standardopkaldet med mindst 4 parametre for visning2 tilstrækkeligt. I dette tilfælde bruges standardværdierne, dette opretter en menu, der viser den aktuelle side og undersiderne på den aktuelle side:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

Bemærk: opkaldet til vis_menu2 er PHP og skal normalt vedlægges PHP-kodetegn (medmindre opkaldet allerede er inde i PHP-kode):

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

denne standardmenu opretter allerede en komplet menu på listebasis med flere klasser, der tillader nem formatering ved hjælp af CSS. For eksempel tilføjes klassen “menu-current” til <li> tagget af det aktuelle menupunkt. Derudover indeholder hvert menupunkt i underemnerne klassen”menu-Udvid”. Dette gør det muligt at oprette meget differentierede CSS-regler for hvert menupunkt.
for eksempel:

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

afsnittet” HTML Output ” indeholder en detaljeret beskrivelse af hvilke klasser der er tildelt hvilket element. Ved at bruge forskellige parametre i funktionsopkaldet vis_menu2 er det også muligt at oprette ganske omfattende og forskellige menustrukturer. Hvis du f. eks. kun vil vise menupunkter fra det øverste niveau i menustrukturen, kan du bruge følgende opkald:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

eller for eksempel at vise op til to underniveauer på den aktuelle side:

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

der er mange muligheder for at oprette forskellige menustrukturer. Talrige eksempler kan findes på demo hjemmeside: KLICK

Fakp

spørgsmål: Jeg er ikke en programmør. Er der ingen enklere dokumentation?
A: Nej, fordi dette allerede er den enkle dokumentation.

spørgsmål: Hvordan kan jeg oprette en rullemenu?
A: Dette har intet at gøre med visning2. For at oprette en rullemenu skal du kun justere CSS-koden for den respektive skabelon. De nødvendige justeringer findes f. eks. i skabelonen” allcss2 ” fra Hjemmesidebaker Addon Repository -> https://addon.websitebaker.org/

Sp: Hvorfor forsvinder menuen, efter at jeg har brugt søgefunktionen på en flersproget Hjemmesidebaker-side?
A: de nødvendige linjer mangler i den anvendte skabelon:

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

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

spørgsmål: flersproget? Det lyder godt. Hvordan gør du det?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

Sp: hver gang en side kaldes, genererer SM2 følgende advarselsmeddelelse:
“vis_menu2-fejl: $aOptions er ugyldig. Ingen flag fra gruppe 1 leveres!”
A: De forkerte værdier eller et forkert antal værdier blev overført til funktionen.
se afsnittet Parametre for de korrekte flagværdier, der skal overføres til parameteren $aOptions.

spørgsmål: Hvordan bruger jeg en anden klasse/billede/farve/kontrol for hver post i en menu?
A: brug formatstrengen i $aitemopen-strengen. Opret en unik klasse eller id for hvert menupunkt, og henvis derefter det element i din CSS eller Javascript for at gøre hvad du vil.
for at tilføje en unik klasse for hvert menupunkt (eller lignende):

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

… oprettelse menupunkter Som …

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

henvis dette i din CSS som:

a.p45 { color: red; }

for at tilføje et unikt ID for hvert menupunkt (eller lignende):

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

… oprettelse menupunkter Som …

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

henvis dette i din CSS som:

a#p45 { color: red; }

Bemærk, at ID ‘et kun kan bruges, hvis denne menu kun genereres og vises en gang på siden (fordi HTML-ID’ er skal være unikke på en side).

FUNCTIONup

det komplette opkald og standardparameterværdierne for visning2 er som følger:

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

afsnittet “Parametre” indeholder en detaljeret beskrivelse af hver enkelt parameter.
hver parameter skal bruges helt korrekt. Følgende regler kan hjælpe:

$amenu = 0 er den bedste værdi i de fleste tilfælde.
$aStart skal enten være et side-ID eller en værdi, der starter med “SM2_”.
$amakslevel kan kun få værdier, der starter med “SM2_”.
$aOptions bortset fra nogle få særlige tilfælde er kun værdier, der begynder med “SM2_”, tilladt.
alle andre parametre indeholder de (HTML)tags, der styrer udgangen af menuen.
startende fra $aItemOpen hver parameter kan overføres værdien falsk for at få den respektive standardværdi.

dette kan f. eks. bruges til at oprette en nummereret liste, mens standardværdierne stadig bruges til de enkelte menupunkter:

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

Bemærk: op til og med $aOptions alle parametre skal bestås eksplicit!

HTML Outputup

HTML-output afhænger stort set af, hvilke parametre der sendes til funktionen. Uanset dette bruges efterfølgende klasser altid til hver menu, hvor individuelle menupunkter også kan have flere klasser, hvis det er nødvendigt.

eksempel på HTML-output:

<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

$amaksniveau

$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

$atopmenuåben

ADVANCED OPTIONSup

parameteren $aoptions kan bruges på to måder. For det første, som beskrevet ovenfor i parameterafsnittet, bør denne type være tilstrækkelig til langt de fleste brugssager. For at kunne adressere de særlige muligheder i særlige tilfælde skal de krævede værdier dog leveres som et associativt array.
Bemærk venligst: SM2_* – flagene er også påkrævet her og skal sendes som ‘flag’.

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

FORMAT STRINGSup

følgende tags kan bruges i formatstrengene for $aitemopen og $amenuopen og bør erstattes af den tilsvarende tekst.

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

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

'<li class="">'

'<ul class="">'

følgende tags er kun tilgængelige, hvis sm2_allinfo-flaget er indstillet.

Betinget formatering op

erklæringen betinget formatering kan antage en af følgende former:

betingelsen er en kombination af en eller flere boolske sammenligninger.
hvis der kræves mere end en sammenligning, skal den kombineres med de andre sammenligninger
kan knyttes ved hjælp af || (boolsk eller – eller) eller && (boolsk og – og).

en enkelt sammenligning består af den venstre operand, operatøren og den højre operand.
f. eks.

hvis der tilføjes en anden klausul, udføres den i alle andre tilfælde.
for eksempel udføres “foo” altid, når hvis kontrollen er forkert, så:

Bemærk:
alle kontroller udføres i den rækkefølge, de er noteret, fordi:

• der er ingen kontrol for mulige sløjfer (alle kontroller udføres altid).
• Checks er ikke grupperet (parenteser af checks understøttes ikke)
• begge disse ting har samme værdi.

FORMATTERup

OBS: Dette er en avanceret og sjældent brugt funktion!

med omfattende viden i PHP programmering er det muligt at bruge den foruddefinerede
formatering af visning2 med din egen.
i den omfatter.php af vis_menu2 du kan se, hvordan du skriver formateren.
API ‘ en, der skal bruges, ser sådan ud:

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

Hjemmesidebakeris udgivet under GNU General Public License