Documentation en ligne

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

Maintenant que le menu personnalisé est 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 :
  • agendas
  • announces
  • book
  • calendar
  • cards
  • categories
  • clock
  • counter
  • data
  • facturier
  • forms
  • gis
  • grid
  • home
  • mail
  • management
  • organizational-units
  • passerelle
  • password
  • phone
  • portal
  • portal-agent
  • porte-doc
  • roles
  • security
  • services
  • settings
  • statistics
  • studio
  • submission
  • system
  • texts
  • theme
  • users
  • 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 « Adminisrateur 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é.

 

Dernière mise à jour le 20 mai 2021 12:11 — Éditer