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. Ces révisions resteront les mêmes, même si les modèles inclus ou les images viennent à être modifiés. Ceci permet à MediaWiki d'agir plutôt comme un système de gestion de contenu (Content Management System - CMS).

Configuration
Suivre les étapes suivantes pour installer FlaggedRevs :


 * 1) Assurez-vous d'exécuter MediaWiki version 1.17 ou supérieur. Sinon, vous devez faire une mise à jour avant de pouvoir installer FlaggedRevs.
 * 2) Téléchargez FlaggedRevs. Choisissez une version de FlaggedRevs compatible avec votre version de MediaWiki. Par exemple : si vous utilisez MediaWiki 1.17, téléchargez FlaggedRevs 1.17.
 * 3) Décompressez le fichier téléchargé dans le dossier   de votre installation MediaWiki. Par exemple :
 * 4) Assurez-vous que les codes de hachage des images sont à jour en exécutant le script de maintenance . Par exemple :
 * 5) Assurez-vous que le répertoire   est accessible en lecture par le serveur web (afin que ce dernier puisse fournir le CSS de FlaggedRevs, les images et le JavaScript). Par exemple : en supposant que la personne qui a démarré le serveur web n'est pas le propriétaire du répertoire  , exécutez :
 * 6) Activez la collecte des statistiques concernant la relecture des articles.
 * 7) Désactivez la génération des statistiques à la demande. Initialisez   dans . Ceci empêche que les statistiques ne soient générées quand on accède aux articles (ce qui peut conduire à de faibles performances quand vous accédez simultanément à plusieurs articles qui n'ont actuellement pas de statistiques).
 * 8) Activez la génération des statistiques au calendrier. Créez une tâche de cron pour exécuter   à intervalles réguliers. 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 :
 * 9) Activez FlaggedRevs en ajoutant la ligne suivante à  :
 * 10) Mettez à jour les schémas de la base de données MediaWiki en exécutant  . Ceci doit être fait après que l'étape ci-dessus soit enregistrée, sinon vous recevrez une erreur de base de données lors de l'accès à n'importe quelle page.
 * 11) 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.
 * 1) Activez FlaggedRevs en ajoutant la ligne suivante à  :
 * 2) Mettez à jour les schémas de la base de données MediaWiki en exécutant  . Ceci doit être fait après que l'étape ci-dessus soit enregistrée, sinon vous recevrez une erreur de base de données lors de l'accès à n'importe quelle page.
 * 3) 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.
 * 1) Mettez à jour les schémas de la base de données MediaWiki en exécutant  . Ceci doit être fait après que l'étape ci-dessus soit enregistrée, sinon vous recevrez une erreur de base de données lors de l'accès à n'importe quelle page.
 * 2) 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.
 * 1) 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.

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
 * – 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
