Rater
DescriptionHelps assess pages for WikiProjects
Author(s)Evad37
Version2.7.2
Updated5 October 2024 (history)
Skins
  • Vector
  • Monobook
  • Modern
  • Cologne Blue
  • Timeless
  • MinervaNeue
Source
GitHubrepositoryrater

Rater(source) helps fill in assessments and other parameters for WikiProject banners. Find it in the "Tools" dropdown menu on the default Vector (2022) skin. UseAlt+5to open Rater (on Windows, or a similar combination for other OSs) without using the dropdown menu.

Rater is available from either the page itself or its talk page, in all namespaces, apart from Special pages and base User and User talk pages (but is still available for userspace drafts in subpages).

Installation

edit

To install the script, add the line:

{{subst:lusc|User:Evad37/rater.js}}

toSpecial:MyPage/common.js.

Preferences

edit

Various preferences can be set through the Rater dialog. Once the main Rater window is opened, click on the cog wheel button in the top-left. Your preferences will be stored in araterPrefs.json subpagewithin your userspace.

Available preferences are:

  • Autostart Rater
    • Autostart on redirects
    • Autostart in specific namespaces
  • Bypass redirects to banners
  • Autofill class from other banners
  • Autofill class based on ORES prediction
  • Autofill low importance
  • Minimum number of parameters to show uncollapsed
  • Add edited pages to watchlist
You will need to reset any preferences you had from the old version of Rater.

These were stored in yourcommon.js,and should now be removed:

  • rater_autostartNamespaces =namespace number or numbers
  • rater_watchlist =either'watch'or'nochange'

Customisation

edit

You can customise the colours, fonts, and other styles that Rater uses by adding custom CSS to yourcommon.css.Here are some examples:

Extended content
You can change background color like this:
htmlbody.rater-mainWindow-open.oo-ui-window-content{
background-color:#F0F8FF;
}
Use anyweb color nameor hex triplet in place of#F0F8FF.
This will make template names take up the full available width (pushing class/importance dropdowns onto the next line):
.rater-bannerWidget.oo-ui-popupButtonWidget{
width:100%!important;
}

To get rid of (most) of the bolding:
.rater-bannerListWidget.oo-ui-labelElement-label{
font-weight:normal!important;
}

Use a smaller, monospace font

htmlbody.rater-mainWindow-open.oo-ui-window-content{
background-color:#EEE8AA;font-family:monospace;font-size:8pt;
}

--- Style the popup menu options (for "Add a wikiproject...", "Set all...", etc)

htmlbody.rater-mainWindow-open.oo-ui-window-overlay.oo-ui-menuOptionWidget{
/*... styles for dropdown options... */
}
htmlbody.rater-mainWindow-open.oo-ui-window-overlay.oo-ui-labelElement-label{
/*... styles for non-selectable dropdown labels (e.g. "Classes", "Importances" )... */
}

Assessment advice

edit

Theclass ratingis a measure of an article's quality, according to the grades described atWikipedia:Content assessment,or the individual WikiProject's assessment scale.

  • Generally, this assessment should only be in the{{WikiProject banner shell}},though individual WikiProjects may use non-standard grades, or offer further advice on determining class ratings.SeeWP:PIQAfor further information.
  • FA (featured article), FL (featured list), GA (good article), and A (A-Class) ratings should only be assigned to articles that have passed the relevant review process.
  • A machine-generated prediction of article quality (fromORES) is displayed in the lower-right corner of the Rater dialog. This isonlya prediction, and may be inaccurate (occasionally wildly so). The predicted rating is accompanied by a probability percentage, indicating how likely that particular rating is (ORES determines probabilities for each standard class rating, excluding List and FL, and displays the one with the highest probability score).

Theimportance ratingindicates the importance or priority of an article,relative to a specific WikiProjectand at the discretion of that project's members. An article can be rated as Low importance for one project, and Medium, High, or even Top importance for another project.

  • Statisticallythe large majority of articles are rated low importance, so that is the default suggestion when importance has not yet been rated.
  • Using other importance ratings, or reassessing importance after it has already been set, requires a greater level of competence regarding the individual WikiProject's project's goals and assessment criteria. If you are not that familiar with the WikiProject, consider discussing the importance rating on the project's or article's talk page.

Various ratings exist for non-article pages, but these do not usually need to be filled in. Such ratings can be automatically detected by banner templates, based on the page the banner is placed on.

Features

edit

