Templat:WPBannerMeta/hooks/bchecklist/doc

Ini ialah sublaman pendokumenan untuk Templat:WPBannerMeta/hooks/bchecklist.
Ia mempunyai maklumat penggunaan, kategori dan kandungan lain yang bukan sebahagian daripada laman templat templat laman.

Jalan pintas

WP:BCHECKLIST

Templat ini digunakan dalam 1,200,000+ laman.
Untuk mengelakkan gangguan yang besar dan beban pelayan yang tidak diperlukan, perubahan kepada templat ini seharusnya hendaklah diuji di sublaman /kotak pasir atau /ujian templat ini, ataupun dalam atau di dalam sublaman pengguna. Perubahan yang sudah dicuba bolehlah ditambahkan dengan satu suntingan ke dalam templat ini. Sila bincangkan perubahan-perubahan tersebut terlebih dahulu pada laman perbincangan sebelum melaksanakannya.

This is the bchecklist hook which enables a B-class checklist to be incorporated into a banner template. There are six official criteria (although some projects use five) that an article needs to satisfy in order to be classified as B-class. A checklist can provide a helpful aid for editors to show where an article needs improvement.

When used in conjunction with a custom class mask, articles can be automatically demoted to C-class if they don't satisfy all of the criteria.

Syntax

{{WPBannerMeta
|PROJECT               = 
 |BANNER_NAME          = {{subst:FULLPAGENAME}}
 |small={{{small|}}}
 |category={{{category|}}}
 |listas = {{{listas|}}}

...

|HOOK_ASSESS = {{WPBannerMeta/hooks/bchecklist
 |BANNER_NAME={{subst:FULLPAGENAME}}
 |category={{{category|}}}
 |class={{{class|}}}
 |b1={{{b1|}}}
 |b2={{{b2|}}}
 |b3={{{b3|}}}
 |b4={{{b4|}}}
 |b5={{{b5|}}}
 |b6={{{b6|}}}
 |ASSESSMENT_LINK     = 
}}

Required parameters sunting

BANNER_NAME – needs to be passed, so that all the checklist will display on the template itself.
category – needs to be passed through.
class – needs to be passed so that the checklist is only displayed when it is appropriate;
The six B-Class criteria: b1, b2, b3, b4, b5, b6

Optional parameters sunting

ASSESSMENT_LINK – specifies a link to a custom assessment scale. If this is not specified, then the standard scale Wikipedia:Version 1.0 Editorial Team/Assessment/B-Class criteria will be used.
DISPLAY_ON_START – if set to "yes", the checklist will be displayed on every Start-class article. The default behaviour is to only display on Start-class when one or more of the parameters b1-b6 have been filled in.

Category parameters sunting

MAIN_CAT – specifies a category to use when any of the checklist parameters are blank.
B1_CAT to B6_CAT – specifies individual categories to use when the individual checklist parameters are blank or set to no.

Custom parameter names sunting

The standard parameter names (i.e. b1, b2, etc.) should be passed as an alternative to any custom parameters (e.g. B-Class-1, B-Class-2, etc.).

This is achieved by replacing **PARAMETER** with the name of the parameter. For example:

b1={{{B-Class-1|{{{b1|}}}}}}

If only the standard parameters are used, then eg: b1={{{b1|}}}, etc. is fine.

Subtemplates sunting

These are listed for technical background only.

/core - the code which actually produces the checklist
/criterion - code for each criterion
/syntax - for separate lines of the copy/paste code