Extension:FlaggedRevs/fr

L'extension Flagged Revisions permet aux contributeurs et aux relecteurs d'évaluer les révisions des articles et de définir ces révisions comme les révisions par défaut affichées lors de la vue normale d'une page. Ceci permet à MediaWiki d'agir plutôt comme un système de gestion de contenu (Content Management System - CMS).

Installation
Suivre les étapes suivantes pour installer FlaggedRevs :


 * Assurez-vous que les codes de hachage des images sont à jour en exécutant le script de maintenance . Par exemple :

AllowEncodedSlashes
Si vous utilisez Apache 2.3.12 ou ultérieur, vous devez initialiser AllowEncodedSlashes à NoDecode. Ajoutez la ligne suivante à votre  ou, si vous n'en avez pas, à la fin de votre fichier httpd.conf :

AllowEncodedSlashes NoDecode

Après avoir modifié httpd.conf, Apache doit être redémarré.

Alter your .htaccess (if needed)
Si vous, vous devez ajouter une exception à .htaccess pour autoriser l'utilisation de l'.

FlaggedRevs appelle. Par exemple :

[domain]/w/rest.php/flaggedrevs/internal/review/Main_Page

Si les conditions .htaccess ne sont pas correctement initialisées lorsque l'URL ci-dessus est appelée, FlaggedRevs tentera littéralement d'accéder à un article appelé  .

Voici mis en valeur, une façon d'ajouter une exception à .htaccess :

RewriteEngine On RewriteCond %{REQUEST_URI} !^/w/rest\.php RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d RewriteRule ^(.*)$ w/index.php?title=$1 [L,QSA] RewriteRule ^$ w/index.php [L,QSA]



Promouvoir les utilisateurs en tant que relecteurs
Après que FlaggedRevs ait été installé, aucun utilisateur ne peut voir le widget de relecture. Pour corriger ceci, connectez-vous en tant que bureaucrate du wiki et allez sur Special:UserRights, puis attribuez les droits de relecture à un ou plusieurs utilisateurs. Les relecteurs verront le widget de relecture en bas des pages modifiables.



Statistiques de relecture des articles (facultatif)
Pour une collecte planifiée des statistiques de relecture d'articles, créez une tâche cron pour exécuter  à intervalle régulier. Lancez  en mesurant le temps mis par le script pour s'exécuter, et adaptez en conséquence l'intervalle entre chaque tâches de cron. Par exemple, pour créer une tâche de cron qui exécute  à partir de l'utilisateur   toutes les heures :

echo "@hourly php /var/www/mediawiki/extensions/FlaggedRevs/maintenance/updateStats.php" | crontab -u www-data -

Configuration


Droits utilisateurs et groupes d'utilisateurs
Par défaut, aucune personne ne peut relire quoi que ce soit, donc la première étape est de définir les droits utilisateur.



Droits utilisateurs
FlaggedRevs crée les nouveaux droits utilisateur suivants :


 * – utilisateur pouvant relire les révisions
 * – utilisateur pouvant relire les révisions et pouvant placer toutes les balises à tous les niveaux
 * – toutes les nouvelles révisions faites par l'utilisateur sont automatiquement marquées comme ayant été revues
 * – relecture automatique pour les annulations faites par l'utilisateur.
 * – utilisateur pouvant afficher Special:UnreviewedPages
 * – utilisateur pouvant modifier les paramètres des révisions stables de n'importe quelle page
 * – utilisateur pouvant renommer (déplacer) des pages ayant des révisions stables



Groupes d'utilisateurs
FlaggedRevs crée les nouveaux groupes d'utilisateurs suivants :


 * – reçoit, plus les droits utilisateur Mediawiki standard
 * – reçoit, plus les droits utilisateur Mediawiki standard
 * – reçoit



Comment assigner les droits utilisateurs
Les droits utilisateur peuvent être assignés de deux manières :

Assignez ces droits utilisateur aux groupes d'utilisateurs existants dans  :
 * En assignant les droits aux groupes d'utilisateurs

