Extension:PageAssessments/fr

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
Vous pouvez également utiliser ces options de configuration dans votre  :
 * — Si les évaluations sont habituellement enregistrées avec les pages elles-mêmes plutôt qu'avec les pages de discussion, mettez cette valeur à  (par défaut :  ).
 * — 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 à  (par défaut :  ).

Utilisation
La fonction d'analyseur pour créer une nouvelle évaluation est :


 * — nom court pour l'évaluation de l'article du projet, par exemple Medicine ou Hungarian culture‎. Maximum 128 caractères.
 * — 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.
 * — note l'importance de l'article dans le projet, par exemple, Low ou High. Maximum 20 caractères.

La fonction d'analyse  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   vaut. Une page peut avoir plusieurs fonctions d'évaluation pour différents projets.



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

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 :,  , et.

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  vaut  ).

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

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, 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 :

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

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

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  vaut  ) :

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 :



enregistre les méta-données des évaluations, et  les noms des projets wiki (de sorte à ne pas les réécrire explicitement avec chaque enregistrement d'évaluation dans la table  ). 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   peut être exécuté pour supprimer les projets de la table   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