Xwiki Manuel Administrateur

XWikiManuel Administrateur

Novembre 2011

3ème Edition

2

PréambulePréambule

• Cette présentation est basée sur l’outil XWiki version 2.7.2

• Les copies d’écran inclues dans cette présentation utilisent le rendu par défaut du produit (la skin colibri). Le paramétrage de votre environnement peut modifier de manière sensible l’aspect visuel de votre wiki mais les fonctions sont identiques.

• Certaines procédures décrites correspondent à une configuration particulière du produit XWiki, elles peuvent donc ne pas s’appliquer à votre installation.

3

La Ferme XWikiLa Ferme XWiki

XWiki et le multi-instance

Le produit XWiki permet de gérer une ferme de wiki. Ceci permet d’héberger de nombreux wikis sur un même serveur. Chaque wiki est indépendant, vous êtes administrateur de votre wiki.Il existe un wiki «principal» qui gère l’ensemble de la ferme.Ceci impose tout de même quelques contraintes.

Caractéristique de la ferme

La ferme est connectée à l’Active Directory. La gestion des utilisateurs (leur profil) est centralisée dans le wiki principal. La ferme fonctionne en mode «domain». C’est au début de l’url que le nom du wiki est spécifié.http://welcome.server.com/bin/view/Main/

4

Droits d’accèsDroits d’accès

• Configuration par défaut– A la création, votre wiki est visible par tout le monde.– Tous les utilisateurs connectés peuvent le modifier.– Il est interdit de s’inscrire soi-même.

• Gestion des droits– Les droits sont

• Voir : lire une page• Commentaire : écrire un commentaire sur une page• Editer : modifier le contenu d’une page• Supprimer : mettre une page à la corbeille• Administrer : gérer le wiki ou un espace• Enregistrer : possibilité pour un utilisateur de se créer son propre

compte, désactivée sur la ferme

– Les droits s’appliquent à : une Page > un Espace > le Wiki

5


6


3 positions possibles :– coché = autorisé

– blanc = non spécifié, le niveau supérieur puis le défaut s’applique

– barré = refusé

7

Groupes et utilisateursGroupes et utilisateurs

Lien avec l’Active Directory– Seuls les utilisateurs sont reliés à l’AD, pas les groupes.– Tout utilisateur de l’AD peut s’identifier sur la ferme avec son login

(simple) et son mot de passe. La première connexion crée la page du profil de l’utilisateur dans le wiki principal.

Global et Local– Un utilisateur ou groupe défini dans le wiki principal est accessible

à partir de n’importe quel wiki fils. On parle d’un utilisateur ou groupe global.

– Un utilisateur ou groupe défini dans un wiki fils est dit local.

8


Configuration par défaut– Un seul utilisateur et 2 groupes.

Administration des utilisateurs– Le seul utilisateur défini localement est Admin. Le conserver.– Tous les autres sont définis au niveau du wiki principal. Votre liste

d’utilisateurs locaux doit donc rester limitée au seul utilisateur Admin.

– On peut voir la liste des utilisateurs en sélectionnant «Global».– Un utilisateur est représenté par une page de l’espace XWiki.

Ainsi XWiki.dupond est la page contenant le profil de l’utilisateur dont le login est dupond.

– Pour référencer un utilisateur global, on préfixe sa page par « xwiki: ».

9


10


Administration des groupes– C’est en utilisant les groupes que vous allez sécuriser votre wiki.

– Le groupe XWikiAdminGroup est dédié aux administrateurs.

– Le groupe XWikiAllGroup contient la liste de tous les utilisateurs de votre wiki. Ne pas le supprimer.

– Par défaut XWikiAllGroup contient le groupe XWikiAllGroup du wiki principal.C’est pourquoi tous les utilisateurs connectés peuvent éditer votre wiki.

11


Ajouter un utilisateur à un groupe– Par exemple, pour ajouter l’utilisateur global Dupont :

– Sélectionner Global dans la listbox et utiliser l’aide à la saisie pour saisir le login de l’utilisateur.

– L’affichage doublé de xwiki: est un bug connu.

Créer un nouveau groupe– Vous ne pouvez créer que des groupes locaux.– Il suffit de donner un nom (de préférence suffixé par Group).

12

Droits, Groupes et UtilisateursDroits, Groupes et Utilisateurs

Restreindre mon wiki à certains utilisateurs– Dans les droits des utilisateurs, décocher Voir aux utilisateurs non

enregistrés.– Supprimer du groupe XWikiAllGroup le groupe global XWikiAllGroup.– Insérer dedans les utilisateurs globaux souhaités.

