Visibility est une app développée par ServiceRocket disponible sur la Marketplace Atlassian. Elle permet d’afficher, ou non, une partie du contenu d’une page Confluence à un utilisateur en fonction de différents critères comme ses droits, son appartenance à un groupe, l’appartenance de la page à une hiérarchie spécifique, voire même son mode d’affichage et les propriétés du navigateur web.
Le plugin Visibility a beaucoup évolué depuis sa première version. De nombreuses macros ont disparu pour se recentrer sur l’essentiel avec “show-if” et “hide-if”. Comme leur nom l’indique, ces macros permettent soit de montrer, soit de cacher le contenu d’une page si la/les condition(s) sont satisfaites.
Sa gratuité ainsi que les nombreux cas d’utilisation ont rendu cette app populaire et largement utilisée lors des implémentations. Vous pouvez décider d’afficher des parties d’une page en fonction de l’appartenance d’une équipe à un groupe ou tout simplement laisser des consignes non visibles en mode lecture. Les informations cachées restent accessibles via l’action “view source”, donc ce n’est pas une solution sûre pour cacher des informations sensibles.
Mais depuis le mois de janvier 2019, et la version 5.0, Visibility est devenue une app payante. Donc si vous êtes utilisateur, sachez que lorsque vous arriverez à la date de fin de validité de la licence (ou date de renouvellement), votre app ne fonctionnera plus sauf si vous l’achetez. Heureusement elle reste abordable : $150 pour 250 utilisateurs, $1,000 pour 10,000 et $1,500 en illimité.
Si vous préférez une alternative à cette app, sachez qu’une grande partie des fonctionnalités apportées par Visibility peut être nativement couverte avec des user macros.
L’implémentation faite dans ces user macros ne couvre pas entièrement le périmètre proposé par l’app Visibility.
Voici les fonctionnalités reprises :
- les utilisateurs nommés
- l’appartenance à un groupe
- les droits sur une page ou espace
- le type d’affichage, attention, seul l’export PDF sera disponible avec l’option “printable”
- toutes les conditions / une condition parmi elles
Une user macro est une macro, déclarée et définie par l’administrateur de Confluence, pouvant faire un traitement sur du contenu ou afficher du contenu additionnel. La création d’une user macro demande quelques compétences en développement et de savoir lire l’API Java.
Nous vous dévoilons ici comment procéder au remplacement par une solution native.
- Tout d’abord vous devrez désactiver l’app Visibility puisqu’elle sera remplacée par les user macros
- Il vous faudra modifier le CSS pour pouvoir choisir de cacher ou non certaines parties de la page Confluence lors de l’export PDF
- Enfin, il faudra créer les 2 users Macros
Entrons à présent dans le vif de l’action.
Création de la user macro “Hide-if”
Modification du CSS
Ajouter du CSS dans le Style PDF de votre instance
Création de la user macro
Suivez les instructions de création d’une nouvelle user macro en utilisant le paramétrage ci-dessous:
Nom de la macro : hide-if
Visibilité :
Titre de la macro : Hide-If
Description : Cache le contenu lorsque les conditions sont remplies
Catégories : Contenu de Confluence
Traitement du corps de la macro : Rendu
Modèle
Voilà le tour est joué, vos utilisateurs peuvent à présent cacher certaines parties d’une page Confluence selon les conditions qui seront définies.
Création de la user macro “Show-if”
Modification du CSS
Ajouter du CSS dans le Style PDF de votre instance
Création de la user macro
Suivez les instruction de création d’une nouvelle user macro en utilisant le paramétrage ci-dessous:
Nom de la macro : show-if
Visibilité :
Titre de la macro : Show-if
Description : Montre le contenu lorsque les conditions sont remplies
Catégories : Contenu de Confluence
Traitement du corps de la macro : Rendu
Modèle
Vous pourrez maintenant montrer du contenu uniquement si certaines conditions sont respectées.
Vous avez le choix
Vous l’aurez donc compris, selon votre situation et vos ressources en interne, vous pouvez soit acheter l’app Visibility, soit contourner l’app en créant deux user macros qui vous procureront sensiblement les mêmes fonctionnalités.
Pour toute question, n’hésitez pas à contacter nos consultants certifiés Atlassian.
Nous contacter
