Wikipédia:Wikiforum

meta | fr |

Wikiforum est une extension pour MediaWiki (1.4) émulant les fonctions basiques d'un forum de discussion en utilisant le système Wiki. Le but est d'offrir à la communauté un moyen simple de centraliser les discussions et de remplacer le Bistro par un système autogéré.

Présentation

WikiForum est une page spéciale accessible via le menu " Boîte à outils", " Pages spéciales" puis "Forum" (ce lien n'existe que si l'extension a été installée). À l'image du Bistro de Wikipédia, WikiForum est composé de deux parties :

• le contenu des X dernieres discussions,
• un lien vers Y discussions plus anciennes (l'équivalant des « discussions déplacées » du Bistro).

Comme le Bistro, WikiForum est rangé dans un ordre chronologique avec les discussions les plus récentes en bas de page. Par contre, contrairement au Bistro, WikiForum range les discussions dans l'ordre de leur dernière modification et non pas par rapport à leur date de création (ce qui est faisable mais demanderait de remonter l'historique de chaque discussion, ce qui chargerait considérablement les serveurs).

Fonctionnement

Contrairement au Bistro, les discussions n'ont pas lieu directement sur la page du forum, mais dans des pages "sujet" (thread). La grosse différence avec le Bistro réside dans le fait que le forum n'a plus besoin d'être modifié manuellement, puisqu'il est régénéré automatiquement pour tenir compte de toutes les modifications ayant eu lieu sur les pages "sujet". Les pages "sujet" sont des pages Wiki standard et à ce titre elles peuvent être ajoutées à votre liste de suivi, porter des catégories, être déplacées, etc.

Créer un nouveau sujet de discussion

Pour créer un nouveau sujet de discussion, il suffit de se rendre sur la page du forum et de cliquer sur le lien "créer un nouveau sujet". Vous arriverez sur une page vous demandant le titre et le contenu de votre sujet de discussion. Le titre de la discussion doit être unique ; il est donc recommandé de donner un nom précis pour éviter d'avoir un message d'erreur vous demandant d'en choisir un autre. Après avoir validé votre sujet en cliquant sur "créer le sujet", vous pourrez visualiser la page de votre sujet. Comme toute page Wiki, vous pouvez l'éditer pour en modifier le contenu.

Répondre à un sujet de discussion

Si le sujet est dans le tableau du forum sous forme de lien, cliquer sur le lien pour accéder à la page et la modifier comme vous le feriez pour n'importe quelle autre page Wiki. Si le corps du sujet est "inclus" dans le forum, cliquer sur le lien "modifier" à côté de son titre pour accéder directement à la fenêtre d'édition du sujet.

Installation

1. Installer la version 1.4 de MediaWiki.
2. Récupérer les sources et les copier par-dessus la version de MediaWiki.
3. Ajouter dans son fichier "LocalSettings.php"

define('NS_THREAD', 110); // ou toutes valeurs supérieur à 100
require_once( "extensions/wikiforum.php" );

Options

On peut changer les valeurs par défaut du « forum » avec les options suivantes (à ajouter dans le même fichier après le require_once()) :

Nombre total de sujets traités sur la page du forum

// Set the total number of threads
$wgForum->SetThreadNumber(50); 

La valeur par défaut est de 50 mais peut être de n'importe quelle valeur. Si cette valeur est supérieur au nombre total de sujets dans la base de donnée, la valeur sera automatiquement réajustée.

Nombre total de sujets directement inclus sur la page du forum

// Set the total number of full included threads    
$wgForum->SetIncludeNumber(20);

Il s'agit du nombre de sujets dont le contenu est directement inclus dans le forum (comme des modèles). Cette valeur est forcément comprise entre zéro et le nombre total de sujets traités (voir ci-dessus). Les sujets non-inclus directement dans la page sont affichés dans le tableau avec les sujets les plus récents en bas.

• Si la valeur vaut zéro, tous les sujets sont uniquement présents dans le tableau.
• Si la valeur est égale au nombre total de sujets traités, tous les sujets seront directement inclus dans la page du forum.
• Si la valeur est supérieure au nombre total de sujets traités (ce qui est illogique), la valeur sera automatiquement réajustée.

Nombre total de sujets directement inclus sur la page du forum

// Set the maximum length of summary into threads table   
$wgForum->SetSummaryMaxLength(10);

Cette valeur permet de limiter la taille des commentaires dans le tableau récapitulatif des derniers sujets. Si la longueur d'un commentaire dépasse le nombre de caractères maximum choisi, le commentaire est tronqué. Si cette valeur vaut zéro, aucune limite n'est appliquée.

Historique des modifications

1.0.1

• première version.

1.0.2

1.0.3

1.0.4

• corrections de tous les bugs connus (le problème des titres finissant par un point vient de ma configuration Apache et non pas de MediaWiki),
• ajouts d'un deuxième tableau qui sert de menu pour les sujets inclus,
• ajouts d'une gestion des langues (pour l'instant français, anglais, japonais).

1.0.5

• ajout d'une option pour afficher/cacher les sujets,
• ajout d'un lien direct au forum dans la barre de navigation,
• ajout du bulgare et du chinois.

1.0.6

• séparation des sujets liés et des sujets inclus en deux pseudo-tableaux
• ajout test localié pour l'icone montrer/cacher
• mise à jour des fichiers de langue

À faire

1. Pas de limite pour les commentaires. Si SummaryMaxLength est égale à zéro, ne pas limiter la taille des commentaires.
2. Ajouter des balises CSS pour afficher/cacher individuellement chaque partie.
3. Dans le tableau, ajouter un lien pour éditer directement le sujet.
4. Nouvelle présentation : Inclure le contenu des articles dans le tableau avec un show/hide.
5. Retour au forum : Ajouter un lien en haut d'un fil de discussion (bien que le lien vers le forum pourrait être dans la barre d'outil).
6. Retirer la page de discussion des threads.

Problèmes connus

1. Validation des titres : La validation n'étant pas fait lors de la création d'un fil de discussion, on peut créer un fil sous un nom invalide (qui souvent, ne sera pas éditable).
2. Le contenu d'un thread ne s'affiche pas si le titre fini par un point.
3. La mise en majuscule de la premier lettre pose problème si le premier caractère est Unicode (simple à corriger).
4. Problème avec la version en développement de MediaWiki (suite à un changement dans la structure de base de donnée) => A corriger des qu'une version stable de MediaWiki 1.5 est disponible.

Licence

Copyright 2004 Guillaume Blanchard sous licence libre GNU General Public License.

Remerciement

• à Amgine pour héberger gracieusement le serveur de test de Wikiforum,
• à Guillaumito pour la première version de la page de création des sujets,
• aux développeurs de MediaWiki pour leurs conseils (notamment Brion et Tim Starling),
• aux wikipédiens qui ont aidé à traquer les bugs et ont apporté un soutien moral ;o)