Créer un site associatif avec XWiki

L'installation de XWiki dans Tomcat est très simple. Une fois votre Tomcat téléchargé et installé, il suffit de décompresser le fichier xwiki-1.0.war dans le répertoire %TOMCAT_HOME%\webapps\xwiki. Dans le reste du tutoriel, ce répertoire sera nommé %XWIKI_HOME%.

XWiki stocke ses pages dans une base de données. Il faut donc que vous ayez téléchargé et installé MySQL. Il vous faut ensuite créer une base pour XWiki. Pour cela :

• démarrez MySQL (mysqld --console) ;
• créez la base de données xwikiDB en tapant la commande mysql --user=root --execute=« create database xwikiDB » ;
• donnez les droits d'accès à l'utilisateur xwikiUser (mot de passe xwikiPwd) sur la base de données xwikiDB en tapant la commande mysql --user=root --execute=« grant all privileges on xwikiDB.* to xwikiUser@localhost identified by 'xwikiPwd' » ;
• vérifiez que la base de données xwikiDB a bien été créée en tapant mysql --user=root --execute=« show databases ».

XWiki utilise Hibernate comme moteur de persistance. Il faut donc lui fournir tous les paramètres de connexion à la base de données xwikiDB. Pour cela, modifiez le fichier %WIKI_HOME%\WEB-INF\hibernate.cfg.xml.

<property name="connection.url">jdbc:mysql://localhost/xwikiDB?useServerPrepStmts=false</property>
<property name="connection.username">xwikiUser</property>
<property name="connection.password">xwikiPwd</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="dialect">org.hibernate.dialect.MySQLDialect</property>

Il ne nous reste plus qu'à démarrer Tomcat (%TOMCAT_HOME%\bin\startup.bat) et nous rendre à l'URL http://localhost:8080/xwiki. Une première page s'affiche sur votre navigateur vous informant que l'installation de XWiki est imminente.

Il vous suffit de cliquer sur le lien « XWiki Home Page » et d'attendre un petit moment, le temps qu'Hibernate crée les tables dont XWiki a besoin. Si vous voulez voir la liste des tables créées, tapez la commande suivante : mysql --user=xwikiUser --password=xwikiPwd --database=xwikiDB --execute=« show tables ».

Ça y est, XWiki est configuré et la page d'accueil par défaut s'affiche :

Cette page vous indique que le wiki est prêt à l'emploi, mais qu'il est vide, c'est-à-dire qu'il ne contient ni page ni utilisateur, charge à vous de les créer. Pour se faciliter la tâche, il est préférable d'importer l'archive xwiki-1.0.xar qui permet de charger un ensemble de pages par défaut.

XWiki utilise des fichiers d'extension xar (XWiki Archive) pour exporter et importer ses pages. Le fichier xwiki-1.0.xar, que vous avez téléchargé auparavant, contient des utilisateurs (admin, guest…) et des modules standards (possibilité de rechercher des pages dans le wiki, d'obtenir des statistiques de consultation des pages, d'organiser les blogs et photos…). Pour pouvoir importer ces pages, cliquez sur le lien « Administration » (http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences) puis sur l'onglet « Import ». Dans la section « Upload a new archive to import », sélectionnez le fichier xwiki-1.0.xar que vous avez téléchargé et cliquez sur « Attach this file ». Ensuite, dans la section « Available files to import » cliquez sur le lien « xwiki-1.0.xar ». La section « Available documents to import » vous affiche la liste des documents que vous pouvez importer. Décochez ceux qui ne vous intéresseraient pas (par exemple les pages Sandbox qui sont utilisées pour se familiariser avec XWiki), ou sinon importez la totalité en cliquant sur le bouton « Import » qui se trouve tout en bas de la page.

Comme vous pouvez vous en douter, la page d'accueil par défaut de XWiki ne convient pas à l'association. Elle souhaite donc en modifier le contenu et créer de nouvelles pages. Mais avant de nous lancer dans cet exercice, il nous faut définir certains concepts importants de XWiki :

• une page. Tout est page dans XWiki. La page est l'élément que l'on crée, met à jour, supprime et que l'on organise. Pour en modifier le contenu, XWiki vous permet d'utiliser un éditeur WYSIWYG ainsi qu'un éditeur en mode texte utilisant les macros Radeox pour la mise en page (par exemple 1, 1.1, 1.1.1 pour les niveaux de titres, *gras* pour mettre en gras du texte…) ;
• Espace (space). Un espace regroupe des pages (un peu comme un répertoire contenant des fichiers). Il peut être utile de répartir ses pages dans des espaces différents pour mieux les retrouver, mais aussi pour avoir des accès différents. Par exemple, comme nous le verrons plus bas dans ce tutoriel, nous allons créer un espace privé, c'est-à-dire un espace dont le contenu est uniquement accessible par l'administrateur. Toute page associée à cet espace, partage ses droits. L'espace par défaut est Main, celui de l'administration est XWiki et ainsi de suite ;
• Panneau (panel). C'est une page qui peut être rajoutée dans une des colonnes du wiki (navigation, recherche…).

