Place the template where you want the content displayed:
((User:JL-Bot/Project content |project parameter (see below) |content parameters (see below) |optional parameters (see below) ))
To hide the message box at the top, simply use
The template contains no content so it does not impact the visual appearance of the page which transcludes it.
Only use this in the following namespaces:
While it will technically work in the following namespaces
it should normally not be used there (at least on the root of talk pages of Portals and WikiProject).
The project parameter defines how the bot is to identify project content. One of the two following parameters needs to be provided:
|template = Name of project template
|category = Name of project category
template parameter needs to have the name of the talk page template that is used by the project to identify articles within its scope. For example, WikiProject Physics uses the ((WikiProject Physics)) template so the parameter for them would be
|template = WikiProject Physics. If there are redirects to the template (ex. ((WP Physics)) → ((WikiProject Physics))), pages tagged with the redirect will still be picked up as they show up in the target's transclusions. However, do not use a redirect as the template name as only pages tagged with the redirect will be picked up.
category parameter needs to have the name of the category that is used by the project to identify articles within its scope.
If the project's template can be "merged" into another project's template (example), then the
category parameter is probably a better option as not all the project's articles will be tagged with the template.
category parameters can be specified and the bot will pick up articles in all the templates and categories specified. This can be useful in cases such as portals with multiple applicable projects.
|template1 = Name of project template one
|template2 = Name of project template two
The content parameters define the content types to be listed. The following types are supported:
|content-featured-articles-- lists Category:Wikipedia featured articles content
|content-former-featured-articles-- lists Category:Wikipedia former featured articles content
|content-featured-lists-- lists Category:Wikipedia featured lists content
|content-former-featured-lists-- lists Category:Wikipedia former featured lists content
|content-good-articles-- lists Category:Wikipedia good articles content
|content-former-good-articles-- lists Category:Delisted good articles content
|content-did-you-know-articles-- lists Category:Wikipedia Did you know articles content
|content-featured-pictures-- lists Category:Featured pictures content
|content-former-featured-pictures-- lists Category:Wikipedia former featured pictures content
|content-featured-portals-- lists Category:Wikipedia featured portals content
|content-former-featured-portals-- lists Category:Wikipedia former featured portals content
|content-featured-article-candidates-- lists Category:Wikipedia featured article candidates content
|content-featured-list-candidates-- lists Category:Wikipedia featured list candidates content
|content-good-article-nominees-- lists Category:Good article nominees content
|content-a-class-articles = Name of project A-Class category-- lists specified category's content
|content-b-class-articles = Name of project B-Class category-- lists specified category's content
|content-c-class-articles = Name of project C-Class category-- lists specified category's content
|content-mainpage-in-the-news-- lists Category:Wikipedia In the news articles content
|content-mainpage-featured-- lists Category:Featured articles that have appeared on the main page content
|content-mainpage-lists-- lists Category:Featured lists that have appeared on the main page content
|content-picture-of-the-day-- lists Template:Picture of the day content
|content-featured-topics-- lists Category:Featured topics & Category:Wikipedia fully featured topics content
|content-former-featured-topics-- lists Category:Wikipedia former featured topics content
|content-good-topics-- lists Category:Wikipedia Good topics content
|content-featured-sounds-- lists Category:Featured sounds content
|content-vital-articles-level-1-- lists Category:All Wikipedia level-1 vital articles content
|content-vital-articles-level-2-- lists Category:All Wikipedia level-2 vital articles content
|content-vital-articles-level-3-- lists Category:All Wikipedia level-3 vital articles content
|content-vital-articles-level-4-- lists Category:All Wikipedia level-4 vital articles content
|content-vital-articles-level-5-- lists Category:All Wikipedia level-5 vital articles content
The content will be listed in the order the parameters appear in the template.
content-[abc]-class-articles parameters can be specified and the bot will list the articles from all the specified categories.
|content-a-class-articles1 = Name of project A-Class category one
|content-a-class-articles2 = Name of project A-Class category two
The following optional parameters are supported:
compactoption overrides the
maximumoption only applies when the
compactoption is set.
smalloption only applies when the
compactoption is set.
headingoption allows for 0 and 2-6. A value of 2-6 defines the heading level (i.e. the number of "="s to use). A value of 0 means to not use a formal heading level, but instead use the ";Title" syntax.
noheadingoption overrides the
<gallery></gallery>syntax if the
pictures-listoption is not set.
heights=option at Help:Gallery tag)
sortingoption may be set to
default(sort by DEFAULTSORT key),
date-default(sort Main Page content by date, remainder by DEFAULTSORT key), and
date-alpha(sort Main Page content by date, remainder alphabetically). The default is
defaultif not specified.
date-orderoption may be set to
decreasing. This option only applies when the
sortingoption is set to
date-alpha. The default is
increasingif not specified.
maximum. These options only apply when the
maximumoption is set. They allow a page name to be specified that will be added as a link after the maximum number of articles are outputted. This is designed to allow linking to a page that contains a full listing of the content type. See this page for an usage example.
dyk-blurboption displays the DYK blurb (if available) instead of the page name. If a number is specified, then the first
Nblurbs will be displayed normally and the remaining blurbs will be wrapped in
<include></noinclude>. This can be used to limited the number of blurbs that are transcluded onto another page.
italicsoption will display pages marked as ((italic title))s in italics. If the page title ends in a parenthesized text, only the part before the parenthesizes will be italicized. However, it does not support the
|stringparameter (allowing a subset of the title to be in italics) or other italic templates that require parsing the page content to determine what portion of the title is to be italicized. This option should only be utilized if those limitations are suitable for the recognized content being displayed.
textin the wikitext output.
The results will be written to same page as the template. They will be prefaced by a comment header and followed by a comment footer. This header and footer are not visible on the displayed page, but are needed to allow the bot to identify prior results.
<!-- Start of content generated by JL-Bot -->
<!-- End of content generated by JL-Bot -->
If the bot doesn't find a valid header and footer (ex. first run), it will place the results immediately below the template. If it does find a valid header and footer (updates), it will replace the content between the header and footer with the new results.
((User:JL-Bot/Project content |template = <!-- name of WikiProject template without the prefix "Template:" --> |content-featured-articles |content-former-featured-articles |content-featured-lists |content-former-featured-lists |content-good-articles |content-former-good-articles |content-did-you-know-articles |content-featured-pictures |content-former-featured-pictures |content-featured-portals |content-former-featured-portals |content-featured-article-candidates |content-featured-list-candidates |content-good-article-nominees |content-a-class-articles = |content-b-class-articles = |content-c-class-articles = |content-mainpage-in-the-news |content-mainpage-featured |content-mainpage-lists |content-picture-of-the-day |content-featured-topics |content-former-featured-topics |content-good-topics |content-featured-sounds |content-vital-articles-level-1 |content-vital-articles-level-2 |content-vital-articles-level-3 |content-vital-articles-level-4 |content-vital-articles-level-5 |columns = 2 |heading = 3 |icons )) <!-- Start of content generated by JL-Bot --> <!-- End of content generated by JL-Bot -->