Difference between revisions of "Module:Module rating"

From blackwiki
Jump to navigation Jump to search
(Blanked the page)
m (44 revisions imported)
 
(39 intermediate revisions by 14 users not shown)
Line 1: Line 1:
 +
<noinclude>
 +
<languages />
 +
</noinclude>{{#switch:<translate></translate>
 +
| =
 +
{{Module other|{{ombox
 +
| type      = notice
 +
| image    = {{#switch: {{{1|}}}
 +
  | pre-alpha | prealpha | pa = [[File:OOjs UI icon text-style.svg|40x40px|link=]]
 +
  | alpha | a                = [[File:OOjs UI icon bold-a.svg|40x40px|link=]]
 +
  | beta | b                  = [[File:OOjs UI icon bold-b.svg|40x40px|link=]]
 +
  | release | r | general | g = [[File:OOjs UI icon check-constructive.svg|40x40px|link=]]
 +
  | protected | protect | p  = [[File:{{#if:{{CASCADINGSOURCES:{{FULLPAGENAME}}}}|Cascade-protection-shackle.svg|{{#ifeq:{{PROTECTIONLEVEL:edit}}|sysop|Full-protection-shackle-red.svg|Semi-protection-shackle-no-text.svg}}}}|40x40px|link=]]
 +
  | semiprotected | semiprotect | semi = [[File:Semi-protection-shackle.svg|40x40px|link=]]
 +
  | #default = [[File:OOjs UI icon alert-destructive.svg|40x40px|link=]]
 +
  }}
 +
| style    =
 +
| textstyle =
 +
| text      = {{#switch: {{{1|}}}
 +
  | pre-alpha | prealpha | pa = <translate><!--T:1--> This module is rated as [[<tvar|1>Special:MyLanguage/Category:Modules in pre-alpha development</>|pre-αlpha]].</translate> <translate><!--T:2--> It is unfinished, and may or may not be in active development.</translate> <translate><!--T:3--> It should not be used from article namespace pages.</translate> <translate><!--T:4--> Modules remain pre-αlpha until the original editor (or someone who takes one over if it is abandoned for some time) is satisfied with the basic structure.</translate><!--
 +
  -->{{#switch: {{SUBPAGENAME}}|doc|sandbox=<!-- No category for /doc or /sandbox subpages -->
 +
      | {{#ifeq: {{{nocat|}}} | true | <!-- No category if user sets nocat=true --> | [[Category:Modules in pre-alpha development|{{PAGENAME}}]] }}
 +
      }}
 +
  | alpha | a                = This module is rated as [[:Category:Modules in alpha|αlpha]]. It is ready for third party input, and may be used on a few pages to see if problems arise, but should be watched. Suggestions for new features or changes in their input and output mechanisms are welcome.<!--
 +
  -->{{#switch: {{SUBPAGENAME}}|doc|sandbox=<!-- No category for /doc or /sandbox subpages -->
 +
      | {{#ifeq: {{{nocat|}}} | true | <!-- No category if user sets nocat=true --> | [[Category:Modules in alpha|{{PAGENAME}}]] }}
 +
      }}
 +
  | beta | b                  = This module is rated as [[:Category:Modules in beta|βeta]], and is ready for widespread use. It is still new and should be used with some caution to ensure the results are as expected.<!--
 +
  -->{{#switch: {{SUBPAGENAME}}|doc|sandbox=<!-- No category for /doc or /sandbox subpages -->
 +
      | {{#ifeq: {{{nocat|}}} | true | <!-- No category if user sets nocat=true --> | [[Category:Modules in beta|{{PAGENAME}}]] }}
 +
      }}
 +
  | release | r | general | g = This module is rated as [[:Category:Modules for general use|ready for general use]]. It has reached a mature form and is thought to be bug-free and ready for use wherever appropriate. It is ready to mention on help pages and other Wikipedia resources as an option for new users to learn. To reduce server load and bad output, it should be improved by [[:en:WP:TESTCASES|sandbox testing]] rather than repeated trial-and-error editing.<!--
 +
  -->{{#switch: {{SUBPAGENAME}}|doc|sandbox=<!-- No category for /doc or /sandbox subpages -->
 +
      | {{#ifeq: {{{nocat|}}} | true | <!-- No category if user sets nocat=true --> | [[Category:Modules for general use|{{PAGENAME}}]] }}
 +
      }}
 +
  | protected | protect | p  = This module is [[:Category:Modules subject to page protection|subject to {{#if:{{CASCADINGSOURCES:{{FULLPAGENAME}}}}|cascading|page}} protection]]. It is a highly visible module in use by a very large number of pages. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is [[Project:Protected page|protected]] from editing.<!--
 +
  -->{{#switch: {{SUBPAGENAME}}|doc|sandbox=<!-- No category for /doc or /sandbox subpages -->
 +
      | {{#ifeq: {{{nocat|}}} | true | <!-- No category if user sets nocat=true --> | [[Category:Modules subject to page protection|{{PAGENAME}}]] }}
 +
      }}
 +
  | #default                  = {{error|Module rating is invalid or not specified.}}
 +
  }}
 +
}}|{{error|Error: {{tl|Module rating}} must be placed in the Module namespace.}}|demospace={{{demospace|<noinclude>module</noinclude>}}}}}
 +
| #default=
 +
  {{#invoke:Template translation|renderTranslatedTemplate|template=Template:Module rating|noshift=1|uselang={{int:lang}}}}
 +
}}<noinclude>
  
 +
{{documentation}}
 +
<!-- Categories go on the /doc subpage, and interwikis go in Wikidata. -->
 +
</noinclude>

Latest revision as of 09:00, 5 September 2020


Module documentation[view] [edit] [history] [purge]

This template is used to rate Lua modules by quality. It is placed at the top of the module's /doc subpage. It produces a message informing users about the rating system, and it also places the module into a tracking category.

Usage

Basic usage:

{{module rating|rating}}

Without categories:

{{module rating|rating|nocat=true}}

If {{Module rating}} is used outside the Module namespace, an error message is displayed instead and will be categorized under Category:Pages with templates in the wrong namespace.

Ratings

The rating should be placed in the first positional parameter. There are five different ratings: pre-alpha, alpha, beta, release, and protected. There are also short alias codes for each of the ratings.

Rating Aliases Result
pre-alpha prealpha
pa
alpha a
beta b
release r
general
g
protected protect
p
semiprotected semiprotect
semi
Anything else or if missing

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Module rating

This template is used to rate Lua modules by quality. It is placed at the top of the module's /doc subpage. It produces a message informing users about the rating system, and it also places the module into a tracking category.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Rating1

One of pre-alpha, alpha, beta or release for quality, or one of protected or semiprotected, or an approved (see full docs) abbreviation for one of these.

Example
release
Stringrequired
Do not categorizenocat

Set to true to disable categorization by rating. Normally leave blank.

Default
Not set.
Booleanoptional
Fake namespacedemospace

Set to module to force template to display outside that namespace. Demonstration purposes only.

Default
Not set.
Example
module
Stringoptional



Categories

The template will put modules in one of the following categories, according to the rating specified:

These categories are suppressed on pages ending with /doc. To suppress categories on all pages, you can use the code |nocat=true.

See also