révision 1-23/01/2012 Bloc "Menu personnalisé" Présentation Ce type de bloc permet de proposer un menu composé de ressources diverses, internes et/ou externes à Alexandrie. Les ressources peuvent être organisées hiérarchiquement. Plusieurs modalités de présentation sont proposées. Des droits peuvent être posés sur chaque item du menu. Avec ce type de bloc, il est possible de mettre en place un menu du type : Ressources internes Rechercher Lien vers un formulaire de recherche Nouveautés Affichage d'un dossier Informations pratiques Lien vers un enregistrement de type Contenu Ressources externes Site partenaire Accès au site du partenaire Sélections de sites Affichage d'un dossier Actualités Affichage d'un fil RSS Plusieurs blocs menus personnalisés peuvent être mis en place. Mise en place Page 1 / 5
Trois informations sont spécifiques : Type de bloc Paramètres Choisir : Type : menu utilisateur styleclass=classe CSS du bloc displaymode=default ou onglet default = présentation sous forme de liste onglet = présentation en onglets et sous-onglets accordion = présentation en menu de type "accordéon" Si le paramètre displaymode est omis ou vide, le style default est appliqué. NB : le style accordéon est celui exploité pour les menus du bloc "Contenu", et pour l'espace Gestion lorsque les menus sont affichés à gauche. Exemples diplaymode=default displaymode=onglet displaymode=onglet et deux niveaux : onglets et sous-onglets Contenu XML Contenu XML Intitulé Droits Cette zone doit contenir la description du menu, structurée dans un fichier XML, décrit ci-après. Balise racine du document : La racine peut contenir deux types de contenus : <groupmenu> : décrit un sous-menu : décrit un lien du menu Le menu, les groupmenu et itemmenu partagent un certain nombre de balises : <title> : l'intitulé à afficher <icon> : une icône représentant l'objet <first> : définit qui des items ou des sous-menus doivent s'afficher en premier dans le cas ou les deux types sont utilisés à un même niveau (valeurs possibles items groups) <rights> : balise composée permettant de restreindre la visibilité de l'objet La balise <rights> s'utilise de la manière suivante : Page 2 / 5
Action Lister les groupes autorisés <rights visible="authorized "> <groupid>xxx</groupid> <groupid>yyy</groupid> Lister les groupes exclus <rights visible= "notauthorized"> <groupid>xxx</groupid> <groupid>yyy</groupid> Une seule des deux descriptions doit être utilisée. D'autres balises sont spécifiques aux itemmenu et exceptionnellement aux groupitem (si l'on souhaite déclencher une action sur le lien du sous-menu) : <action> : contenu de l'url (selon la balise <type>) <type> : si type est vide, c'est le contenu de <action> qui constitue l'url ; sinon indiquer "alex" pour spécifier une page d'alexandrie ; dans ce cas, les paramètres doivent être précisés pour que le lien soit opérationnel. : balise composée contenant les paramètres de l'url Alexandrie La balise s'utilise de la manière suivante : <name></name> <value> </value> Les paramètres se repèrent dans l'url ; ils suivent le signe? et sont séparés par des? : name : valeur avant le signe = value : valeur suivant le signe = NB : le paramètre cid ne doit jamais être spécifié. Cas des URL internes L'utilisation de variables permet de : construire dynamiquement la racine des URL en fonction des valeurs enregistrées dans les paramètres d'application ; cette fonction garantit la pérennité des URL en cas de changement de serveur et/ou nom de domaine ; compléter certains paramètres contextuels (fonds, blog). Se reporter à la note technique NTA083 - Insertions de varaibles dans les blocs. Exemples Menu à un niveau - sans restriction GBConcept accès au site www.gbconcept.com Actualités affichage d'un dossier Page 3 / 5
Menu à un niveau avec restriction GBConcept accès au site www.gbconcept.com Actualités affichage d'un dossier - exclus aux invités Le groupe de rôle Invité a l'id n 5 <rights visible="unauthorized"> <groupid>5</groupid> Si l'item "En bref" doit être exclus pour les groupes d'id 5 et 6, par exemple, la balise rights serait écrite de la façon suivante : <rights visible="unauthorized"> <groupid>5</groupid> <groupid>6</groupid> Page 4 / 5
Si inversement, l'item "En bref" doit être visible uniquement par les groupes d'id 1 et 2, par exemple, la balise rights serait écrite de la façon suivante : <rights visible="authorized"> <groupid>1</groupid> <groupid>2</groupid> Menu à deux niveaux - structure Ressources internes GBConcept Actualités Ressources externes accès au site www.gbconcept.com affichage d'un dossier groupitem> <title>ressources internes</title> <title>ressources externes</title> Page 5 / 5