Créer un menu personnalisé

Le menu qui s'affiche, en backoffice dans la barre latérale gauche, dépend des droits de l'utilisateur connecté, il est standard et lié aux différentes briques présentes dans Publik.

Il est possible de remplacer ce menu standard par un menu entièrement personnalisé en créant des pages spécifiques du portail agent qui deviendront des entrées du menu.

Créer les pages

Quand le menu personnalisé sera activé, toutes les pages du portail agent pour lesquelles :

L'option « Incluse dans les menus » est à Oui
Vous avez les droits (rôles) nécessaires permettant de les voir

vont apparaître comme des entrées du menu latéral.

Ces entrées seront des liens vers l'URL que vous allez spécifier dans l'option « URL de Redirection » de la page.

Des sous-pages seront des sous-entrées du menu.

Ajouter des icônes

Il est possible de donner des slugs spécifiques à certaines pages afin qu'elles se voient automatiquement attribuées dans le menu une icône adaptée, voici la liste des identifiants possibles, avec leur utilisation dans le menu par défaut :

agendas, pour les agendas (module Chrono)
announces
book
calendar
cards, pour les modèles de fiches
categories, pour les catégories
clock
counter
data, pour les fiches
facturier
forms, pour les formulaires
gis
grid
home, pour l’accueil
identity-management, pour la gestion d’identités
mail
management, pour l’écran de traitement
organizational-units
passerelle, pour les services web (module Passerelle)
password
phone
portal, pour l’édition du portail
portal-agent, pour l’édition du portail agents
porte-doc
roles, pour la gestion des rôles
security
services
settings
statistics, pour les statistiques
studio, pour l’écran d’accueil Publik Studio
submission, pour la saisie
system, pour la configuration système
texts
theme
users, pour les utilisateurs
workflows, pour les workflows

En dehors de ces noms particuliers, il reste possible d'ajouter une icône personnalisée à une page grâce à son option « Image ». L'image positionnée ici apparaîtra dans le menu à côté du titre de la page.

Le format des icônes « Standard » est d'environ 40x40 pixels

Positionner les rôles sur les pages

Il faut veiller à la cohérence entre les droits d'accès aux briques vers lesquelles pointent les entrées du menu et le ou les rôles positionnés sur les pages du portail agent dans l'option « Visibilité ». Sans cela, on pourrait afficher à l'usager une entrée de menu qui lui donnerait une erreur 403 ou au contraire ne pas lui afficher une entrée vers une brique à laquelle il peut accéder.

Ajouter une variable

Si vous ne pouvez pas accéder à la brique « Système » demandez à votre administrateur de faire l'ajout de la variable pour vous.

Pour que votre menu sur mesure vienne prendre la place du menu standard, il est nécessaire de définir une variable.

Allez dans « Système » puis choisissez « Services » dans le menu burger. Cherchez l'élément « Portail agent » dans la page, et cliquez sur « Variables personnalisées > » puis sur « Ajouter une variable ». Complétez la variable comme suit (le libellé est sans importance) :

Nom : SETTING_PUBLIK_EXPLICIT_MENU

Valeur : True

Attention, n'activez cette variable que lorsque vous avez déjà configuré les pages de votre portail agent pour qu'elle vous donne des entrées dans le menu, sinon votre menu sera vide, il ne vous permettra plus d'accéder aux différentes briques (notez toutefois que même lorsque les entrées du menu ont disparu, les différentes briques restent accessibles en utilisant directement leurs URLs).

Fichier JSON standard

Afin de faciliter la mise en place, nous avons réalisé ce fichier exemple qui peut être importé dans votre portail agent sur vos plates-formes de test. Il faut impérativement que les rôles « Agent » et « Administrateur fonctionnel » existent sur votre plate-fome pour que l'import se fasse correctement.

Attention, il va venir prendre la place des pages éventuellement existantes et portant le même nom.

Après import du fichier dans votre portail agent, il faut penser à ajouter la variable pour activer le menu personnalisé.

Documentation en ligne