Pas à pas, personnalisation de la skin du wiki

12 mai 2020 5 min read
Écrit par Andreea Chirica, Spécialiste Communications et Support

Saviez-vous que vous pouvez personnaliser la skin de votre wiki ? Par exemple, si vous souhaitez supprimer un bouton d'une page wiki, cela implique de modifier la skin, qui structure visuellement le contenu des pages wiki. C'est différent de la notion de thèmes de couleur (et voici un article sur la façon de personnaliser le thème de couleur sur votre wiki) qui sont des ensembles de couleurs pour les différents éléments de la skin.

Dans cet article, vous trouverez des détails sur la manière de cacher le menu Plus d'actions1 (disponible en cliquant sur ce bouton more-actions-button.png), pour vous aider à mieux comprendre la personnalisation de la skin. Cet exemple a été réalisé sur la version 12.3 d'XWiki, qui contient par défaut la skin Flamingo.

Astuce pratique

Une skin peut être modifiée à différents niveaux - pour l'ensemble du wiki, pour un espace donné ou pour un utilisateur. Pour pouvoir la modifier, l'utilisateur doit être un administrateur de l'instance XWiki en cours.

Voyons les étapes d'une méthode permettant de supprimer le menu "Plus d'actions" :

Personnalisez la skin de votre wiki

Dans les étapes ci-dessous, vous apprendrez comment utiliser l'application Skin intégrée pour personnaliser l'apparence de votre wiki. En tant qu'utilisateur disposant de droits d'administration, suivez les instructions ci-dessous sur votre wiki :

Étapes pour remplacer un template de la skin

  1. Allez à l'administration, dans la section "Apparence" > "Thèmes" (Look & Feel > Themes)
  2. Sélectionnez le nom de la skin à modifier (par défaut : Default XWiki Skin).
  3. Cliquez sur "Personnaliser". Vous obtiendrez la page d'édition de la skin.
  4. Allez à la section "Templates de replacement".
  5. Saisissez le nom du modèle que vous souhaitez remplacer : dans ce cas, layoutExtraVars.vm. En écrasant ce fichier .vm, vous pouvez sans risque remplacer les variables de mise en page qui se trouvent dans layoutvars.vm.
  6. Ensuite, écrivez le nouveau code dans la section réservée au contenu. Dans ce cas, le code ajoutera quelques restrictions concernant les personnes qui pourront voir le menu "Plus d'actions" :
## Hide More Action Menu if the user not an admin
#set($currentUserGroups = $services.user.group.getGroups($xcontext.user, 'xwiki', $true))
#set($userGroupReference = $services.model.createDocumentReference('xwiki', ['XWiki'], 'XWikiAdminGroup'))
#if (!($currentUserGroups.contains($userGroupReference) || $hasAdmin))
  #set($displayMoreActionsMenu = false) ## more actions menu
  #set($displayAdminMenu = false) ## the admin menu, related to the page
#end
N'oubliez pas d'enregistrer les modifications.

En savoir plus sur les skins XWiki

Apprenez à gérer ou à développer de nouvelles skins XWiki.
 

J'espère que vous avez apprécié ce court tutoriel et que maintenant la personnalisation de votre wiki vous semble plus facile.
Que souhaitez-vous personnaliser sur votre wiki ?

ESSAYEZ XWIKI GRATUITEMENT


1 Les étapes permettant de supprimer le menu "Plus d'actions" ont été décrites à l'origine dans la FAQ de la communauté XWiki.

Articles similaires :