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 auparavent 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. Le développemnt peut éventuellement reprendre à l'avenir. 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.

Vagrant
La manière la plus facile d'installer StructuredDiscussions localement, est d'utiliser l'appareil MediaWiki-Vagrant et d'activer son rôle flow. Ceci n'est prévu que pour les tests du développemt et les tests locaux.

Manuel
Pour installer cette extension manuellement :

Après l'installation
You also need to run the command "composer update --no-dev" from the command line, on the folder where MediaWiki is installed, even if you don't download from git.

Make sure you follow the full instructions for enabling or disabling StructuredDiscussions, including the scripts mentioned there.

Dépendances

 * nécessaire


 * - pour les notifications (c'est à dire les réponses à vos billets)


 * It is required to have an object cache. It is recommended that you use memcached for this.  You may encounter problems with Redis currently.


 * - pour les modèles qui sont installées automatiquement (par exemple #time)
 * = true  Required for Special:EnableStructuredDiscussions and to avoid corruption if you change the content model of namespaces (towards or away from StructuredDiscussions) if there are already pages in that namespace.
 * très recommandé


 * Parsoid for the option to store posts as HTML which improves performance. 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


 * bug? if you have the VisualEditor present (e.g. perhaps to provide OOUI),then StructuredDiscussions will attempt to contact Parsoid even if VE is not enabled


 * StructuredDiscussions can integrate with, , and , see


 * StructuredDiscussions va s'intégrer avec si vous l'avez installé.


 * - pour remercier les utilisateurs pour leurs billets


 * - pour l'analyse

Vérifier l'installation
Visit one of the pages you enabled for StructuredDiscussions (see ) and try adding a topic and editing its header.

Mise à jour
La variable, qui énumère les tableaux  StructuredDiscussions, a été supprimée conformément à T105574. Avant de mettre à jour vers la version 1.26 ou ultérieur, exécutez les scripts de maintenance :

Le premier script fait partie du noyau MediaWiki.

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é, exécutez d'abord sur les espaces de noms concernés (ou vous pouvez le faire sur  ). E.g. if you are about to enable or disable it on NS_TALK (1) and NS_USER_TALK (3) as shown in the PHP config below:

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. This requires the flow-create-board right, which can be granted to any group (see Manual:User rights#Changing group permissions).

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

Configuration Parsoid
StructuredDiscussions uses the Virtual REST Service to contact a Parsoid or RESTBase service. If your wiki loads the extension, then you've probably already set this up. Look for the following in your :

A single Parsoid server can handle multiple wikis. The Parsoid  setting identifies your wiki configuration to Parsoid. By default it is set to the hostname named by, but you can pick an arbitrary string. Older versions of Parsoid also used a unique "prefix" to identify the server; you may need to list that here as well.

Parsoid must have been configured to match, using a line in Parsoid's  like:

Again, the "domain" property is optional in the Parsoid configuration; it defaults to the hostname used in the  property if not specified. The "prefix" property can also be omitted unless you are running an older version of Parsoid. Make sure the  and   listed in Parsoid's   match what's in your wiki's.

See Parsoid/Setup for more details.

« Nombre maximum d'imbrications de 100 fonctions atteint, abort »
If you get this error, you need to set, probably in.

« Récupération d'exception : CAS non implémenté dans Xyz »
StructuredDiscussions invokes  and some cache implementations including   (APCBagOStuff) don't implement CAS. You probably need to use a different cache, for example install memcached and set.

Droits
Users must have the core  permission to perform any write action in StructuredDiscussions. Many wikis only grant this permission to the 'user' (logged-in) or 'autoconfirmed' group.

StructuredDiscussions defines many actions such as  and   (see the list in ). The permissions vary depending on whether the post is your own and whether it has been moderated. For example, by default users can edit their own posts, but only users in the 'sysop' group have the  permission to edit anyone's post. You can override which groups have which permissions and what permissions are required for each Flow action; see Manual:User rights for an overview of permissions.

Migrer les pages existantes
To migrate a single existing page, use Special:EnableStructuredDiscussions. It will handle archiving of a single page (then enabling StructuredDiscussions) automatically.

The script  automates this namespace conversion and archiving, see Flow/Converting talk pages. It is somewhat WMF-specific, so evaluate its operation and backup your database before running it. Another script  converts LiquidThreads pages and their threads to Flow boards and topics, see Flow/Converting LiquidThreads. Similar caveats apply.

Flow adds a Topic: namespace, see Extension default namespaces. You can visit Special:PrefixIndex/Topic: to see if there are existing pages that conflict with this; if so run the maintenance script.

Messages système
Using the "Source editing" option on StructuredDiscussions boards makes visible the help text. The "uses markup" part is linked through the system message MediaWiki:Flow-wikitext-editor-help-uses-wikitext which makes use of an interwiki link to MediaWiki.org.

In some cases, this interwiki link, instead of pointing to on MediaWiki.org, points to a (usually non-existent) Help:Formatting page on the host Wiki. This can be corrected by changing the interwiki link on MediaWiki:Flow-wikitext-editor-help-uses-wikitext to an external link such as.

Résolution des problèmes
Flow n'apparaît pas comme désiré ? There are different fixes, depending on the source of the problem:

Ordre incorrect de déclaration des espaces de noms personnalisés
The Flow declares must go after the declare for a custom namespace. 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';

It's unknown to this author whether Page_Forms failed to register its constants correctly, or whether all extension must use numbers (not constants) with Flow. Voyez la liste de quelques constantes associées à d'autres espaces de noms d'extensions.

Anciens vestiges
If you're correctly getting Flow on all talk-pages in a namespace, except for one page in that namespace, there may be remnant junk in the talk page (even if it appears empty). 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

T114703 - fournit quelques indications concernant l'import.