FlaggedRevs.php est fourni avec un nombre de variables configurables. Elles doivent être initialisées dans LocalSettings.php.


 * – Définit les espaces de noms candidats au processus de relecture. C'est un tableau d'entiers. Regardez au début de includes/Defines.php pour savoir à quels entiers correspondent les espaces de noms et utilisez les constantes qui y sont définies pour une meilleure lisibilité.
 * – Définit les balises avec leur trois paramètres : 'levels', 'quality', et 'pristine'
 * Définition
 * est un tableau associatif dont les clés correspondent à chaque noms de balise et où les valeurs sont les tableaux des trois paramètres 'levels', 'quality', et 'pristine':
 * 'levels' contrôle le nombre de niveaux de relecture,
 * 'quality' décide du niveau que la balise doit avoir pour que la révision soit 'de qualité'
 * 'pristine' décide du niveau que la balise doit avoir pour que la révision soit 'parfaite'
 * 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.
 * Exemple :
 * Supposons que l'on veuille avoir la précision, la profondeur et le ton avec trois niveaux chacuns.
 * Les administrateurs eux aussi veulent avoir les révisions avec avec au moins la précision et la profondeur des seconds niveaux, pour être de qualité. Les paramètres suivants feront cela :
 * Par défaut, les balises sont étiquetées de la même manière qu'elles sont déclarées dans le tableau $wgFlaggedRevsTags. Dans cet exemple, cela signifie que les balises apparaissent exactement comme 'accuracy', 'depth' et 'tone'.
 * Pour afficher les balises par exemple avec leur nom en majuscules, les administrateurs doivent modifier ces pages avec le contenu affiché.
 * {|class="wikitable"
 * {|class="wikitable"

!balise !étiqueter une page !contenu
 * accuracy
 * MediaWiki:revreview-accuracy
 * depth
 * MediaWiki:revreview-depth
 * tone
 * MediaWiki:revreview-tone
 * Ton
 * }
 * tone
 * MediaWiki:revreview-tone
 * Ton
 * }
 * }


 * 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
 * rowspan=3|depth
 * 0
 * MediaWiki:revreview-depth-0
 * 1
 * MediaWiki:revreview-depth-1
 * 2
 * MediaWiki:revreview-depth-2
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * Mauvais
 * 1
 * MediaWiki:revreview-tone-1
 * Bon
 * 2
 * MediaWiki:revreview-tone-2
 * Excellent
 * }
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * Mauvais
 * 1
 * MediaWiki:revreview-tone-1
 * Bon
 * 2
 * MediaWiki:revreview-tone-2
 * Excellent
 * }
 * 2
 * MediaWiki:revreview-tone-2
 * Excellent
 * }


 * La configuration résultante sera :


 * {|class="wikitable"

!noms des balises !colspan=3|noms des niveaux
 * Ton
 * Mauvais
 * Bon
 * Excellent
 * }
 * Ton
 * Mauvais
 * Bon
 * Excellent
 * }
 * Ton
 * Mauvais
 * Bon
 * Excellent
 * }
 * }


 * – 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 :
 * – Tableau de chaînes représentant les titres. Ces titres sont des pages exclues de FlaggedRevs. Ils ne sont pas affichables et n'ont pas d'interface utilisateur marquable. Remplacez l'espace ' ' par '_' dans les titres (par exemple « Main page » &rarr; « Main_page »).
 * – Tableau de chaînes représentant les titres. Ces titres sont des pages exclues de FlaggedRevs. Ils ne sont pas affichables et n'ont pas d'interface utilisateur marquable. Remplacez l'espace ' ' par '_' dans les titres (par exemple « Main page » &rarr; « Main_page »).
 * – Tableau de chaînes représentant les titres. Ces titres sont des pages exclues de FlaggedRevs. Ils ne sont pas affichables et n'ont pas d'interface utilisateur marquable. Remplacez l'espace ' ' par '_' dans les titres (par exemple « Main page » &rarr; « Main_page »).

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

 * – Permet aux utilisateurs de ce groupe de voir par défaut, la révision actuelle ou le brouillon.
 * – S'il est activé, chaque modification réalisée par un utilisateur ayant le droit de relecture automatique, 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 $wgFlaggedRevsAutopromote, vous pouvez avoir :
 * Exemple :
 * Pour $wgFlaggedRevsAutopromote, vous pouvez avoir :

Utilisation avancée
Voir FlaggedRevs.php pour une liste complète des options de configuration (avec quelques commentaires explicatifs). Assurez-vous de ne modifier que Localsettings.php pour configurer les options de configuration plutôt que de modifier ce fichier.

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.



Sur , vous pouvez lister toutes les révisions déjà relues d'une certaine page, ou bien afficher les révisions relues.



Entretien
Sur , 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 , 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.

Une liste des pages revues aux niveaux principaux de relecture peut être trouvée sur .



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.

Une nouvelle page également,  affiche uniquement les entrées de journal marquées relatives aux révisions de qualité. Ceci est utile lorsque le journal principal est envahi avec les consultations de pages.

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 trois modules de listage correspondant aux pages spéciales pour les pages relues, les pages non relues et les pages relues anciennement.

Documentation supplémentaire de l'API sur.

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)


 * Exemple

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


 * Paramètres
 * : Titre de page à stabiliser
 * : Motif de stabilisation
 * : (Obsolète ?) 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)
 * : Quelle révision stable doit être affichée (pristine | quality | latest). Par défaut : quality
 * : 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)
 * : niveau que la balise doit avoir pour que la révision puisse être considérée comme étant de qualité
 * : niveau que la balise doit avoir pour que la révision puisse être considérée comme étant pristine

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 = reviewedpages
Liste les pages relues.


 * Paramètres
 * : Commencer le listage à cet ID de page.
 * : Arrêter le listage à cet ID de page.
 * : Sens du listage.
 * : 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 = 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 images externes (y compris de Commons) 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) Supprimez la ligne d'inclusion dans
 * 2) Laisser de côté les tables dans de.
 * 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
 * – 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
 * – 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