Ajouter manuellement les comptes des utilisateurs dans les groupes appropriés via Special:UserRights.
 * En assignant les droits à des utilisteurs spécifiques
 * Par défaut :
 * Les bureaucrates peuvent ajouter ou supprimer des relecteurs
 * Les administrateurs peuvent ajouter ou supprimer à la fois les relecteurs automatiques et les contributeurs.



Configuration de base
est fourni avec un nombre de variables configurables. Elles doivent être initialisées dans.


 * – Définit les espaces de noms candidats au processus de relecture. C'est un tableau d'entiers. Voir pour savoir à quels entiers correspondent les espaces de noms par défaut, et utilisez les constantes trouvées pour améliorer la lisibilité.
 * – Définit les balises avec leurs paramètres 'levels'.
 * Définition
 * est un tableau associatif dont les clés correspondent à chaque noms de balise. La seule valeur significative du tableau est 'levels', qui contrôle le nombre de niveaux de relecture, et le tableau peut n'avoir qu'un seul élément.
 * Etiquetage
 * Chaque balise peut être étiquetée en modifiant le MediaWiki:revreview- de la page.
 * Chacun des niveaux des balises peut être étiqueté en modifiant le MediaWiki:revreview-- de la page.
 * Par défaut, les balises sont étiquetées de la même manière qu'elles sont déclarées dans le tableau . Pour supplanter cela, et pour afficher les balises par exemple avec leur nom en majuscules, les administrateurs doivent modifier ces pages avec le contenu affiché, par exemple en modifiant le contenu de MediaWiki:revreview-accuracy


 * Pour poser des étiquettes sur les balises de niveaux, les administrateurs  doivent créer ces pages avec le contenu affiché :


 * {|class="wikitable"

!balise !niveau !étiqueter une page !contenu
 * rowspan=3|accuracy
 * 0
 * MediaWiki:revreview-accuracy-0
 * 1
 * MediaWiki:revreview-accuracy-1
 * 2
 * MediaWiki:revreview-accuracy-2
 * }
 * 2
 * MediaWiki:revreview-accuracy-2
 * }
 * MediaWiki:revreview-accuracy-2
 * }
 * }


 * La configuration résultante sera :


 * {|class="wikitable"

!noms des balises !colspan=3|noms des niveaux
 * }
 * }
 * }
 * }
 * }
 * }


 * – Indique si la version stable est le contenu par défaut des pages.
 * – Un tableau avec des clés correspondant à chaque type de balise, des valeurs qui sont des tableaux de droits, et des nombre représentant le maximum atteignable par les évaluations qui utilisent ces droits (niveau intégral de la balise).
 * Exemple :
 * Exemple :



Interface utilisateur

 * – Quand activé, on utilise un interface utilisateur plus simple basé sur une icône. Ne concerne pas les balises affichées en mode édition.
 * – Ce paramètre masque la boîte ou la barre du statut de relecture, pour les pages relues à leur dernière version. Le texte d'explication est également supprimé en plusieurs endroits.

Flux du travail

 * – S'il est activé, chaque modification réalisée par un utilisateur ayant le droit de relecture 'autoreview', est automatiquement revue lors de son enregistrement. Il n'est pas nécessaire de cliquer sur le bouton soumettre la relecture. Cette fonctionnalité impose que la révision précédente ait déjà été également relue; sinon, la relecture automatique n'aura pas lieu.
 * – Si  est activé, ce paramètre contrôle le nombre de fois que chaque balise peut être auto relue. Si c'est permis, les balises seront revues automatiquement avec le même niveau que celui qu'avaient les balises dans la version précédente. Ceci est un tableau associatif; chaque clé est une balise et chaque valeur représente un niveau de la balise
 * Exemple :



