Extension:StructuredDiscussions/fr

L'extension StructuredDiscussions fournit un système de forum et de collaboration pour les pages de discussion. Cette page décrit comment installer et administrer les discussions structurées; si vous cherchez un guide sur la manière de les utiliser, voyez plutôt. Vous pouvez essayer les discussions structurées par vous-même sur la page de discussion du bac à sable (sandbox).

Cette extension était connue auparavant comme Flow, et ce nom à plusieurs endroits (comme le dépôt Git) la représente encore.

L'extension StructuredDiscussions a été développée par l'équipe Collaboration de la Fondation Wikimedia. Il est encore maintenu pour la correction de bogues, mais il n'y a pas eu d'autres développements substantiels sur l'extension depuis 2015, qu'un renommage en StructuredDiscussions en septembre 2017. Pour obtenir davantage d'informations concernant l'état du développement de cette extension ainsi qu'un aperçu sur son architecture, voir Structured Discussions.

Installation


Après l'installation
Assurez-vous de bien suivre les instructions complètes pour activer ou désactiver StructuredDiscussions, y compris les scripts mentionnés ici.

Dépendances

 * nécessaire
 * - pour les notifications (c'est à dire les réponses à vos billets)
 * Il est nécessaire d'avoir un cache d'objets et d'utiliser memcached pour cela. Actuellement, il est possible que vous ayez des problèmes avec Redis.
 * - pour les modèles installés automatiquement (par exemple #time)
 * Nécessaire pour Special:EnableStructuredDiscussions et pour éviter la corruption si vous changez le modèle de contenu des espaces de noms (pour ou contre les discussions structurées) s'il existe déjà des pages dans cet espace de noms.


 * très recommandé


 * Parsoid pour l'option permettant d'entregistrer les billets en tant que HTML pour améliorer les performances. Ceci est la manière dont les wikis de la Fondation WikiMedia sont configurés, et par là, c'est la configuration la plus testée. Si vous utilisez MediaWiki-Vagrant, l'activation StructuredDiscussions autorise Parsoid et fixe le format à 'html'.


 * facultatif


 * - si vous voulez utiliser la fonctionnalité bêta de souscription aux discussions des utilisateurs.
 * - pour les horodatages en clair sous forme littérale tels que « il y a 3 jours »
 * - pour la prise en charge de VisualEditor
 * un bogue ? si l'Editeur Visuel est présent, (peut être pour fournir OOUI), alors les Discussions structurées essayeront de contacter Parsoid même si l'Editeur Visuel n'est pas activé
 * StructuredDiscussions peut s'intégrer avec, , et , voir
 * StructuredDiscussions va s'intégrer avec si vous l'avez installé.
 * - pour remercier les utilisateurs pour leurs billets



Vérifier l'installation
Ouvrez une des pages que vous avez activées pour les discussions structurées (voir ) et essayez d'ajouter un article et de modifier son titre.

Configuration
Voici quelques paramètres à définir dans.



Activer ou désactiver StructuredDiscussions
Pour activer ou désactiver les discussions structurées pour un espace de noms donné dans MediaWiki avant la 1.35, exécutez d'abord sur les espaces de noms concernés (ou vous pouvez le faire sur  ). Depuis la 1.35, ceci n'est plus nécessaire. Par exemple si vous voulez l'activer ou le désactiver sur NS_TALK (1) et NS_USER_TALK (3) comme indiqué dans la configuration PHP ci-dessous :

Si mwscript n'est pas configuré, remplacez  par

Après ce qui précède, initialisez  pour les espaces de noms particuliers. Par exemple :

Ne réassignez pas la variable globale.

Pour l'activer sur la même page, utilisez Special:EnableStructuredDiscussions. Ceci nécessite d'avoir les droits flow-create-board qui peuvent être attribués à tout groupe (voir Modifier les privilèges de groupe).

Voir pour savoir comment désactiver toutes les pages StructuredDiscussions sur votre wiki.



Configuration Parsoid
StructuredDiscussions utilise le service Virtual REST pour contacter un service Parsoid ou RESTBase. Si votre wiki charge l'extension, alors il se peut que cela soit probablement déjà configuré. Cherchez ce qui suit dans votre  :

Un unique serveur Parsoid peut gérer plusieurs wikis. Le paramètre  de Parsoid identifie la configurations de votre wiki pour Parsoid. Par défaut il vaut le nom de l'hôte appelé par, mais vous pouvez utiliser une chaîne de caractères quelconque. Les versions plus anciennes de Parsoid utilisaient également un préfixe unique pour identifier le serveur; vous devriez lister cela ici également.

Parsoid doit être configuré pour pouvoir trouver, en utilisant une ligne dans  de Parsoid telle que :

De nouveau, la propriété domain est faculatative pour configurer Parsoid; quand il n'est pas spécifié, la valeur par défaut est le nom de l'hôte utilisé dans la propriété. La propriété préfixe peut également être omise à moins que vous n'exécutiez une ancienne version de Parsoid. Assurer vous que le  et   listés dans les résultats   de Parsoid, correspondent à ce qu'il y a dans le   de votre wiki.

Voir Parsoid/Setup#Configuration pour plus de détails.



« Nombre maximum d'imbrications de 100 fonctions atteint, abort »
Si vous obtenez cette erreur, vous devez initialiser, probablement dans.



« Récupération d'exception : CAS non implémenté dans Xyz »
StructuredDiscussions invoque et quelques implémentations du cache incluant   (APCBagOStuff) n'implémentez pas CAS. Vous devrez probablement utiliser un cache différent, par exemple installer memcached et définir.

Droits
Les utilisateurs doivent avoir les droits  sur le noyau pour réaliser des opérations d'écriture dans StructuredDiscussions. Beaucoup de wiki n'attribuent ces droits que pour le groupe 'user' (connectés).

StructuredDiscussions définit plusieurs actions telles que  et   (voir la liste dans ). Les droits varient en fonction du billet, s'il est à vous et s'il a été modéré. Par exemple, les utilisateurs peuvent modifier leurs propres billets par défaut, mais uniquement les utilisatuers du groupe 'sysop' ont les droit  qui autorise à modifier les billets des autres utilisateurs. Vous pouvez réécraser les droits et les groupes auquels ils ont été affectés pour chaque action Flow; voir les pour un aperçu des autorisations.



Migrer les pages existantes
Pour migrer une page existante unique, utilisez Special:EnableStructuredDiscussions. Cela prendra en charge l'archivage des pages uniques (puis activera automatiquement StructuredDiscussions).

Le script  automatise cette conversion d'espace de noms ainsi que l'archivage, voir Flow/Converting talk pages. C'est un peu particulier à la Fondation WikiMedia, donc évaluez son opération et sauvegardez votre base de données avant d'exécuter. Un autre script  convertit les pages LiquidThreads avec leurs fils de discussion en tableaux Flow avec les titres, voir Flow/Converting LiquidThreads. Les mises en garde similaires s'appliquent.

Flow ajoute un espace de noms Topic:, voir Extension default namespaces. Vous pouvez aller sur Special:PrefixIndex/Topic: pour voir s'il y a des pages existantes en conflit avec cela; si c'est la cas, exécutez le script de maintenance.

Configuration


Messages système
Si vous utilisez l'option Modifer le source sur les tableaux StructuredDiscussions, vous pourrez voir le texte d'aide. La partie utilise le marquage est liée à MediaWiki.org par le message système MediaWiki:Flow-wikitext-editor-help-uses-wikitext qui utilise un lien interwiki.

Dans quelques cas, ce lien interwiki, au lieu de pointer vers sur MediaWiki.org, pointe vers une page Help:Formatting (habituellement non existante) du wiki hôte. Ceci peut être corrigé en modifiant le lien interwiki sur MediaWiki:Flow-wikitext-editor-help-uses-wikitext vers un lien externe tel que.

Résolution des problèmes
Flow n'apparaît pas comme désiré ? Il existe différentes corrections en fonction de la source du problème.



Parsoid mal configuré / Editeur Visuel ne fonctionne pas
Si vous voyez des messages du type  , il est possible que parsoid ne soit pas correctement configuré. Pour pouvoir utiliser l'Editeur visuel dans les discussions, cette extension nécessite que Parsoid soit correctement configuré.

Faites ceci :
 * 1) Assurez-vous d'avoir bien installé Parsoid.
 * 2) Tant que ce bogue ne sera pas résolu, appliquez ce patch à la base de code  StructuredDiscussions.

