Extension:PageAssessments
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échargements trimestriels | 4 (Ranked 135th) |
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 dossierextensions/
.
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.
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 :
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
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
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
Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |
plusieurs personnes comme indiqué dans la boîte d'information assure la maintenance de cette page ou ce projet.
Obtenir de l'aide :
|