Promotion automatique de l'utilisateur

 * – Un tableau avec des clés pour les jours, les modifications, les intervalles de temps, les tests, les confirmations de courriel, les modifications de pages de contenu récentes, le nombre total de modifications de contenu, les pages de contenu modifiées, les résumés d'édition utilisés, l'adresse IP unique, et l'existence de la page utilisateur en tant que clés. Les valeurs correspondent au nombre de jours/modifications nécessaires pour qu'un compte utilisateur soit autopromu au statut de contributeur (Editor) et si cela doit être confirmé par courriel et avoir une page utilisateur pour être fait. L'utilisateur doit avoir fait au moins X modifications étalées sur Y jours ou plus, où X est le nombre de tentatives et Y l'intervalle de temps qui les sépare. Initialiser ce paramètre à  pour désactiver cela entièrement.
 * Exemple :
 * Pour, vous pouvez avoir :
 * Exemple :
 * Pour, vous pouvez avoir :

Utilisation avancée

 * - Niveaux de restriction pour les droits / . Lorsqu'un niveau est sélectionné pour une page, une modification faite par un utilisateur ne sera pas automatiquement examinée si l'utilisateur ne dispose pas des droits spécifiés. Les niveaux sont définis sur Special:Stabilization.
 * - Initialiser ceci pour utiliser FlaggedRevs uniquement comme mécanisme de protection (changements en attente), plutôt que la configuration standard.
 * - Définir lorsque les utilisateurs doivent avoir leurs modifications auto-relues. Initialiser à  pour désactiver.
 * - Indique s'il faut utiliser les versions stables des modèles lors de la génération des versions stables des pages.

Pour obtenir un wiki où les non-utilisateurs ne peuvent que voir la version stable des articles, voir.

Utilisation

 * Voir aussi : 



Approuver des pages
Les utilisateurs ayant quelques niveaux d'états de relecture ont un petit formulaire de notation sur la page affichée (en bas) ainsi que sur les diffs (en haut de la page) ce qui leur permet de relire les révisions. Chaque balise doit au moins satisfaire le niveau minimal d'approbation. Avant la relecture, les utilisateurs doivent regarder la page complète, les modèles et les images incluses. Le lien 'différence avec la version stable' est très utile pour accélérer ce processus.

Les utilisateurs ne peuvent pas relire les pages qu'ils ne peuvent modifier. Ils ne peuvent pas abaisser le niveau d'une relecture à partir d'un niveau qu'ils ne peuvent pas définir. Les utilisateurs bloqués ne peuvent rien faire.



Entretien
Sur Special:UnreviewedPages, vous avez une liste de pages qui n'ont pas encore été relues, pour les contributeurs seulement. Un espace de noms doit être choisi et un filtre de catégorie optionnel est également proposé.



Sur Special:OldReviewedPages, vous avez une liste de pages qui ont été relues, mais dont les modifications n'ont pas été validées. Ceci concerne les Contributeurs uniquement. Un filtre de catégorie optionnel est également présent.



Les pages qui ne peuvent être revues peuvent néanmoins être patrouillées par les contributeurs pour se protéger du vandalisme afin de voir ce qui a déjà été introduit.

Journalisation
Toutes les actions associées sont tracées de manière permanente dans le journal, donc tout peut être suivi et supervisé proprement.


 * Un journal des promotion/destitution des contributeurs et les raisons est conservé sur Special:Log/userrights.
 * Un journal des acceptation/rejet des révisions est conservé sur Special:Log/review.
 * Un journal des modifications de la configuration des versions stables des pages est conservé sur Special:Log/stable.

API
FlaggedRevs ajoute les modules API pour relire les révisions et pour configurer la stabilisation des pages, un module pour récupérer la configuration des balises, et deux modules de listage correspondant aux pages spéciales pour les pages non relues et les pages relues anciennement.

action=review
Relit une page.


 * Paramètres
 * : ID de révision pour laquelle on a crée les balises
 * : Un jeton CSRF obtenu de
 * : Commentaire de la revue (optionnel)
 * : Initialisez la balise appelée précision à la valeur spécifiée; (pour les autres balises, remplacez précision par le mot correspondant)
 * : s'il est initialisé, la version sera non approuvée plutôt qu'approuvée


 * Exemple

