Template:Progress box/sandbox
This is the template sandbox page for Template:Progress box (diff). See also the companion subpage for test cases. |
This template is used on approximately 17,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
Usage
[edit]{{Progress box|Parent (undated) cat|Dated cat prefix if different from parameter 1|total cat name if not "All" followed by parameter 1}}
In the ideal configuration the template is extremely easy to use:
For example:
{{Progress box|Articles with weasel words}}
This is the complete set of parameters:
{{progress box | 1 = | 2 = | 3 = | count = | float = | from = | suffix = }}
Floating
[edit]It is often useful to float the intermediate templates (such as {{Weasel progress}}) right with the following code:
{{Progress box|Articles with weasel words|float=right}}
or better:
{{Progress box|Articles with weasel words|float={{{float|right}}}}}
to provide flexibility to the calling template.
Counting files and subcategories
[edit]If the template is supposed to be counting something other than regular pages, then you need to use the |count=
parameter. If you want to count files, use |count=files
, and if you want to count subcategories, use |count=subcats
. To find out what you are supposed to be counting, go to the base category, click through to a dated maintenance category, and look at the type of pages that are included.
Examples:
- For
{{Progress box|Articles with dead external links}}
: Category:Articles with dead external links has dated categories like Category:Articles with dead external links from April 2012, which contain pages like Adrian Monk. These are normal pages, so we don't need the|count=
parameter. - For
{{Progress box|User-created public domain files}}
: Category:User-created public domain files has dated categories like Category:User-created public domain files from February 2008, which contain pages like File:Canadian pointer2.jpg. These are files, so we need|count=files
. - For
{{Progress box|clean-up categories}}
: Category:clean-up categories has dated categories like Category:clean-up categories from April 2012, which contain pages like Category:Articles with unsourced statements from April 2012. These are categories, so we need|count=subcats
.
It is also possible to count the total number of pages, files, and subcategories by using |count=all
. This is discouraged, however, as it can lead to inaccurate counts if, for example, a user manually adds a subcategory to a dated category for counting regular pages.
Parameters
[edit]1
- the base (undated) category. (required)2
- the base of the dated categories, if different from the name specified in|1=
. (optional)3
- the "all" category, if it exists and uses a non-standard name. If not specified, the template will attempt to guess the name. (optional)count
- what kind of pages to count. Can be "pages" (the default), "files", "subcats" or "all". (optional)float
- the CSS "float" property for the template. This can be "left", "right", "both", or "none". The default value is "left". (optional)from
- for dated categories with names like "Articles for cleanup from 11 2024", this parameter can set a custom value to use instead of "from". (optional)suffix
- a suffix for dated categories. (optional)
Technical details
[edit]The template lists all non-empty categories since the date defined in Module:Progress box/config. Once all maintenance categories on Wikipedia for this date and earlier have been cleaned out, the value should be changed to the new earliest date for which articles exist. This is to minimise the number of expensive parser function calls needed to generate the template output.