Menus multiples

show_menu2, version 4.9x

Show_Menu2 est un extrait de code pour le créateur de site Web CMS. Depuis WebsiteBaker 2.7, il est inclus avec le CMS.
L’ancienne fonction show_menu est complètement remplacée et étendue par show_menu2. Toutes les données nécessaires à la création du menu sont générées par une seule requête de base de données. Par des possibilités d’ajustement étendues du code HTML généré tous les types de menus possibles (listes, chapelure, plans du site, etc.) peuvent être générés.

• Installation
• Utilisation de Show_Menu2
• FAQ
• Fonction
• Sortie HTML
• Paramètre
• Options avancées
• Chaînes de format
• Mise en forme conditionnelle
• Formateur

INSTALLATIONup

Puisque show_menu2 est généralement présent dans WebsiteBaker, aucune installation n’est requise. Si, contrairement aux attentes, il n’existe pas, vous pouvez le télécharger ici.

Utilisation de SHOW_MENU2up

Pour utiliser show_menu2, vous devez modifier le modèle où vous souhaitez que le menu apparaisse. Remarque : Si les anciens appels de menu sont remplacés, les nouveaux paramètres correspondants dont show_menu2 a besoin doivent également être utilisés.

Dans la plupart des cas, l’appel standard avec au moins 4 paramètres de show_menu2 est suffisant. Dans ce cas, les valeurs par défaut sont utilisées, cela crée un menu qui affiche la page en cours et les sous-pages de la page en cours:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

Remarque: l’appel à show_menu2 est PHP et doit normalement être entouré de caractères de code PHP (sauf si l’appel est déjà dans le code PHP):

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

Ce menu par défaut crée déjà un menu complet sur une base de liste avec plusieurs classes qui permettent un formatage facile à l’aide de CSS. Par exemple, la classe « menu-current » est ajoutée à la balise < li > de l’élément de menu actuel. De plus, chaque élément de menu des sous-éléments contient la classe « menu-expand ». Cela permet de créer des règles CSS très différenciées pour chaque élément de menu.
Par exemple:

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

La section « Sortie HTML » contient une description détaillée des classes affectées à quel élément. En utilisant différents paramètres dans l’appel de fonction show_menu2, il est également possible de créer des structures de menus assez étendues et différentes. Par exemple, pour afficher uniquement les éléments de menu du niveau supérieur de la structure de menu, vous pouvez utiliser l’appel suivant:

show_menu2(0, SM2_ROOT, SM2_START, SM2_TRIM);

Ou, par exemple, pour afficher jusqu’à deux sous-niveaux de la page en cours:

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

Il y a beaucoup de possibilités pour créer différentes structures de menus. De nombreux exemples peuvent être trouvés sur le site de démonstration: KLICK

FAQup

Q: Je ne suis pas un programmeur. N’y a-t-il pas de documentation plus simple ?
D: Non, car c’est déjà la documentation simple.

Q: Comment puis-je créer un menu déroulant?
R: Cela n’a rien à voir avec show_menu2. Pour créer un menu déroulant, il vous suffit d’ajuster le code CSS du modèle respectif. Les ajustements nécessaires peuvent être trouvés par exemple dans le modèle « allcss2 » du référentiel Addon WebsiteBaker -> https://addon.websitebaker.org/

Q : Pourquoi le menu disparaît-il après que j’ai utilisé la fonction de recherche dans une page Web multilingue ?
R : Les lignes nécessaires sont manquantes dans le modèle utilisé :

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

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

Q: Multilingue? Ça a l’air génial. Comment faites-vous?
D: https://help.websitebaker.org/en/designerguide/multilingual-websites.php

Q : Chaque fois qu’une page est appelée, SM2 génère le message d’avertissement suivant :
« erreur show_menu2 :aaOptions n’est pas valide. Aucun drapeau du groupe 1 fourni! »
A: Les mauvaises valeurs ou un mauvais nombre de valeurs ont été transmises à la fonction.
Voir la section PARAMÈTRES pour les valeurs d’indicateur correctes à transmettre au paramètre $aOptions.

Q: Comment utiliser une classe/image/ couleur / widget différente pour chaque entrée d’un menu?
A: Utilisez la chaîne de format dans la chaîneaaItemOpen. Créez une classe ou un identifiant unique pour chaque élément de menu, puis référencez cet élément dans votre CSS ou Javascript pour faire ce que vous voulez.
Pour ajouter une classe unique pour chaque élément de menu (ou similaire):

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

… création d’éléments de menu comme…

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