action=stabilize
Paramètres de stabilisation des pages de modifications


 * Paramètres
 * : Titre de page à stabiliser
 * : Motif de stabilisation
 * : Temporisation de stabilisation. Par défaut : infinie
 * : Indique s'il faut relire automatiquement la page
 * : Indique s'il faut suivre la page
 * : Un jeton d'édition obtenu de
 * Pour les configurations de type protection :
 * : Droit que doivent avoir les utilisateurs pour que leurs modifications ne nécessitent pas de relecture.
 * Sinon :
 * : Révision à afficher par défaut (dernière|stable)
 * : Niveau de restriction pour le droit 'relecture automatique' (sysop | none). Par défaut : none


 * Exemple

action=flagconfig
Affiche les informations concernant la configuration de la marque de relecture.

Les paramètres suivants sont renvoyés pour chaque balise :


 * : nom de la balise
 * : nombre de niveaux possibles que la balise possède (en dehors du niveau non relu)

Le nom affiché pour chaque balise et les différents noms des niveaux qui leur sont associés, sont des messages MediaWiki, et ils peuvent par conséquent être définis et récupérés à travers la page appropriée; par exemple, le nom pour le premier niveau de la balise précision se trouve sur MediaWiki:revreview-accuracy-1.


 * Exemple

list=unreviewedpages
Lister les pages n'ayant jamais été relues.


 * Paramètres
 * : Commencer le listage à ce titre de page.
 * : Arrêter le listage à ce titre de page.
 * : Espaces de noms à énumérer.
 * : Comment filtrer les redirections
 * : Comment filtrer par qualité (0=sighted,1=quality)
 * : Combien de pages à renvoyer au total.


 * Exemple

list=oldreviewedpages
Liste les pages dont certains points ont été revus, mais pour lesquelles les dernières modifications n'ont pas été revues.


 * Paramètres
 * : Commencer à lister depuis ce moment.
 * : Arrêter le listage à ce moment.
 * : Sens du listage.
 * : Espaces de noms à énumérer.
 * : Comment filtrer les redirections
 * : Combien de pages à renvoyer au total.


 * Exemple

prop=flagged
Utilisez action=query&prop=flagged pour obtenir des informations à propos du statut du marquage de pages données.

Limitations

 * Les transclusions au travers des wikis ne sont pas stabilisées
 * Les métamodèles qui incluent conditionnellement d'autres modèles peuvent voir la condition modifiée entre le moment où un relecteur a chargé la page et le moment où elle a été relue. C'est pourquoi il n'y aura pas de lien vers l'ID de révision pour que ce modèle puisse télécharger et apparaître en bleu. Vous serez informé si cela se produit durant la relecture.

Désinstaller

 * 1) Supprimer la ligne   ou   de
 * 2) Supprimer les tables dans
 * 3) Laisser de côté les colonnes ,  , et  , et l'index   de la table   (s'ils existent; utilisé uniquement par les anciennes versions de FlaggedRevs)
 * 4) Exécuter   de la ligne de commande pour purger les liens de la version stable
 * 5) Exécutez   à partir de la ligne de commande si vous utilisez



Plateformes de test

 * 
 * 
 * 



Voir aussi

 * – les modifications restent privées tant qu'elles ne sont pas approuvées
 * Flagged Revisions et les projets Wikimedia
 * – documentation à propos des groupes d'utilisateurs et des droits créés par cette extension, lorsqu'elle était utilisée sur mediawiki.org
 * – les modifications restent privées tant qu'elles ne sont pas approuvées
 * Flagged Revisions et les projets Wikimedia
 * – documentation à propos des groupes d'utilisateurs et des droits créés par cette extension, lorsqu'elle était utilisée sur mediawiki.org



Liens externes

 * Assurance qualité dans un projet libre – billet de blog Wikimedia 2008
 * Images de Flagged Revisions – Wikimedia Commons
 * A propos de Flagged Revisions – Meta-Wiki

Gestion des licences
© GPL, Aaron Schulz, Joerg Baach, 2007