Pour créer de nouvelles pages, il existe différents moyens.

• Utiliser le panneau « New Page » (http://localhost:8080/xwiki/bin/view/Panels/NewPage), qui se trouve par défaut en bas à droite du wiki.
• Éditer une page, insérer un lien [xxx] (notez qu'un lien en Radeox se définit par un texte, ici xxx, entre crochets []) vers une page inexistante, enregistrer cette page puis cliquer sur le lien xxxx. XWiki se chargera alors de créer cette nouvelle page.
• Vous pouvez aussi changer l'URL de la page en cours et rajouter un nom de page (XXX par exemple) http://localhost:8080/xwiki/bin/view/Main/XXX. Vous aurez alors la possibilité de créer la page XXX.

Tout d'abord, commençons par modifier le contenu de la page principale. Par défaut, pour modifier ou créer des pages dans XWiki, il faut se connecter avec un utilisateur ayant ces droits. Pour l'instant, utilisons l'utilisateur d'administration par défaut. Dans le menu d'accès, cliquez sur Log-in et saisissez le user Admin (A majuscule) et mot de passe admin (a minuscule). La barre d'action s'enrichit alors d'un menu « Edit ». Cliquez dessus. Vous tomberez alors sur une page spéciale qui contient plusieurs onglets. Deux de ces onglets peuvent être utilisés pour modifier la page : « WYSIWYG » et « Wiki » (syntaxe radeox). Vous pouvez maintenant supprimer le texte par défaut et saisir une page d'accueil pour l'association de la Commune Libre d'Aligre.

Si vous utilisez la syntaxe wiki (onglet Wiki), notez le panneau d'aide « XWiki syntax help » sous forme d'accordéon vous permettant de vous déplacer dans plusieurs menus (Titles, Paragraph, Emphasizing, Links…) et d'utiliser les macros Radeox appropriées. Cliquez sur « Save & View », voilà, votre page d'accueil est modifiée.

Comme vous pouvez le constater, l'éditeur comporte quatre boutons :

• Cancel : annule les modifications que vous auriez pu apporter à la page ;
• Preview : ne sauvegarde pas la page, mais permet de la visualiser ;
• Save & Continue : sauvegarde la page et vous permet de continuer à l'éditer ;
• Save & View : sauvegarde la page et l'affiche.

Ensuite, nous allons créer un panneau qui nous permettra de naviguer dans les pages. Pour cela, allez à la page affichant tous les panneaux disponibles (http://localhost:8080/xwiki/bin/view/Panels/) et dans la section « Create new panels » saisissez « MenuCLA » (le nom du panneau) puis cliquez sur « Create ». Apparaît alors un écran vous demandant de saisir les informations de ce panneau. Dans « category » choisissez « navigation » saisissez le texte suivant dans « content ».

#panelheader('Menu')
* [Agenda]
* [Agora]
* [Café associatif]
* [Cinémaligre]
* [L'Aligresse]
* [L'Association]
* [Les activités de nos amis]
* [Manifestations passées]
#panelfooter()

Ce texte utilise les macros Radeox pour la mise en page. Chaque ligne débutant par un caractère « * » se transforme en une liste à puce et le texte entre crochets devient un lien vers une page. Les macros Velocity #panelheader et #panelfooter permettent de rajouter un titre ou un bas de page au panneau. Notez que la page MenuCLA que nous venons de créer se trouve dans l'espace Panels (l'espace par défaut contenant tous les panneaux). Le nom complet de cette page est donc Panels.MenuCLA.

Pour rajouter ce panneau dans la colonne de gauche, il faut aller dans les préférences de XWiki (http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences) et modifier la présentation (onglet « skin »). Rajoutez « Panels.MenuCLA » dans « Left Panel » et sélectionnez « Yes » dans « Show Left Panel ». Cliquez sur « Save & View ».

Si vous retournez vers la page d'accueil, vous verrez le panneau Menu dans la colonne de gauche. Notez que les liens se terminent par le symbole . Cela signifie que le lien pointe vers une page inexistante. Pour la créer, il vous suffit de cliquer sur ce lien. XWiki se charge de créer la page, de la rajouter dans l'espace courant (c'est-à-dire Main) et d'afficher l'éditeur WYSIWYG pour en modifier le contenu. Charge à vous de saisir le contenu de toutes ces pages.

Le président de l'association est en fait l'administrateur du site. Il est le seul à pouvoir créer de nouveaux utilisateurs et à administrer le site. Pour créer ce nouvel administrateur, cliquez sur Administration dans le menu d'accès, puis sur l'onglet « Users & Groups » et enfin sur le lien « the users page » puis Register. Ce formulaire nous permet de créer l'utilisateur « Le président » (login Lepresident) et comme mot de passe « monsieur ».

Il faut ensuite l'ajouter dans le groupe des administrateurs. Pour cela retournez dans le menu d'administration en cliquant sur Users & Groups puis sur le lien the groups page. Cette page affiche tous les groupes disponibles dans le wiki. Sélectionnez XWiki Admin Group puis cliquez sur l'icône en forme de crayon (après le titre Members) pour éditer le contenu de la page. Le groupe XWikiAdminGroup contient les administrateurs du wiki.

Rajoutez l'utilisateur XWiki.Lepresident (XWiki est le nom de l'espace, Lepresident le nom de l'utilisateur) et cliquez sur « Save & Continue ». Déconnectez-vous en cliquant sur « Log-out » (souvenez-vous que vous êtes toujours connecté en tant qu'Admin) puis reconnectez-vous en tant que président (Lepresident/monsieur). Profitez-en pour supprimer l'administrateur par défaut (Admin) qui a été importé (allez à l'adresse http://localhost:8080/xwiki/bin/view/XWiki/Admin puis cliquez sur le lien Delete de la barre d'action).

Le président a le droit d'administrer (admin) le site, de créer/mettre à jour/supprimer (edit, delete) des pages, de rajouter des commentaires (comment) et il est le seul à pouvoir créer de nouveaux membres (register). On peut maintenant modifier légèrement son profil (http://localhost:8080/xwiki/bin/view/XWiki/Lepresident) en le passant en mode avancé (cliquez sur « Switch to Advanced edit mode ») et en rajoutant l'URL de son blog et sa photo.

Les membres du conseil sont enregistrés dans le wiki par le président de l'association dans le groupe XWikiAllGroup. Ils ont les droits de créer/mettre à jour/supprimer (edit, delete) des pages et de rajouter des commentaires (comment). Il faut auparavant enregistrer ces nouveaux utilisateurs (http://localhost:8080/xwiki/bin/register/XWiki/Register) (Annie, Daniel, Cécile) qui seront automatiquement rajoutés au groupe XWiki All Group. Le groupe XWikiAllGroup représente le groupe de tous les utilisateurs du wiki possédant un compte et pouvant se connecter

Par contre, l'association a besoin d'un espace privé dans lequel uniquement le président et les membres peuvent travailler de manière collaborative. Pour cela il faut tout d'abord créer un nouvel espace que vous nommez « Private ».

Après avoir cliqué sur « Create », un éditeur vous permet de saisir du texte pour la page principale de cet espace. Les pages que l'on créera dans cet espace devront être préfixées par le nom de cet espace : « Private » (Private.Budget, Private.Subventions…).

Il faut ensuite se rendre dans l'administration pour modifier les droits d'accès et interdire la lecture de ces documents aux internautes. Cliquez sur l'onglet « Space Rights » et sectionnez « Private ». Ajoutez un droit d'accès en cliquant sur le bouton « Add Access Right Entry » et sélectionnez l'utilisateur XwikiGuest, l'action view et deny.

XWiki vient avec trois skins différents qui se trouvent dans le répertoire %XWIKI_HOME%\skins. Chacun porte un nom d'oiseau, le défaut étant albatross. Vous pouvez en avoir un rapide aperçu en rajoutant à la fin de chaque URL ?skin= et le nom du skin. Ainsi, la page d'accueil peut se décliner en trois différents look&feel.

• Albatross : http://localhost:8080/xwiki/bin/view/Main/WebHome?skin=albatross
• Dodo : http://localhost:8080/xwiki/bin/view/Main/WebHome?skin=dodo
• Finch : http://localhost:8080/xwiki/bin/view/Main/WebHome?skin=finch

Pour utiliser de manière définitive la skin « finch » par exemple, il suffit d'aller dans les préférences de l'administration et, dans l'onglet skin, saisir le texte « finch » dans la zone « Skin ». Sauvegardez, vous devriez voir votre site se transformer.