Si le problème persiste, cette discussion peut vous aider.



Ordre incorrect de déclaration des espaces de noms personnalisés
Les déclarations de Flow doivent être placées après les déclarations des espaces de noms personnalisés. L'ordre correct est :



Constantes natives incorrectes
Les pages de discussion dans l'espace de noms principal Main: sont définies par, et non pas

La déclaration correcte est :

$wgNamespaceContentModels[NS_TALK] = 'flow-board';



Constantes d'extension non enregistrées
La constante représentant l'espace de noms est supposée être. Mais cette constante ne fonctionne pas dans la déclaration Flow -- vous devez utiliser le nombre actuel : 107. Ceci fonctionne :

$wgNamespaceContentModels[107] = 'flow-board';

L'utilisateur n'est pas informé si Page_Forms a échoué pendant l'enregistrement de ses constantes, ou si toutes les extensions doivent utiliser des nombres (et non des constantes) avec Flow. Voyez la liste de quelques constantes associées à d'autres espaces de noms d'extensions.



Anciens vestiges
Si Flow se présente correctement sur toutes les pages de discussion d'un espace de noms donné, sauf pour une page de cet espace de noms: il peut rester d'anciens éléments sur la page de discussion (même si elle paraît vide). Faites ce qui suit :


 * 1) Affichez la page de discussion qui ne charge pas Flow, par exemple : Portal_Talk:Welcome
 * 2) Supprimer la page de discussion en utilisant l'onglet Supprimer.
 * 3) Aller sur la page de contenu de cette page de discussion, par exemple : Portal:Welcome
 * 4) Cliquer sur Discussion.
 * 5) Vous obtenez Flow.

Architecture
Voir Flow/Architecture.

Contenus indésirables (spam)
Voir pour d'autres informations sur la manière de combattre le pourriel dans Flow.

Modération
Voir pour davantage d'informations sur la modération dans Flow.



Exporter et importer
Un script de maintenance existe pour exporter les données Flow de manière semblable à Manual:DumpBackup.php

- fournit quelques indications concernant l'import.