For each banner:

  • Remove a banner template
  • Clear parameters for a banner template (e.g. if a page has become a redirect or disambiguation page)
  • Bypass redirects (e.g. turn{{MILHIST|...}}into{{WikiProject Military history|...}}orwrappers
  • Set class and importance from a dropdown selection menus.
    • Non-standard rating such as Future class and Bottom importance will be available if the banner supports them.
  • For WikiProject Biography,|listas=is automatically filled based on the page title
    • Autofill is noted in display, in case the normallast, first other+pattern isn't suitable
  • Edit parameter values
  • Remove a parameter
  • Add a parameter
    • Parameter suggestions are available as you type, if there isTemplateDataon the template documentation
  • Parameter display depends on whether the TemplateData has been set up (see§ TemplateData quick tutorialbelow)
    • If there is no TemplateData, or no label defined, the parameter name is shown incode formatting
    • If there is a label, that label is shown (in normal formatting) with a tooltip displaying the parameter name
    • If there is also a description, that is also shown in the label's tooltip

Other actions:

  • Add a new banner template
  • Remove all banner templates
  • Clear parameters for all banner templates
  • Set class/importance for all banners (standard ratings only). Class ratings are applied to the banner shell, importance ratings are applied to individual banners.
  • {{WikiProject banner shell}}is added automatically, if not already present. If all projects have the same rating, it will be set in the banner shell and removed from individual banners.
    • The|living=,|blpo=,|activepol=,|listas=parameters will be moved from{{WikiProject Biography}}into the banner shell

After making changes, you can show a preview, show a diff, or just save the changes.

Access keys

edit

Rater defines the followingaccess keys(on Windows, or a similar combination for other OSs):

  • Alt+5to open Rater
  • Alt+⇧ Shift+Sto Save, orAlt+s
  • Alt+⇧ Shift+Pto Show preview, orAlt+p
  • Alt+⇧ Shift+Vto Show changes, orAlt+v

Speed rating, example

edit

AtCategory:Unassessed biography articlesthere is a huge backlog, so being able to do a quick article assessment is important.

  1. HoldCtrland click (or middle-click using a mouse) on an entry to open the article's Talk page in a new Windows Tab.
  2. DoCtrl+9to move focus into Windows (last) tab.
  3. ThenAlt+cto display the article page, and evaluate the article.
  4. NextAlt+5to open Rater. Before saving, watch forStartarticles than are rated asStuband vice versa.
  5. Make Rater changes as needed.
  6. ThenAlt+sto Save.
  7. Lastly,Ctrl+w,to close Windows (last) tab.

While above may seem complicated, with a little practice, and many repetitions the steps can become automatic. These speed rating steps are universal and apply throughout Wikipedia articles. For non-Windows browsers, use the equivalent keypresses instead.

TemplateData quick tutorial

edit

TemplateData stores template/parameter information in a machine-readable format, for use by VisualEditor and other tools. Rater uses this TemplateData to provide parameter suggestions.

Popup window that appears after clicking "Manage TemplateData" button
Screen for entering detailed information for a parameter

To quickly set up TemplateData for a template:

  1. Edit the template's documentation, and click theManage TemplateDatabutton near the top of the page
  2. In the popup window, underTemplate parameters,click the "Add ## suggested parameters" button
  3. (Optional)For each parameter, click on it to fill in detailed information for that parameter (see below)
  4. Click the Apply button – the<templatedata>...</templatedata>block is inserted into the edit window
  5. (Recommended)Add{{TemplateData header}}above the<templatedata>line
  6. Save the page

Tips:

  • You may need tonull editthe template itself after adding or modifying TemplateData
  • You can collapse the TemplateData so that it doesn't overwhelm the documentation page:
    • Add{{cot|TemplateData}}above the<templatedata>line and{{cob}}below the</templatedata>line
  • Add{{Cleanup TemplateData}}if the TemplateData is crude, incomplete, or otherwise in need of cleanup

Detailed information for parameters

edit

For each parameter listed underTemplate parameters,you enter click on it to add further details about that parameter. Rater uses the following fields:

Aliases
Alternative parameter names that are exactly equivalent.
Rater will recognise aliases, but save to the default parameter name.
Label
Human-readable title for the parameter.
Rater will display the label instead of the parameter name, which will instead be shown in a tooltip.
Description
Description of the specific parameter; can include usage instructions; must be plain text ([[wikilinks]], '''bold''', etcwill not work).
Rater will show the description in the label's tooltip.
Autovalue
Standard value to pre-fill the parameter with.
Rater will prefill manually-added parameters with this value.
Required
Filling out the parameter is mandatory for all uses of this template.
Rater will always show this parameter.
Suggested
Most users of the template will probably want to fill it in.
Rater will show this parameter when the banner is initially loaded or added.
Allowed values– this feature is missing from TemplateData, seephab:T53375.The following will work for Rater (but not other tools such as VisualEditor):
Set of available values for a parameter. Must be a well-formed array:
  • Starting with[
  • Then a comma-separated list of values, each withinsinglequotation marks
  • Ending with]
(e.g.['Value1', 'Value2', 'Value3'])
Must be placed in the Description field.
Example:Priority for Task Force X. Set to one of: ['low', 'mid', 'high', 'top']
Rater will show a checkbox or dropdown menu instead of a text input:
  • Single value – Checkbox(checked = set to that value; unchecked = do not set parameter)
  • Two values – Checkbox(checked = set to first value; unchecked = set to second value)
  • More than two values – Dropdown menu

See also

edit

Notes

edit
  1. ^Copy the following code,edit your user JavaScript,then paste:
    {{subst:lusc|1=User:Equazcion/CatListMainTalkLinks.js}}