Gérer les menus

L'écran Menus (menu Administration › Apparence et langues › Menus) règle le menu de navigation de Portail ZAPP : ses entrées, leur ordre, leur icône, leurs libellés dans chaque langue et les groupes qui les voient. Il est réservé aux Administrateurs.

La liste des menus

Chaque menu a un Nom, un Type et une date de création. Boutons de chaque ligne : Modifier, Attributions, Exporter et Supprimer (après confirmation).

+ Nouveau menu demande un Nom et un Type : Principal, Contextuel ou Barre latérale. La navigation de Portail ZAPP affiche un menu de type Principal : celui attribué à la personne ou à l'un de ses groupes (voir « Attributions »), à défaut le menu principal par défaut, signalé par le badge Par défaut dans la liste. Le menu par défaut est le menu Main ; s'il n'existe pas ou n'est pas de type Principal, c'est le plus ancien menu de type Principal. Un autre menu de type Principal ne s'affiche donc que pour les personnes à qui il est attribué.

Le menu livré avec Portail ZAPP s'appelle Main. Les mises à jour y ajoutent les entrées des nouvelles fonctions en le retrouvant par ce nom : ne le renommez pas.

Modifier ouvre le menu :

Propriétés : son Nom et son Type, puis Enregistrer ;
Éléments : ses entrées, présentées en arbre.

Ajouter un élément

Le formulaire Ajouter un élément demande :

le Libellé, affiché quand aucune traduction ne correspond à la langue du lecteur ;
le chemin de la page (par exemple /tickets) ; laissé vide, l'élément sert de dossier pour d'autres éléments ;
l'icône (par exemple bi-house) : le bouton à côté du champ ouvre un sélecteur d'icônes avec recherche ;
le parent (Aucun parent pour une entrée de premier niveau) ;
l'ordre (un nombre : les plus petits d'abord).

Le libellé, le chemin, l'icône et le parent ne se modifient plus ensuite : pour les changer, supprimez l'élément et recréez-le. Le libellé affiché se corrige en revanche par les traductions.

Ranger les éléments

Faites glisser un élément par sa poignée ⠿ : le nouvel ordre est enregistré aussitôt (Enregistré s'affiche). Le glisser-déposer change l'ordre, pas le parent.

Dans la navigation, les entrées de premier niveau suivent l'ordre choisi. Dans un dossier, les sous-dossiers passent avant les liens, puis l'ordre et le libellé départagent.

Qui voit un élément

Ouvrez un élément pour régler sa section Permissions :

Groupes autorisés : cochez les groupes concernés. Aucun groupe coché : l'élément est visible par tous ;
Mode de visibilité : N'importe quel groupe (il suffit d'appartenir à l'un d'eux) ou Tous les groupes (il faut appartenir à tous).

Cette visibilité ne règle que l'affichage du menu, pas les droits : masquer une entrée n'interdit pas la page, qui reste protégée par ses propres droits (voir « Régler les droits »). Inversement, certaines entrées s'affichent pour une personne qui a les droits sur la page même si ses groupes ne la montrent pas. Les entrées d'un module que la licence n'inclut pas sont masquées. Un changement de groupes d'une personne atteint son menu en quelques minutes.

Traduire un élément

La section Traductions liste les libellés et infobulles de l'élément par langue. Ajouter / mettre à jour une traduction : choisissez la Langue (parmi les langues actives), saisissez le Libellé et, si besoin, l'Infobulle, puis Enregistrer ; une traduction existante pour cette langue est remplacée. Supprimer retire une traduction.

Chacun voit le libellé de sa langue, à défaut celui de la langue par défaut de l'instance, à défaut le libellé de base.

Supprimer un élément

Supprimer l'élément (après confirmation) retire l'élément et ses traductions. Un élément qui contient des sous-éléments ne peut pas être supprimé : le message « Cet élément a des sous-éléments : déplacez-les ou supprimez-les d'abord. » s'affiche et rien n'est supprimé. Supprimez d'abord ses sous-éléments.

Exporter et importer

Exporter télécharge le menu dans un fichier JSON : entrées, ordre, icônes, traductions et groupes autorisés (désignés par leur code).
Importer charge un tel fichier. Si un menu du même nom existe, toutes ses entrées sont remplacées par celles du fichier ; sinon le menu est créé. Le résultat indique si le menu a été créé ou mis à jour, et le nombre d'éléments importés.

Un groupe du fichier qui n'existe pas sur l'instance est listé sous Groupes inconnus sur cette instance. Une entrée n'est jamais ouverte à tous à cause d'un groupe manquant : si aucun de ses groupes n'existe (ou s'il en manque un en mode Tous les groupes), elle est réservée aux administrateurs et listée sous Entrées réservées aux administrateurs. Créez les groupes manquants avant d'importer, ou reprenez ensuite la visibilité des entrées concernées. Sans groupe des administrateurs sur l'instance, l'import est refusé et rien n'est modifié.

Attributions

Attributions associe le menu à un compte ou à un groupe, avec une Priorité (de 0 à 100, 50 par défaut) : choisissez le Type de cible (Groupe ou Utilisateur), puis la Cible — le groupe dans la liste, ou le compte en cherchant son nom ou son adresse e-mail (deux caractères au moins) — et Ajouter. La liste des attributions affiche le nom de la cible ; une cible supprimée depuis apparaît Introuvable.

Les attributions règlent la navigation de Portail ZAPP comme celle des applications qui lisent le menu par l'API :

le menu de type Principal attribué à la personne elle-même, quelle que soit sa priorité ;
à défaut, celui attribué à l'un de ses groupes, la priorité la plus haute d'abord (à priorité égale, le nom du menu départage) ;
à défaut, le menu principal par défaut.

Seuls les menus de type Principal remplacent la navigation : attribuer un menu Contextuel ou Barre latérale ne la change pas (l'écran le signale). Dans le menu choisi, chaque entrée reste soumise à sa visibilité par groupes.

Voir aussi

« Gérer les groupes » : les groupes qui règlent la visibilité des entrées.
« Régler les droits » : ce qui autorise vraiment l'accès à une page.