Référencez ceci dans votre CSS comme:

a.p45 { color: red; }

Pour ajouter un identifiant unique pour chaque élément de menu (ou similaire):

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

… création d’éléments de menu comme…

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

Référencez ceci dans votre CSS comme:

a#p45 { color: red; }

Notez que l’ID ne peut être utilisé que si ce menu est généré et affiché une seule fois sur la page (car les ID HTML doivent être uniques dans une page).

FUNCTIONup

L’appel complet et les valeurs de paramètre par défaut pour show_menu2 sont les suivants:

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

La section « Paramètres » contient une description détaillée de chaque paramètre individuel.
Chaque paramètre doit être utilisé absolument correctement. Les règles suivantes peuvent vous aider:

aMenaMenu= 0 est la meilleure valeur dans la plupart des cas.
aStaStart doit être soit un ID de page, soit une valeur commençant par « SM2_ ».
aMaMaxLevel ne peut obtenir que des valeurs commençant par « SM2_ ».
aaOptions à l’exception de quelques cas particuliers, seules les valeurs commençant par « SM2_ » sont autorisées.
Tous les autres paramètres contiennent les balises (HTML) qui contrôlent la sortie du menu.
À partir deaaItemOpen, chaque paramètre peut recevoir la valeur false pour obtenir la valeur par défaut respective.

Cela peut être utilisé, par exemple, pour créer une liste numérotée, tandis que les valeurs par défaut sont toujours utilisées pour les éléments de menu individuels:

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

Remarque: jusqu’à includingaOptions inclus, tous les paramètres doivent être passés explicitement!

Sortie HTML

La sortie HTML dépend en grande partie des paramètres transmis à la fonction. Indépendamment de cela, les classes suivantes sont toujours utilisées pour chaque menu, les éléments de menu individuels pouvant également avoir plusieurs classes si nécessaire.

Exemple de sortie 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

aMenaMenu

aStaStart

$ 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

aaItemClose

aMenaMenuOpen

aMenaMenuClose

aTAu Sommeouvrez

aTAu sommet du menu Ouvrir

ADVANCED OPTIONSup

le paramètre $aOptions peut être utilisé de deux façons. Tout d’abord, comme décrit ci-dessus dans la section Paramètres, ce type devrait suffire pour la grande majorité des cas d’utilisation. Toutefois, pour pouvoir aborder les options spéciales dans des cas particuliers, les valeurs requises doivent être fournies sous forme de tableau associatif.
veuillez noter: les indicateurs SM2_ * sont également requis et doivent être transmis en tant que ‘flags’.

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

FORMAT STRINGSup

Les balises suivantes peuvent être utilisées dans les chaînes de format pour $aItemOpen et $aMenuOpen et doivent être remplacées par le texte correspondant.

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

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

'<li class="">'

'<ul class="">'

Les balises suivantes ne sont disponibles QUE si l’indicateur SM2_ALLINFO est défini.

Mise en forme conditionnelle jusqu’à

L’instruction de mise en forme conditionnelle peut prendre l’une des formes suivantes:

La condition est une combinaison d’une ou plusieurs comparaisons booléennes.
Si plus d’une comparaison est nécessaire, elle doit être combinée avec les autres comparaisons
peuvent être liées en utilisant |/ (booléen ou -OU) ou & & (booléen et – ET).

Une seule comparaison se compose de l’opérande gauche, de l’opérateur et de l’opérande droit.
par exemple X == Y – où X est l’opérande gauche, == l’opérateur et Y l’opérande droit.

Si une clause else est ajoutée, elle sera exécutée dans tous les autres cas.
Par exemple, « foo » est toujours exécuté lorsque la vérification if est incorrecte, donc:

Remarque :
Tous les contrôles seront effectués dans l’ordre dans lequel ils sont notés, car:

• Il n’y a pas de vérification des boucles possibles (toutes les vérifications sont toujours exécutées).
• Les vérifications ne sont pas groupées (les parenthèses de vérifications ne sont pas prises en charge)
• Ces deux éléments ont la même valeur.

FORMATTERup

Attention: Il s’agit d’une fonctionnalité avancée et rarement utilisée!

Avec une connaissance approfondie de la programmation PHP, il est possible d’utiliser le formatage
prédéfini de show_menu2 avec le vôtre.
Dans l’inclusion.php de show_menu2 vous pouvez voir comment écrire le formateur.
L’API qui doit être utilisée ressemble à ceci:

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

Websitebakerest publié sous la Licence Publique Générale GNU