Le plugin Quicklinks fournit une interface back office permettant de gérer la liste des Quicklinks disponibles sur le site. La fonctionnalité d'administration des Quicklinks se nomme "Gestion des Quicklinks".
Dans la page de gestion des Quicklinks, cliquer sur le bouton "Créer un Quicklinks" (attention, il faut disposer des droits nécessaires, voir le chapitre Accès back office ). Un formulaire de saisie apparait, indiquant les champs génériques du Quicklinks :
On distingue deux types d'affichage d'un Quicklinks sur le site : l'affichage par rubrique (ou portlet) et par PageInclude. Un Quicklinks ne peut pas simultanément être affiché dans une rubrique et en PageInclude :
Un Quicklinks peut comporter un nombre indéfinit d'attributs. Les attributs sont organisés sous la forme d'une arborescence (la profondeur de l'arbre n'est pas limitée).
L'ajout d'un attribut s'effectue dans la page de modification d'un Quicklinks. Choisir le type d'attribut souhaité et cliquer sur "Ajouter".
Différentes actions sont disponibles pour chaque attribut :
Les différents types d'attributs sont listés ci-dessous.
L'attribut de type Texte offre la possibilité au webmestre d'insérer du texte riche à l'aide de l'éditeur WYSIWYG du back office.
L'attribut de type Lien offre la possibilité au webmestre d'insérer un lien dont l'affichage peut être personnalisé.
L'attribut de type Liste de sélection offre la possibilité au webmestre d'insérer une liste déroulante ("select") dont l'affichage peut être personnalisé. L'interface de gestion des listes de sélection propose la saisie du titre de l'attribut, puis l'ajout successif des options (couple "titre/url"). Au niveau du site, l'affichage de cet attribut se fera sous la forme d'un champ select ("listbox") dont un clic sur une option chargera l'url correspondante.
L'attribut de type Lien interne offre la possibilité au webmestre d'insérer un lien interne au site (un lien relatif le plus souvent). Ce lien est généré grace au mécanisme d'InsertService. L'attribut est constitué d'un champ "Titre" et d'un champ "Contenu". Le champ "Contenu", par défaut en lecture seule est renseigné via l'InsertService. Un bouton "Prévisualisation" affiche le contenu HTML généré.
Un Quicklinks peut être affiché de différentes manières. Deux types d'affichage sont disponible : l'affichage sous la forme d'une rubrique et celui avec un PageInclude.
Le plugin Quicklinks fournit un type de portlet appellé "Quicklinks". Il permet d'afficher un portlet de ce type sur n'importe quelle page standard du site. La seule configuration spécifique à ce type de portlet est le choix du Quicklinks. La création d'un portlet Quicklinks ne présente pas de différence avec les autres types de portlet. La gestion des portlets dans les pages s'effectue dans l'interface d'administration du site.
Le PageInclude "Quicklinks" fournit, pour chaque Quicklinks de type "Include" un markeur Freemarker à insérer dans les templates du site :
Exemple d'insertion du markeur "quicklinks_1" correspondant au Quicklinks d'identifiant 1 dans page_frameset.html :
<body onload="setHover( 'menu-main' );">
${page_header}
${page_main_menu}
<hr />
<div id="page">
${page_path}
<div id="Quicklinks">
${quicklinks_1?default("<!-- No Quicklinks 1-->")}
</div>
${page_content}
</div>
<div style="clear: both;"> </div>
${page_footer}
${statistical_include}
</body>
L'accès au plugin est soumit à restriction, aussi bien sur le site que dans le back office.
Chaque Quicklinks peut se voir attribuer un Rôle Lutèce, permettant de le restreindre aux seuls utilisateurs ayant accès à ce rôle. Si le Quicklinks est de type Rubrique, l'utilisateur n'ayant pas accès au rôle verra un portlet vide. Si le Quicklinks est de type "Include", l'include sera vide, le quicklinks ne s'affichera donc pas.
L'interface d'administration des quicklinks est soumis à resctriction d'accès. Le gestionnaire doit avoir le droit "Gestion des Quicklinks" dans sa liste de droits.
La liste des quicklinks peut être restreinte par groupe de travail. Le gestionnaire connecté ne verra que les quicklinks non liés à un groupe de travail ou ceux qui correspondent aux groupes de travail auxquel il est inscrit.
Par ailleurs, chaque action sur un quicklinks peut être controlée grâce aux Rôles. La liste des actions sur un quicklinks est disponible ci-dessous :