vários Menus

show_menu2, versão 4.9 x

Show_Menu2 é um trecho de código para o CMS WebsiteBaker. Desde WebsiteBaker 2.7 ele está incluído com o CMS.
a antiga função show_menu é completamente substituída e estendida por show_menu2. Todos os dados necessários para criar o menu são gerados por uma única consulta de banco de dados. Por amplas possibilidades de ajuste do código HTML gerado todos os tipos de menu possíveis (listas, breadcrumbs, sitemaps, etc.) pode ser gerado.

• Instalação
• Usando Show_Menu2
• FAQ
• Função
• Saída HTML
• Parâmetro
• Opções Avançadas
• Cadeias de caracteres de Formato
• Formatação Condicional
• Formatador

INSTALLATIONup

Desde show_menu2 geralmente está presente em WebsiteBaker, nenhuma instalação é necessária. Se, ao contrário das expectativas, não existir, você pode baixá-lo aqui.

usando SHOW_MENU2up

para usar show_menu2 você tem que modificar o modelo onde deseja que o menu apareça. Observe: se as chamadas de menu antigas forem substituídas, os novos parâmetros correspondentes que show_menu2 precisa também devem ser usados.

na maioria dos casos, a chamada padrão com pelo menos 4 parâmetros de show_menu2 é suficiente. Neste caso, os valores padrão são usados, isso cria um menu que exibe a página atual e o subpáginas da página atual:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

por Favor, note: a chamada para show_menu2 é o PHP e normalmente deve ser incluído no código PHP caracteres (a menos que a chamada já está no código PHP):

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

este menu padrão já cria um menu completo em uma base de lista com várias classes que permitem fácil formatação usando CSS. Por exemplo, a classe “menu-current” é adicionada à tag <li> do item de menu atual. Além disso, cada item de menu dos subitens contém a classe “menu-expand”. Isso permite criar regras CSS muito diferenciadas para cada item de menu.
por exemplo:

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

a seção “saída HTML” contém uma descrição detalhada de quais classes são atribuídas a qual elemento. Ao usar diferentes parâmetros na chamada da função show_menu2, também é possível criar estruturas de menu bastante extensas e diferentes. Por exemplo, para exibir somente os itens de menu de nível superior da estrutura de menu, você poderia usar a seguinte chamada:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

Ou, por exemplo, a exibição de até dois subníveis da página atual:

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

Há um monte de possibilidades para criar diferentes estruturas de menu. Numerosos exemplos podem ser encontrados no site de demonstração: KLICK

FAQup

Q: eu não sou um programador. Não existe documentação mais simples?
A: Não, porque esta já é a documentação simples.

P: Como posso criar um menu suspenso?
A: isso não tem nada a ver com show_menu2. Para criar um menu suspenso, você só precisa ajustar o código CSS do respectivo modelo. Os ajustes necessários podem ser encontrados, por exemplo, no modelo” allcss2 ” do repositório Addon WebsiteBaker-> https://addon.websitebaker.org/

P: Por que o menu desaparece depois que eu uso a função de pesquisa em uma página multilíngue do WebsiteBaker?
A: as linhas necessárias estão faltando no modelo usado:

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

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

Q: multilingue? Parece óptimo. Como o fazes?
A: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

p: cada vez que uma página é chamada, o SM2 gera a seguinte mensagem de aviso:
“erro show_menu2: $aoptions é inválido. Sem bandeiras do grupo 1 fornecido!”
A: Os valores errados ou um número errado de valores foram passados para a função.
consulte a seção parâmetros para que os valores de sinalizador corretos passem para o parâmetro $aoptions.

P: Como faço para usar uma classe/imagem/cor/widget diferente para cada entrada em um menu?
A: Use a string de formato na string $aitemopen. Crie uma classe ou id exclusiva para cada item de menu e, em seguida, faça referência a esse item em seu CSS ou Javascript para fazer o que quiser.
Para adicionar uma classe única para cada item de menu (ou similar):

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