Restreindre l’accès d’un espace de mon wiki– Idem, mais se placer au niveau de l’espace.

Ajouter Durand comme administrateur– Ajouter xwiki:XWiki.durand dans le groupe XWikiAdminGroup.

Créer un groupe de commentateurs– Ajouter un groupe «CommentateurGroup». – Dans les droits des groupes, cocher Voir et Commentaire pour ce groupe.– Il reste à ajouter des utilisateurs dans ce nouveau groupe.

13

TemplatesTemplates

Un Template est un modèle de page qui va être proposé à l’utilisateur lors de la création d’une nouvelle page.Exemple : modèle de compte-rendu de réunion

Concrètement, le template est une simple page du wiki rédigée spécifiquement pour servir de modèle.

Pour déclarer un template, il faut définir un TemplateProvider > outil Template de l’Administration du wiki

• Lui donner un nom (de préférence suffixé par Provider)• Donner un nom (libellé descriptif) au modèle• Indiquer le nom de la page à utiliser comme template (sous la forme

Espace.Page, attention il n’y a pas d’assistant à la saisie)• Enfin, on peut restreindre l’usage du template à certains espaces

14

Export et ImportExport et Import

XWiki permet d’exporter l’ensemble du contenu d’un wiki sous la forme d’un fichier xar (Xwiki ARchive).On peut ensuite importer ce fichier xar dans un autre wiki.

Ces fonctions sont accessibles à partir du menu Administration du wiki.

Par défaut, l’export n’inclut pas l’historique du wiki. Si vous le souhaitez, vous pouvez cocher la case Inclure l’historique mais attention au volume.

Import en 2 étapes:•Upload du fichier,•Sélection de l’archive et ImportAvant de cliquer sur Import, on peut sélectionner les pages à importer.

15

PersonnalisationPersonnalisationIl existe plusieurs moyens de personnaliser l’apparence de votre wiki

• Changement du logo• Modification des couleurs• Affichage et disposition des panneaux

16

Changement du logoChangement du logo

• Préparer un fichier logo.png ayant une taille de :– moins de 750 pixels en largeur– approximativement 50 pixels en hauteur

• Afficher la page XWiki.DefaultSkin• Joindre à la page le fichier logo.png

– Un fichier de même nom existe déjà. Votre nouveau logo prendra la version 1.2.

• Rafraîchir la page dans le navigateur, le logo doit apparaître– Une source importante de frustration vient du cache du

navigateur.

17

Modification des CouleursModification des Couleurs• Aller dans le panneau d’administration du wiki• Cliquer sur Presentation

• Trouver la rubrique Thème• Sélectionner un Color theme parmi ceux proposé dans la

listbox puis cliquer sur Enregistrer

• Pour aller plus loin, cliquer sur le bouton Personnaliser juste en dessous de Color theme– Spécifier les couleurs en cliquant sur les petites palettes de

peinture qui apparaîssent en promenant la souris– Ne pas oublier d’enregistrer

18

Les PanneauxLes Panneaux

• Aller dans l’écran d’administration du wiki• Cliquer sur Presentation• Trouver la rubrique Panels• Spécifier les panneaux à afficher en les séparant par des virgules• L’organisateur de panels ne fonctionne pas

Les panneaux sont les blocs qui s’affichent à gauche ou à droite des pages.

Les panneaux les plus utiles sont :Panels.Welcome, Panels.QuickLinks, Panels.TagCloud, Panels.Spaces, Panels.Backlinks, Panels.Recently Modified, Panels.MyRecentModifications, Stats.MostActiveContributors, Stats.MostViewedPages

Un panneau est une page, il est donc possible d’en créer des nouveaux en s’inspirant des existants.La configuration des panneaux peut être faite au niveau de l’espace.

19

Modification des CSSModification des CSS

• Afficher la page XWiki.DefaultSkin et cliquer sur le lien Editer cette skin

• Dans la rubrique style, démarrer par l’inclusion des feuilles CSS d’origine :

@import "microformats.css";

@import "colibri.css"; (ou "toucan.css")

• Ajouter vos styles spécifiques à la suite• Enregistrer la page DefaultSkin• Tester le rendu

– Ne pas oublier de tester dans Internet Explorer

– La page Sandbox.WebHome présente une bonne illustration des différents styles visibles dans une page

Si vous savez ce qu’est une feuille de style CSS, voici comment personnaliser de manière fine votre wiki.

20

Technology

Xwiki Manuel Administrateur