La personnalisation étant au cœur de tout logiciel libre, il est naturel que vous cherchiez des moyens d'adapter votre wiki à vos besoins. Dans ce guide, nous allons vous aider avec les étapes à suivre pour personnaliser vos menus de navigation.
Qu'est-ce que l'application Menus ?
Votre instance XWiki vous permet de créer, d'éditer ou de personnaliser des menus à l'aide de l'application Menus dans Administrer le wiki > Apparence > Menus. L'application Menus est une extension qui vous aide à créer des menus de navigation affichés horizontalement dans une barre supérieure après l'en-tête de la page, ou verticalement dans un panneau latéral. L'extension a été créée à l'aide de notre logiciel polyvalent App Within Minutes. Si vous connaissez déjà l'application App Within Minutes, vous remarquerez que sa page d'accueil est identique à celle de l'application Menus.
Si vous ne connaissez pas encore notre App Within Minutes, nous voulons simplement dire que ses multiples cas d'utilisation parlent d'eux-mêmes en ce qui concerne la polyvalence de cette application : vous pouvez l'utiliser à des fins de RH et créer une application pour les congés, vous pouvez l'adapter aux besoins de votre équipe d'assistance en créant une application FAQ ou l'utiliser pour des événements ou à des fins de marketing. Si nous avons éveillé votre curiosité, pourquoi ne pas essayer App Within Minutes ?
Par défaut, l'application Menus est configurée de manière à ce que seuls les administrateurs puissent la voir, mais vous pouvez modifier cette configuration au moyen des autorisations. Cependant, toutes les entrées de menu que vous avez créées avec l'application sont visibles par tout le monde par défaut.
À partir de la version 10.8, l'application Menus est disponible par défaut dans l'Administration globale, sous la section Apparence. Si l'application Menus n'apparaît pas dans votre liste, on vous recommande de l'installer ou de la mettre à jour vers la dernière version en utilisant le Gestionnaire d'extensions depuis votre instance XWiki.
admin-menu.png
Créer et modifier le menu
Pour créer un nouveau menu, cliquez sur AJOUTER UNE NOUVELLE ENTRÉE et saisissez le nom souhaité.
menu entry.png
Depuis cette page, vous pouvez également modifier un menu existant.
Personnaliser le menu
Comme vous le verrez ci-dessous, vous pouvez personnaliser votre menu en sélectionnant son emplacement et en indiquant dans quel contexte le menu sera visible.
1. Choisir l'emplacement d'affichage de votre menu
Le menu est défini à l'aide de listes imbriquées, d'ancres et d'icônes. Vous pouvez placer le menu :
- Après l'en-tête de la page
- Dans un panneau à droite
- Dans un panneau à gauche
menu structure\_display loc.png
2. Spécifier dans quel contexte le menu est visible
Vous pouvez préciser un champ de visibilité pour le menu :
- Current User (par défaut)
- Current Wiki
- Global
menu structure\_vis scope.png
A noter que les contextes Current Wiki et Global demandent des droits d'administrateur ou de programmation.
- Current Wiki: sélectionnez cette option si vous n'avez besoin du menu que sur un seul wiki.
- Global: sélectionnez cette option pour utiliser le menu globalement sur tous les wikis.
Enregistrez la page de menu. Félicitations ! Vous pouvez désormais utiliser votre nouveau menu !
Comment votre menu sera affiché
Si vous choisissez de placer le menu après l'en-tête de la page, il s'affichera horizontalement sous la forme d'une barre de menu déroulante.
header menu.png
header menu2.png
Si vous choisissez d'afficher le menu dans un panneau latéral, vous devez effectuer une étape supplémentaire. Voir ci-dessous.
Ajoutez la page de menu que vous avez créée (vous pouvez en obtenir la référence à partir de l'onglet Informations, par exemple Menu.Test Menu.WebHome) à la liste de panneaux gauches/droites ou les deux dans Administration globale, par exemple Panels.Applications,Panels.Navigation,Menu.Test Menu.WebHome
Pour trouver la section Panneaux, vous devez vous rendre dans Administrer le wiki, puis élargir la section Apparence et choisir Panneaux. Dans les champs Panneaux affichés à gauche/à droite, ajouter la syntaxe tout comme dans l'exemple ci-dessus. Cliquer sur Enregistrer la disposition et le menu devrait s'afficher immédiatement.
panels.png
Pour plus de ressources de personnalisation, vous pouvez consulter notre section [Meilleures pratiques](/Blog/Meilleures Pratiques).