 Release status: stable | |
|---|---|
| Implementation | Parser function,Database,Special page,MyWiki |
| Description | Supports storing page assessments in a dedicated database table |
| Author(s) |
|
| Latest version | N/A |
| Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
| Database changes | Yes |
| |
| License | GNU General Public License 2.0 or later |
| Download | |
| Translate the PageAssessments extension if it is available at translatewiki.net | |
| Issues | Open tasks ·Report a bug |
This extension is for storing page assessments (e.g. forEnglish Wikipedia WikiProjects) in a structured and query-able way.For an example of how page assessments are done and used, seethe English Wikipedia's documentation.
PageAssessments folder to yourextensions/ directory.cdextensions/gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/PageAssessmentswfLoadExtension('PageAssessments');
Done – Navigate toSpecial:Version on your wiki to verify that the extension is successfully installed.You can also use these configuration options in yourLocalSettings.php file:
$wgPageAssessmentsOnTalkPages — If assessments are normally recorded on the pages themselves rather than on talk pages, set this tofalse (default:true).$wgPageAssessmentsSubprojects — If projects on your wiki have subprojects or task forces that you would like to record separate assessments for, set this totrue (default:false).The parser function for creating a new assessment is:{{#assessment: <name of the WikiProject> | <class> | <importance>}}
name of the wikiproject — a short name for the project assessing the article, for example, "Medicine" or "Hungarian culture". Can be up to 128 characters long.class — a quality ranking, for example, "B" or "FA". See theclass grades on Wikipedia for a more comprehensive example. Can be up to 20 characters long.importance — a ranking of how important the article is to the project, for example, "Low" or "High". Can be up to 20 characters long.Theassessment parser function is expected to be on the talk page of the page under review, however it may be included on the page itself if$wgPageAssessmentsOnTalkPages is set tofalse.A page may have more than one assessment function for different projects.
The importance/priority of an article might be different depending on the WikiProject:
{{#assessment:Medicine|A|Low}}{{#assessment:Biology|B|High}}
Explanation:
Using this example in a talk page, declares the current page inside the Medicine project, with A quality, and with Low importance.
It also declares the current page in the Biology project, with B quality, and with High importance.
For wikis withCirrusSearch installed, PageAssessments adds ainproject keyword to allow filtering of search results to pages in given WikiProjects.For example,inproject:Cricket|Football will find pages related to either Cricket or Football.
Search rankings are influenced by the importance assigned to the article by the projects.
For wikis withScribunto installed, PageAssessments adds apageAssessments property tomw.title objects.It exposes the names of projects associated with the page, along with their class and importance assessments.
The PageAssessments extension includes three API query modules:pageassessments,projectpages, andprojects.
pageassessments is a newproperty query for theMediaWiki Action API.It is used to retrieve assessment metadata for one or more pages.
Get project and assessment data for page "Apple".
api.php?action=query&prop=pageassessments&titles=Apple
Get project and assessment data for pages "Apple" and Pear, using the newer API result format.
api.php?action=query&prop=pageassessments&titles=Apple|Pear&formatversion=2
Get project and assessment data for page "Apple", including subprojects and task forces (only available if$wgPageAssessmentsSubprojects istrue).
api.php?action=query&prop=pageassessments&titles=Apple&pasubprojects=true
projectpages is a newlist query.It is used to retrieve all the pages assessed by a particular WikiProject.This query can be used as agenerator.By addingwppassessments=true, you can also get the assessment metadata for each of the pages.
Get first 10 pages associated with any WikiProject:
Get first 10 pages associated with WikiProject Medicine, including assessment data:
Get page info for first 10 pages associated with WikiProject Textile Arts:
projects is a newlist query.It is used to retrieve a list of all the WikiProjects on a wiki.The results are returned as an array of project names.
Get a list of all the WikiProjects.
api.php?action=query&list=projects
Get a list of all the WikiProjects, including sub projects and task forces (only available if$wgPageAssessmentsSubprojects istrue).
api.php?action=query&list=projects&pjsubprojects=true
PageAssessments also provides an on-wiki interface for retrieving assessment data at Special:PageAssessments.
PageAssessments creates two new database tables:
page_assessments stores the assessment metadata, whilepage_assessments_projects stores the names of WikiProjects (so that they don't have to be recorded in full as part of each assessment record in thepage_assessments table).Both tables are required for proper functioning of the parser function and APIs.The tables should exist on any wiki that has the PageAssessments extension installed.If PageAssessments is uninstalled, both tables can be dropped safely.
ThepurgeUnusedProjects.php maintenance script can be run to remove projects from thepage_assessments_projects table that are no longer used by any assessments.
 | This extension is being used on one or moreWikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia'sCommonSettings.php andInitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki'sSpecial:Version page. |
 | This extension is included in the following wiki farms/hosts and/or packages: |
| This page or project is maintained byseveral people as noted in the infobox. Get help:
|
