Extension:PageAssessments

Manuel des extensions MediaWiki

PageAssessments État de la version : stable
Implémentation	Fonction d'analyseur , Base de données
Description	Extension pour enregistrer les évaluations d'articles (par exemple de WikiProjects) dans une nouvelle table de la base de données
Auteur(s)	Niharika Kohli Frances Hocutt Ryan Kaldari
Dernière version	1.1.0 (2016-01-11)
MediaWiki	>= 1.43
Modifie la base de données	Oui
Tables	page_assessments page_assessments_projects
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Paramètres $wgPageAssessmentsOnTalkPages $wgPageAssessmentsSubprojects
Accroches utilisées ArticleDeleteComplete CirrusSearchAddQueryFeatures LinksUpdateComplete LoadExtensionSchemaUpdates ParserFirstCallInit
Téléchargements trimestriels	4 (Ranked 133rd)
Traduire l’extension PageAssessments sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

Cette extension enregistre les évaluations d'articles (par exemple de WikiProjects) d'une manière structurée et interrogeable. Pour un exemple sur la manière dont les évaluations d'articles sont faites, voir les instructions sur Wikipedia.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé PageAssessments dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PageAssessments
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'PageAssessments' );
  

• Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Vous pouvez également utiliser ces options de configuration dans votre LocalSettings.php :

• $wgPageAssessmentsOnTalkPages — Si les évaluations sont habituellement enregistrées avec les pages elles-mêmes plutôt qu'avec les pages de discussion, mettez cette valeur à false (par défaut : true).
• $wgPageAssessmentsSubprojects — Si les projets de votre wiki ont des sous-projets ou des groupes de travail pour lesquels vous voudriez enregistrer des évaluations séparées, mettez cette valeur à true (par défaut : false).

Utilisation

La fonction d'analyseur pour créer une nouvelle évaluation est : {{#assessment: <nom du projet wiki> | <classe> | <importance>}}

• name of the wikiproject — nom court pour l'évaluation de l'article du projet, par exemple Medicine ou Hungarian culture‎. Maximum 128 caractères.
• class — une appréciation de la qualité, par exemple B ou FA. Voir les niveaux de classement sur Wikipedia pour un exemple plus parlant. Maximum 20 caractères.
• importance — note l'importance de l'article dans le projet, par exemple, Low ou High. Maximum 20 caractères.

La fonction d'analyse assessment doit être sur la page de discussion de la page en cours de relecture, néanmoins elle peut être incluse dans la page elle-même si $wgPageAssessmentsOnTalkPages vaut false. Une page peut avoir plusieurs fonctions d'évaluation pour différents projets.

Si un modèle d'évaluation est déjà en cours d'utilisation sur plusieurs pages, la fonction d'analyse peut être transcluse dans le modèle lui-même pour éviter de mettre à jour séparément la page de discusion de chacun des articles.

Exemple d'utilisation

La valeur de importance/priorité d'un article peut être différente en fonction du projet wiki :

{{#assessment:Medicine|A|Low}}
{{#assessment:Biology|B|High}}

Explication :

En utilisant cet exemple dans une page de discussion, déclare la page actuelle à l'intérieur du projet Médecine, avec une qualité A, et une importance faible.

Il déclare également la page actuelle dans le projet Biologie, avec une qualité B, et d'une grande importance.

API

L'extension PageAssessments inclut trois modules de requête à l'API : pageassessments, projectpages, et projects.

Pageassessments

pageassessments est une nouvelle requête de propriété à l'API Action de MediaWiki. Elle est utilisée pour récupérer les métadonnées des évaluations d'une ou plusieurs pages.

Exemples

Obtenir les données du projet et des évaluations pour la page Apple.

api.php?action=query&prop=pageassessments&titles=Apple

Obtenir les données du projet et les évaluations pour les pages Apple et Pear, en utilisant le format de résultat le plus récent de l'API.

api.php?action=query&prop=pageassessments&titles=Apple|Pear&formatversion=2

Obtenir les données du projet et des évaluations pour la page Apple, avec les sous-projets et les groupes de travail (disponible uniquement si $wgPageAssessmentsSubprojects vaut true).

api.php?action=query&prop=pageassessments&titles=Apple&pasubprojects=true

Projectpages

projectpages est une nouvelle requête de liste. Elle est utilisée pour récupérer toutes les pages évaluées par un projet wiki particulier. Cette requête peut être utilisée en tant que générateur. En ajoutant wppassessments=true, vous pouvez également obtenir les métadonnées d'évaluation pour chacune des pages.

Exemples

Obtenir les 10 premières pages associées à un projet wiki :

api.php?action=query&list=projectpages [Essayez !]

Obtenir les 10 premières pages associées au projet wiki Medicine avec les données des évaluations :

api.php?action=query&list=projectpages&wppprojects=Medicine&wppassessments=true [Essayez !]

Obtenir les informations de page pour les 10 premières pages associées au projet wiki Textile Arts :

api.php?action=query&generator=projectpages&prop=info&gwppprojects=Textile%20Arts [Essayez !]

Projects

projects est une nouvelle requête de liste. Obtenir une liste de tous les projets wiki d'un wiki donné : les résultats sont renvoyés en tant que tableau de noms de projets.

Exemples

Obtenir la liste de tous les projets wiki.

api.php?action=query&list=projects

Elle fournit une liste de tous les projets wiki, y compris les sous-projets et les groupes de travail (disponible uniquement si $wgPageAssessmentsSubprojects vaut true) :

api.php?action=query&list=projects&pjsubprojects=true

Page spéciale

PageAssessments fournit également une interface sur le wiki pour récupérer les données des évaluations sur Special:PageAssessments.

Tables de la base de données

PageAssessments crée deux nouvelles tables dans la base données :

• page_assessments
• page_assessments_projects

page_assessments enregistre les méta-données des évaluations, et page_assessments_projects les noms des projets wiki (de sorte à ne pas les réécrire explicitement avec chaque enregistrement d'évaluation dans la table page_assessments). Les deux tables sont nécessaires pour un bon fonctionnement de la fonction d'analyse et pour les APIs. Les tableaux doivent exister sur tout wiki où l'extension PageAssessments est installée. Si PageAssessments n'est plus installée, les deux tables peuvent être supprimées sans problème.

Le script de maintenance purgeUnusedProjects.php peut être exécuté pour supprimer les projets de la table page_assessments_projects pour lesquels il n'existe plus d'évaluation.

Voir aussi

• Communauté technique/PageAssessments sur Meta-Wiki
• Créer une nouvelle extension qui implémente l'importance et la qualité de l'article