více nabídek

show_menu2, verze 4.9 x

Show_Menu2 je úryvek kódu pro CMS WebsiteBaker. Vzhledem k tomu, WebsiteBaker 2.7 je součástí CMS.
původní funkce show_menu je zcela nahrazena a rozšířena o show_menu2. Všechna data potřebná k vytvoření nabídky jsou generována jediným databázovým dotazem. Rozsáhlými možnostmi nastavení vygenerovaného HTML kódu jsou všechny možné typy nabídek (seznamy, strouhanka, sitemapy atd.) mohou být generovány.

• instalace
• pomocí Show_Menu2
• FAQ
• funkce
• HTML výstup
• parametr
• Pokročilé možnosti
• format Strings
• Podmíněné formátování
• Formatter

INSTALLATIONup

vzhledem k tomu, show_menu2 je obvykle přítomen v Websitebaker, není nutná žádná instalace. Pokud na rozdíl od očekávání neexistuje, můžete si ji stáhnout zde.

použití SHOW_MENU2up

Chcete-li použít show_menu2, musíte upravit šablonu, kde chcete zobrazit nabídku. Upozornění: pokud jsou nahrazeny staré volání menu, musí být také použity odpovídající nové parametry, které show_menu2 potřebuje.

ve většině případů postačuje standardní volání s alespoň 4 parametry show_menu2. V tomto případě se použijí výchozí hodnoty, čímž se vytvoří nabídka, která zobrazí aktuální stránku a podstránky aktuální stránky:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

upozornění: volání do show_menu2 je PHP a musí být normálně uzavřeno znaky PHP kódu (pokud hovor není již uvnitř PHP kódu):

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

toto výchozí menu již vytváří kompletní nabídku na základě seznamu s několika třídami, které umožňují snadné formátování pomocí CSS. Například třída „menu-current“ je přidána ke značce <li> aktuální položky nabídky. Navíc každá položka nabídky podpoložek obsahuje třídu „menu-expand“. To umožňuje vytvořit velmi diferencovaná pravidla CSS pro každou položku nabídky.
například:

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

část „výstup HTML“ obsahuje podrobný popis, které třídy jsou přiřazeny ke kterému prvku. Použitím různých parametrů ve volání funkce show_menu2 je také možné vytvořit poměrně rozsáhlé a odlišné struktury nabídek. Chcete-li například zobrazit pouze položky nabídky z nejvyšší úrovně struktury nabídky, můžete použít následující volání:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

nebo například zobrazit až dvě podúrovně aktuální stránky:

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

existuje mnoho možností, jak vytvořit různé struktury nabídek. Mnoho příkladů lze nalézt na demo webových stránkách: KLICK

FAQup

Q: nejsem programátor. Neexistuje jednodušší dokumentace?
v: Ne, protože toto je již jednoduchá dokumentace.

otázka: Jak mohu vytvořit rozbalovací nabídku?
A: to nemá nic společného s show_menu2. Chcete-li vytvořit rozbalovací nabídku, stačí upravit kód CSS příslušné šablony. Potřebné úpravy lze nalézt např. v šabloně „allcss2“ z úložiště doplňků WebsiteBaker-> https://addon.websitebaker.org/

otázka: Proč menu zmizí poté, co jsem použil vyhledávací funkci na vícejazyčné stránce WebsiteBaker?
A: v použité šabloně chybí potřebné řádky:

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

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

otázka: vícejazyčný? To zní skvěle. Jak to děláš?
v: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

Q: pokaždé, když je stránka vyvolána, SM2 vygeneruje následující varovnou zprávu:
“ show_menu2 error: $aoptions je neplatná. Žádné vlajky ze skupiny 1 dodáváno!“
A: Chybné hodnoty nebo nesprávný počet hodnot byly předány funkci.
v části Parametry najdete správné hodnoty příznaku, které mají být předány parametru $aoptions.

otázka: Jak mohu použít jinou třídu / obrázek/barvu / widget pro každou položku v nabídce?
A: použijte řetězec formátu v řetězci $aitemopen. Vytvořte jedinečnou třídu nebo id pro každou položku nabídky a poté odkazujte na tuto položku v CSS nebo JavaScriptu a dělejte, co chcete.
přidání jedinečné třídy pro každou položku nabídky (nebo podobnou):

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

