Extension:PageAssessments

This extension is for storing article assessments (e.g. for WikiProjects) in a structured and query-able way. For an example of how article assessments are done, see the guidelines on Wikipedia.

Installation
You can also use these configuration options in your  :
 * — If assessments are normally recorded on the pages themselves rather than on talk pages, set this to   (default:  ).
 * — If projects on your wiki have subprojects or task forces that you would like to record separate assessments for, set this to   (default:  ).

Usage
The parser function for creating a new assessment is:


 * — a short name for the project assessing the article, for example, "Medicine" or "Hungarian culture‎". Can be up to 128 characters long.
 * — a quality ranking, for example, "B" or "<tvar|2>FA</>". See the class grades on Wikipedia for a more comprehensive example.  Can be up to 20 characters long.
 * — a ranking of how important the article is to the project, for example, "<tvar|1>Low</>" or "<tvar|2>High</>". Can be up to 20 characters long.

The <tvar|1> </> 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 <tvar|2> </> is set to <tvar|3> </>. A page may have more than one assessment function for different projects.

Example usage
The importance/priority of an article might be different depending on the WikiProject:

API
The PageAssessments extension includes three API query modules: <tvar|1> </>, <tvar|2> </>, and <tvar|3> </>.

Pageassessments
<tvar|1> </> is a new 2>Special:MyLanguage/API:Properties</>|property query for the 3>Special:MyLanguage/API:Main page</>|MediaWiki Action API. It is used to retrieve assessment metadata for one or more pages.

Examples
Get project and assessment data for page "<tvar|1>Apple</>".

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

Get project and assessment data for pages "<tvar|1>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 "<tvar|1>Apple</>", including subprojects and task forces (only available if <tvar|2> </> is <tvar|3> </>).

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

Projectpages
<tvar|1> </> is a new 2>Special:MyLanguage/API:Lists</>|list query. It is used to retrieve all the pages assessed by a particular WikiProject. This query can be used as a 1>Special:MyLanguage/API:Query#Generators</>|generator. By adding <tvar|1> </>, you can also get the assessment metadata for each of the pages.

Examples
Get first 10 pages associated with any WikiProject:

Get first 10 pages associated with WikiProject <tvar|1>Medicine</>, including assessment data:

Get page info for first 10 pages associated with WikiProject <tvar|1>Textile Arts</>:

Projects
<tvar|1> </> is a new 2>Special:MyLanguage/API:Lists</>|list 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.

Examples
Get a list of all the WikiProjects.

api.php?action=query&list=projects

Get a list of all the WikiProjects, including subprojects and task forces (only available if <tvar|1> </> is <tvar|2> </>).

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

Special page
PageAssessments also provides an on-wiki interface for retrieving assessment data at <tvar|1>Special:PageAssessments</>.

Database tables
PageAssessments creates two new database tables:



<tvar|1> </> stores the assessment metadata, while <tvar|2> </> stores the names of WikiProjects (so that they don't have to be recorded in full as part of each assessment record in the <tvar|3> </> 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.

The <tvar|1> </> maintenance script can be run to remove projects from the <tvar|2> </> table that are no longer used by any assessments.