 |
Release version parameters |
|---|
Template documentation[view] [edit] [history] [purge]This template is used to store WikiProject-specific configuration settings for the Wikipedia Release Version Tools. WikiProjects sign up for these tools by placing their top-level assessment categories into Category:Wikipedia 1.0 assessments. For example, Wikipedia:WikiProject Computing has Category:Computing articles by quality and Category:Computing articles by importance.
This ReleaseVersionParameters template should be placed in each project's top-level quality category (for example, Category:Computing articles by quality). Only one instance of the template should be placed on each such category.
Formatting the parameters
Each configuration setting is called a parameter. Unlike most templates, the arguments to this template must be parsed both by the wiki and by an external bot process. Therefore, the parameters must be carefully formatted, and formatting and spacing is important.
Each parameter has a name (such as homepage) and a value (such as Wikipedia:WikiProject Ships). These are separated with an equals sign and no extra whitespace (homepage=Wikipedia:WikiProject Ships), and a pipe character is added at the front (|homepage=Wikipedia:WikiProject Ships).
In order to set all the necessary configuration data, several parameters may be used. Each parameter must be on its own line, and not on the same line as the opening {{ReleaseVersionParameters or the closing }}. The correct synax is shown in the example code below.
Basic parameters
The most important parameter is homepage, which tells the system the main page for the project. For WikiProjects this will probably be the WikiProject's page; for task forces, it will be the task force's homepage.
The syntax for setting just this parameter is:
{{ReleaseVersionParameters
|homepage=Wikipedia:WikiProject Mathematics
}}
A second basic parameter, "shortname", tells the bot a shorter "nickname" that can be used when displaying the name of the project. This is useful for projects that have extra terms such as "work group" or "related" in the title, and which don't wish to see these extra terms in the web output. The syntax to set the homepage and shortname for a project is:
{{ReleaseVersionParameters
|homepage=Wikipedia:WikiProject The Church of Jesus Christ of Latter-day Saints work group
|shortname=The Church of Jesus Christ of Latter-day Saints
}}
The final "basic" argument is "hidden". Setting this argument causes the template to suppress its output on the category page. Some projects may prefer to set this parameter if they already have a preferred layout for their category pages. An example using this parameter is:
{{ReleaseVersionParameters
|homepage=Wikipedia:WikiProject The Church of Jesus Christ of Latter-day Saints work group
|shortname=The Church of Jesus Christ of Latter-day Saints
|hidden=yes
}}
Extra quality and importance ratings
Many projects have quality or importance ratings that were not supported by the WP 1.0 bot. For example, some projects have used a "Future-Class" quality rating, and some have used a "Bottom-Class" importance rating. These ratings are all supported by the next bot. They are configured using parameters to this ReleaseVersionParameters template.
How to configure a new rating
In this section, "rating" means a quality or importance rating such as "Bottom-Class". There are four parameters that must be set for each rating, and one optional parameter. The required parameters are:
-
title: the name of the template on the wiki that corresponds to the rating. For example, Template:Bottom-Class corresponds totitle=Bottom-Class -
typeis eitherqualityorimportance -
categoryis the category containing the talk pages that have this rating. For example, Bplus-Class mathematics articles are in Category:Bplus-Class mathematics articles and so the parameter iscategory=Bplus-Class mathematics articles. Notice that the word "Category:" is not included in the parameter. -
rankingis a natural number between 0 and 500. This number controls both where the new rating will appear among the other ratings in the summary table, and the quality points for the article's release version score. The values for the standard ratings are shown in the following table. Each rating should have a different numeric value.Quality Rating Numeric ranking FA-Class 500 FL-Class 480 A-Class 425 GA-Class 400 B-Class 300 C-Class 225 Start-Class 150 Stub-Class 100 List-Class 80 Assessed-Class 20 Unassessed-Class 0 Importance Numerical ranking Top-Class 400 High-Class 300 Mid-Class 200 Low-Class 100 Unassessed-Class 0
Once you have the values for the title, type, category, and rankingparameters, you need to give them a prefix that groups them together into one rating. For the first extra rating, the prefix is extra1-. For the second, the prefix is extra2-.
The optional parameter is replaces. This specifies a rating on the default scale that is "close enough" to the custom rating. For example, the Bplus-quality rating might set replaces=B-Class. This parameter is used when generating the global statistics table; the pages with the custom rating are counted in that table as if they had the replaces rating instead.
For example, the following code will add a Bplus quality rating for the mathematics project:
{{ReleaseVersionParameters
|extra1-title=Bplus-Class
|extra1-type=quality
|extra1-category=Bplus-Class mathematics articles
|extra1-ranking=415
|extra1-replaces=B-Class
}}
The next example adds a NA importance rating to the Drug Policy project.
{{ReleaseVersionParameters
|homepage=Wikipedia:WikiProject Drug Policy
|extra1-title=NA-Class
|extra1-type=importance
|extra1-category=NA-importance Drug Policy articles
|extra1-ranking=20
}}
Here, the replaces parameter is not set because non-article pages do not appear in the overall statistics table anyway.
The next example adds two extra ratings to the Lancashire and Cumbria project: NA-Class as a quality rating and NA-Class as an importance rating.
{{ReleaseVersionParameters
|homepage=Wikipedia:WikiProject Lancashire and Cumbria
|extra1-title=NA-Class
|extra1-type=importance
|extra1-category=NA-importance Lancashire and Cumbria articles
|extra1-ranking=20
|extra2-title=NA-Class
|extra2-type=quality
|extra2-category=NA-Class Lancashire and Cumbria articles
|extra2-ranking=20
}}