… vytváření položek nabídky jako …

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

odkazujte na to ve vašem CSS jako:

a.p45 { color: red; }

přidání jedinečného ID pro každou položku nabídky (nebo podobně):

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

… vytváření položek nabídky jako …

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

odkazujte na to ve vašem CSS jako:

a#p45 { color: red; }

Všimněte si, že ID lze použít pouze v případě, že je tato nabídka vygenerována a zobrazena pouze jednou na stránce (protože ID HTML musí být na stránce jedinečné).

FUNCTIONup

úplné volání a výchozí hodnoty parametrů pro show_menu2 jsou následující:

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

sekce „parametry“ obsahuje podrobný popis každého jednotlivého parametru.
každý parametr musí být použit naprosto správně. Následující pravidla mohou pomoci:

$aMenu = 0 je ve většině případů nejlepší hodnota.
$aStart musí být buď ID stránky nebo hodnota začínající na „SM2_“.
$aMaxLevel může získat pouze hodnoty začínající na „SM2_“.
$aOptions kromě několika zvláštních případů jsou povoleny pouze hodnoty začínající na „SM2_“.
všechny ostatní parametry obsahují značky (HTML), které řídí výstup nabídky.
počínaje $aitemopen každý parametr může být předán hodnotu false získat příslušnou výchozí hodnotu.

to lze použít například k vytvoření číslovaného seznamu, zatímco výchozí hodnoty se stále používají pro jednotlivé položky nabídky:

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

upozornění: až do a včetně $aOptions musí být všechny parametry předány explicitně!

výstup HTML

výstup HTML do značné míry závisí na tom, které parametry jsou předány funkci. Bez ohledu na to se pro každé menu vždy používají následující třídy, přičemž jednotlivé položky nabídky mohou mít v případě potřeby také několik tříd.

příklad výstupu 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

page_id

$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

parametr $aoptions lze použít dvěma způsoby. Za prvé, jak je popsáno výše v části Parametry, tento typ by měl stačit pro převážnou většinu případů použití. Aby však bylo možné ve zvláštních případech řešit speciální opce, musí být požadované hodnoty poskytnuty jako asociativní pole.
upozornění: SM2_ * vlajky jsou také nutné a musí být předány jako ‚vlajky‘.

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

formát STRINGSup

následující značky lze použít ve formátu strings pro $aitemopen a $aMenuOpen a měly by být nahrazeny odpovídajícím textem.

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

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

'<li class="">'

'<ul class="">'

následující značky jsou k dispozici pouze v případě, že je nastaven příznak SM2_ALLINFO.

Podmíněné formátování

příkaz podmíněné formátování může mít jednu z následujících forem:

podmínka je kombinací jednoho nebo více booleovských srovnání.
pokud je vyžadováno více než jedno srovnání, musí být kombinováno s ostatními srovnáními
lze propojit pomocí || (boolean or – OR) nebo && (boolean and-AND).

jediné srovnání se skládá z levého operandu, operátoru a pravého operandu.
např. X = = Y-kde X je levý operand, = = operátor a Y pravý operand.

pokud je přidána klauzule else, bude provedena ve všech ostatních případech.
například „foo“ se provádí vždy, když je kontrola if Chybná, takže:

upozornění:
všechny kontroly budou provedeny v pořadí, v jakém jsou zaznamenány, protože:

• neexistuje žádná kontrola možných smyček (všechny kontroly jsou vždy prováděny).
• kontroly nejsou seskupeny (závorky kontrol nejsou podporovány)
• obě tyto věci mají stejnou hodnotu.

FORMATTERup

pozor: toto je pokročilá a zřídka používaná funkce!

s rozsáhlými znalostmi v PHP programování je možné použít předdefinované
formátování show_menu2 s vlastní.
v zahrnutí.php show_menu2 můžete vidět, jak psát formátovač.
API, které musí být použito, vypadá takto:

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 propuštěn pod GNU General Public License