Template:Talk header/doc: Difference between revisions
→Notes: And term2. |
Tag: Reverted |
||
Line 18: | Line 18: | ||
To add this template to a talk page, just open an edit of the talk page, and put {{tlc|Talk header}} at the top of the page. |
To add this template to a talk page, just open an edit of the talk page, and put {{tlc|Talk header}} at the top of the page. |
||
This template should be placed only where it's needed. Don't visit talk pages just to add this template, and don't place it on the talk pages of new articles. Talk pages that are frequently misused, that attract frequent or perpetual debate, articles often subject to controversy, and highly-visible or popular topics may be appropriate for this template. |
|||
By convention, this template goes at the very top of the talk page, above WikiProject templates and other talk-page banners. However, this is not an absolute rule, and editors should use common sense when deciding its placement. See also: {{section link|WP:Talk page layout|Lead (bannerspace)}}. |
By convention, this template goes at the very top of the talk page, above WikiProject templates and other talk-page banners. However, this is not an absolute rule, and editors should use common sense when deciding its placement. See also: {{section link|WP:Talk page layout|Lead (bannerspace)}}. |
||
In accordance with [[Wikipedia:Talk page guidelines|talk page guidelines]], this template '''''should not be added to otherwise empty talk pages'''''. That changes the "discussion" tab at the top of the page from a "redlink" into a "bluelink", which may mislead people into thinking there is discussion. |
|||
For more information on this topic, see the [[Template talk:Talk header|talk page]] for this template, including the talk archives and the [[Wikipedia:Templates for discussion|TfD]] logs. |
For more information on this topic, see the [[Template talk:Talk header|talk page]] for this template, including the talk archives and the [[Wikipedia:Templates for discussion|TfD]] logs. |
Revision as of 18:35, 26 December 2021
This is a documentation subpage for Template:Talk header. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 725,000 pages, or roughly 1% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
This template should not be substituted. |
This template should be used only when a talk page requires it. There is no need to add this template to every talk page. Do not create a talk page that contains only this template. |
This template uses TemplateStyles: |
This template is a signpost. It may be used on talk pages to attract commentary from inexperienced editors, or where there are high levels of debate from everyone. It provides:
- Intro – a short introduction and appropriate links for newcomers
- Policies – a reminder of important policies for experienced Wikipedians
- Find sources links – a set of links to aid in finding reliable sources for the article topic
- Archives – a list of links to the current talk page's archives, and a search box to search them
Usage
- Basic
{{Talk header}}
To add this template to a talk page, just open an edit of the talk page, and put {{Talk header}}
at the top of the page.
By convention, this template goes at the very top of the talk page, above WikiProject templates and other talk-page banners. However, this is not an absolute rule, and editors should use common sense when deciding its placement. See also: WP:Talk page layout § Lead (bannerspace).
For more information on this topic, see the talk page for this template, including the talk archives and the TfD logs.
Parameters
Full syntax – Vertical
{{talk header
|bottom= [a]
|disclaimer= [b]
|custom_header= [c]
|wp= [d]
|display_title= [e]
|arpol= [f]
|sc1= [g]
|sc2=
|sc3=
|sc4=
|sc5=
|demospace= [h]
|hide_find_sources= [i]
|search= [j]
|search_term1= [k]
|search_term2=
|search-domain= [l]
|noarchive= [m]
|age=
|bot=
|units=
|minthreadsleft=
}}
Horizontal
{{talk header |bottom= |disclaimer= |custom_header= |wp= |display_title= |arpol= |sc1= |sc2= |sc3= |sc4= |sc5= |demospace= |hide_find_sources= |search= |search_term1= |search_term2= |search-domain= |noarchive= |age= |bot= |units= |minthreadsleft= }}
Hiding the template
A registered user who prefers not to see this template on any talk page, may hide it from view. Note that this will hide page archive links and the archive search box as well if they are configured to be shown through this template. You'll need to have a named account to do this.
- Edit your user style page at Special:Mypage/common.css.
- Add a line:
#talkheader {display:none;}
- Save the change.
- Bypass your cache.
Portions of the template may be hidden for all viewers using a template parameter: see here to hide the "find sources" links; see here to hide the archive links.
Parts of the header
This section describes the different parts of the header. Each subsection below corresponds to one of the four main areas of functionality listed in the bullet items at the top, and explains which parameters are available to modify their appearance.
Intro and newcomer links
Basic tips for newcomers are boxed with a white background and appear top left, and includes starting a new section, using tildes to sign their posts, and how to get help.
Article policies
In the article namespace only, a box of "Article policies" is included by default.
In non-article namespaces, the "Article policies" box can be added via |arpol=yes
. For example:
{{talk header|arpol=yes|noarchive=yes|search=yes|User:$1|User:$2}}
Note: |arpol=no
is an invalid setting, and has no effect on header display in any namespace. The article policies may be suppressed by adding #talkheader .talkheader-policies{display:none}
to your common.css.
"Find sources" links
For article Talk pages, a set of "find sources" links appears by default in the Talk header box. The default links correspond to the output of Template:Find sources; see Talk:Europe for an example. These links appear after the initial article policies and links for newcomers, and above the archiving section. For the article Europe, it looks like this:
Find sources: Google (books · news · scholar · free images · WP refs) · FENS · JSTOR · TWL |
Background
There are several flavors of "find sources" links (medical, video, general) targeted to different search domains. The flavor of "find sources" links displayed in the Talk header depends on WikiProject membership of the article and may correspond to one of these:
- {{find medical sources}} – for articles in the medical search domain
- {{find video game sources}} – for articles in the video game search domain
- {{find general sources}} – the default, for everything else, is the general domain.
The default search domain is "general", which is the large majority of all Talk pages, and displays the links found in template {{find general sources}}. The search domain is determined automatically by the template, depending on the presence of the corresponding WikiProject. If an article belongs to WikiProject Medicine, it is in the medical search domain by default; if it belongs to WikiProject Video games, it is in the video game search domain by default. (If it is in both, then the highest domain in the list above is chosen; i.e, 'medical'.)
For the page Talk:Giardiasis, which belongs to WP:WikiProject Medicine, it looks like this:
Find medical sources: Source guidelines · PubMed · Cochrane · DOAJ · Gale · OpenMD · ScienceDirect · Springer · Trip · Wiley · TWL |
You can modify the nature of the source links displayed by hiding the links, modifying the query terms, or by modifying the search domain.
Hiding the links
By default, these links do not appear outside of Talk space.
Within article Talk space, the "find sources" links may be suppressed by setting parameter |hide_find_sources=yes
.
Modifying the "find sources" query terms
The find sources links use the article title by default as the search term and forms an "exact search" (or "double-quoted query")[n] from the title. If the article title contains parenthetical disambiguation portion, this is appended after the exact search query term, as an additional, unquoted phrase.
In place of the default, the query terms may be specified by using |search_term=
(alias: |search_term1=
) to specify the exact search string. Parameter |search_term2=
may be added to specify additional, unquoted query terms, as many as desired.
Search domain override
The default domain chosen by automatic WikiProject detection can be overridden using param |search-domain=
:
|search-domain=medical
– usemedical
as the search domain, regardless what projects it belongs to (value alias:med
)|search-domain=video game
– usevideo games
as the search domain, regardless what projects it belongs to (value alias:video
, andvg
))|search-domain=general
– usegeneral
as the search domain, regardless what projects it belongs to (value alias:gen
)
The parameter alias |domain=
may be used instead; thus, |domain=med
means the same thing as |search-domain=medical
.
Archives
Links to Talk page archives and an archive search box are displayed automatically at the bottom of this template when used on a talk page that has archives that are named in the standard way. A link to the archive index is also displayed if it is named "/Archive index". If no archives exist for the current talk page, or if they exist but have non-standard names, no archive links will be displayed.
The parameter |noarchive=yes
may be used to suppress the archive links and search box.
Links to archives
If present, a link to the archive index, and links to archives are displayed. They look like this (example shown is for Talk:Europe):
Auto-archiving period 180 days Archives: Index, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 |
The bot notice containing the text "Auto-archiving period" at the right is controlled by the four related parameters: |bot=
, |age=
, |units=
, and |minthreadsleft=
.
Bot notice
If the page is auto-archived by a bot, the bot notice appears to the right of the archive index links, as in the example shown above.
The following parameters contribute to a small notification that the talk page is archived by a bot (typically by Lowercase sigmabot III or ClueBot III). The template will include a tooltip informing readers of the amount of time before discussions are archived. This tooltip will not be shown if there are no archives to be listed.
{{talk header|bot=lowercase sigmabot III|age=30|units=days}}
This informs the user the lowercase sigmabot III bot will autoarchive talk page sections that are older than 30 days. (See #Examples.)
{{talk header|bot=lowercase sigmabot III|age=6|units=months|minthreadsleft=4}}
This informs the user the lowercase sigmabot III bot will autoarchive talk page sections that are older than 6 months, as long as at least 4 sections remain. (See #Examples.)
These parameters are for informational purposes, not to actually set up archiving. Please see WP:AUTOARCHIVE for instructions. For an alternative template to inform readers of automatic archiving settings, see {{Archives}}.
|bot=
The bot used to archive the page, unwikilinked.
|age=
Enter a number to convey the amount of time the bot is set to wait for until archiving a discussion as expressed as a number of time units, as set by the units
parameter.
|units=
Enter a string to convey the unit the age
parameter refers to. Useful examples include days, month, months etc
|minthreadsleft=
The amount of threads the bot will leave. The tooltip will include a message telling the reader that after minthreadsleft
threads, threads older than age
will be archived.
Search box
The archive search box may be used to search the Talk page archives. If present, the search box appears below the Archiving links, and is the last element to appear:
In this working example, entering search terms searches the talk page archives of the article Europe.
Testing issues
Find sources testing
For testing and demonstration purposes, this template can take a parameter named demospace which enables testing of the find sources opt-out parameter |hide_find_sources=
from other namespaces.
- If
demospace
has the value main or the value 1 it returns the findsources text it would normally return when transcluded from mainspace. - It
demospace
any other value such as the name of some other namespace it returns the text it would if transcluded outside of mainspace. - If the parameter is empty or undefined, the actual page type determines the result.
The dynamic features of WikiProject autodetection and search domain override depend on the article title where it appears, and therefore cannot be tested in the normal way. The testcases page provides an explanation of how to test these features using Special:ExpandTemplates with the ContextTitle enabled, or by using in situ testing.
Examples
Archiving notice
The following parameters contribute to a small notification that the talk page is archived by a bot (typically by Lowercase sigmabot III or ClueBot III). The template will include a tooltip informing readers of the amount of time before discussions are archived. This tooltip will not be shown if there are no archives to be listed.
{{talk header|bot=lowercase sigmabot III|age=30|units=days}}
This is the talk page for discussing improvements to the Talk header/doc template. |
|
Archives: 1 |
This informs the user the lowercase sigmabot III bot will autoarchive talk page sections that are older than 30 days.
{{talk header|bot=lowercase sigmabot III|age=6|units=months|minthreadsleft=4}}
This is the talk page for discussing improvements to the Talk header/doc template. |
|
Archives: 1 |
This informs the user the lowercase sigmabot III bot will autoarchive talk page sections that are older than 6 months, as long as at least 4 sections remain.
TemplateData
A signpost for the top of talk pages
Parameter | Description | Type | Status | |
---|---|---|---|---|
Shortcut | 1 shortcut shortcut1 sc sc1 | Shortcut that will display similar to the {{shortcut}} template, but within the Talk header message box
| Page name | suggested |
Shortcut 2 | 2 shortcut2 sc2 | A second shortcut | Page name | optional |
Shortcut 3 | 3 shortcut3 sc3 | A third shortcut | Page name | optional |
Shortcut 4 | 4 shortcut4 sc4 | A fourth shortcut | Page name | optional |
Shortcut 5 | 5 shortcut5 sc5 | A fifth shortcut | Page name | optional |
bottom | bottom | Set to "yes" to add additional instructions at the top to "please place new discussions at the bottom of the talk page"
| Boolean | optional |
small | small | no description | Unknown | optional |
disclaimer | disclaimer | Set to "yes" to add an additional banner which identifies the page as being originally from Wikipedia (and modify the width to suit), matching the style of {{User page}}. | Boolean | optional |
Custom header | custom_header | Replaces the entire header with customized text | Line | optional |
WikiProject? | wp | For use on WikiProject talk pages; set to "yes" to add "and anything related to its purposes and tasks" to the header | Boolean | optional |
Display title | display_title | Displays a custom page title | String | optional |
Article policies | arpol | Adds a link to the article policy pages
| Boolean | optional |
demospace | demospace | no description | Unknown | optional |
Hide find sources? | hide_find_sources | Set to "yes" to hide the find sources banner on article talk pages | Boolean | optional |
Search term | search_term search_term1 | Changes the search term used in the {{find sources}} module | String | optional |
search_term2 | search_term2 | no description | Unknown | optional |
Search domain | search-domain domain | Changes the default search domain used in the {{find sources}} module
| String | optional |
No archives? | noarchive noarchives archives | Set to "yes" to hide the archives links | Boolean | optional |
Archive age | archive_age age | Amount of time, by default in days, before discussions will be automatically archived. Note: Does not actually trigger automatic archiving; see [[WP:ARCHIVE]]. | Number | suggested |
Archive bot | archive_bot bot | The bot used to archive the page. Note: Does not actually trigger automatic archiving; see [[WP:ARCHIVE]].
| String | suggested |
Archive units | archive_units units | The units for archive_age
| String | optional |
Minimum threads left | minthreadsleft | The number of threads the archiving bot will leave. Currently affects only the tooltip. | Number | suggested |
search | search | Set to "no" to override the default behavior for the search box appearance | Boolean | optional |
Tracking categories
See also
- {{New discussion}}
- {{Not a forum}}
- {{Portal talk}}
- {{Skip to talk}}
- {{WikiProject banner shell}}
- Wikipedia:Template index/Talk namespace
- Wikipedia:Template index/User talk namespace
- MediaWiki:Talkpagetext
Notes
- ^ To add additional instructions at the top to "please place new discussions at the bottom of the talk page", use
|bottom=yes
. - ^ On user talk pages,
|disclaimer=yes
adds an additional banner which identifies the page as being originally from Wikipedia (and modifies the width to suit), matching the style of{{User page}}
. - ^ To replace the entire header with customized text, use
|custom_header=Custom header text goes here
- ^ For use on WikiProject talk pages, the parameter
|wp=yes
can be included to add "and anything related to its purposes and tasks." to the top line of the banner. - ^ To display a custom page title, use
|display_title=custom page title
- ^ "Article policies" can be added to talk headers in non-article namespaces by adding
|arpol=yes
. (See below in #Article policies for an example) - ^ Up to five shortcuts can be added to the template, as unnamed parameters, or as named ones (any of
|1=
,|sc=
,|sc1=
,|shortcut=
or|shortcut1=
, then|2=
,|sc2=
or|shortcut2=
, etc., will work). For example,{{Talk header|WP:SHOR|WP:TCUT}}
. They will display similar to the{{shortcut}}
template, but within the Talk header message box. - ^ For additional information on
|demospace=
see #Testing issues. - ^ To hide "Find sources" on article talk pages, use
|hide_find_sources=yes
. More details at #"Find sources" links and #Testing issues below. - ^ To override the default behaviour for the search box appearance, use
|search=no
. The default is yes, when archive subpages exist. - ^ To override the article title as the default search used by "Find sources" links, use params
|search_term1=
and|search_term2=
. Details at #Modifying the "find sources" query terms below. - ^ To override the search domain chosen automatically by the template, use
|search-domain=domain value
; choosemedical
(ormed
),video game
(orvideo
, orvg
), orgeneral
(gen
). Alias:|domain=
. See details at #Search domain override below. - ^ Archive links and an archive search box are displayed automatically at the bottom of the template. Use parameter
|noarchive=yes
to suppress display of the archive links and search box. See section #Archives below. - ^ Exact search is also known as a "double-quoted query" because major search engines interpret paired double-quote characters as indicating that everything between the double quotes must be found exactly as specified.