… criando itens de menu como …

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

Referência a isso no seu CSS como:

a.p45 { color: red; }

Para adicionar um ID exclusivo para cada item de menu (ou similar):

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

… criando itens de menu como …

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

faça referência a isso em seu CSS como:

a#p45 { color: red; }

observe que o ID só pode ser usado se esse menu for gerado e exibido uma vez apenas na página (porque os IDs HTML devem ser exclusivos em uma página).

FUNCTIONup

A chamada completa e os valores de parâmetro padrão para show_menu2 são como segue:

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

a seção “Parâmetros” contém uma descrição detalhada de cada parâmetro individual.
cada parâmetro deve ser usado absolutamente corretamente. As seguintes regras podem ajudar:

$aMenu = 0 é o melhor valor na maioria dos casos.
$ aStart deve ser um ID de página ou um valor começando com “SM2_”.
$aMaxLevel só pode obter valores começando com “SM2_”.
$aOptions exceto por alguns casos especiais apenas valores começando com “SM2_” são permitidos.
todos os outros parâmetros contêm as tags (HTML) que controlam a saída do menu.
a partir de $aitemabra cada parâmetro pode ser passado o valor false para obter o respectivo valor padrão.

Isso pode ser usado, por exemplo, para criar uma lista numerada, enquanto os valores padrão são usadas ainda para os itens de menu individuais:

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

por Favor, note: até e incluindo $aOptions todos os parâmetros devem ser passados explicitamente!

saída HTML

a saída HTML depende em grande parte de quais parâmetros são passados para a função. Independentemente disso, as classes subsequentes são sempre usadas para cada menu, em que itens de menu individuais também podem ter várias classes, se necessário.

Exemplo de saída 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

opções AVANÇADASUP

o parâmetro $aoptions pode ser usado de duas maneiras. Em primeiro lugar, conforme descrito acima na seção Parâmetros, esse tipo deve ser suficiente para a grande maioria dos casos de uso. No entanto, para poder abordar as opções especiais em casos especiais, os valores necessários devem ser fornecidos como uma matriz associativa.
observe: os sinalizadores SM2_* também são necessários aqui e devem ser passados como ‘sinalizadores’.

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

FORMATO STRINGSup

As seguintes tags podem ser usadas em cadeias de caracteres de formato para $aItemOpen e $aMenuOpen e deve ser substituído pelo texto correspondente.

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

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

'<li class="">'

'<ul class="">'

seguintes tags (etiquetas) SÓ estão disponíveis se o SM2_ALLINFO sinalizador está definido.

Formatação Condicional até

A instrução de formatação condicional pode assumir uma das seguintes formas:

a condição é uma combinação de uma ou mais comparações booleanas.
se mais de uma comparação for necessária, ela deve ser combinada com as outras comparações
pode ser vinculada usando || (booleano ou – OR) ou && (booleano e – AND).

uma única comparação consiste no operando esquerdo, no operador e no operando direito.
por exemplo, X = = Y – onde X é o operando esquerdo, = = o operador e Y o operando direito.

se uma cláusula else for adicionada, ela será executada em todos os outros casos.
por exemplo, “foo” é sempre executado quando a verificação if está errada, então:

por Favor, note:
Todas as verificações serão realizadas na ordem em que eles são observados, porque:

• não há verificação de possíveis loops (todas as verificações são sempre executadas).
• as verificações não são agrupadas (parênteses de verificações não são suportados)
• ambas as coisas têm o mesmo valor.

FORMATTERup

Atenção: Este é um recurso avançado e raramente usado!

com amplo conhecimento em programação PHP, é possível usar a formatação predefinida
de show_menu2 com a sua própria.
na inclusão.php de show_menu2 você pode ver como escrever o formatador.
a API que deve ser usada se parece com isso:

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 lançado sob a GNU General Public License