Jump to content

Template:Talkback/doc: Difference between revisions

From Wikipedia, the free encyclopedia
Content deleted Content added
m Reverted edits by 69trololol69 (talk) (HG)
top: {{Template shortcut}} & {{Template redirect}}
 
(42 intermediate revisions by 32 users not shown)
Line 1: Line 1:
{{Redirect|Template:Feedback|the set of templates allowing collection of feedback|Template:Leave feedback}}
{{Documentation subpage}}
{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
<includeonly>{{Intricate}}</includeonly>
{{high-use}}
<!--
PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE
-->
{{high-risk|56,600}}
{{Friendly standard installation}}
{{Friendly standard installation}}
{{RedWarn standard installation}}
{{shortcut|WP:TBACK}}
{{nosubst}}
{{hatnote|'''For registered users, this template has generally been obsoleted and deprecated by [[Wikipedia:Notifications]] and [[Template:Reply to]].'''}}
{{Template shortcut|tb|rsvp}}
{{Template redirect|User reply|Feedback}}

==Purpose==
==Purpose==
In simplest terms, talkback allows [[wp:user|a user]] (''user1'') to direct the attention of another user (''user2'') to a discussion on a specific talk page.

In simplest terms, talkback allows a user (''user1'') to direct the attention of another user (''user2'') to a discussion on a specific talk page.


One benefit of this tool is to maintain the flow of a discussion on a single user's talk page, rather than having to switch back and forth between talk pages in order to make sense of the conversation.
One benefit of this tool is to maintain the flow of a discussion on a single user's talk page, rather than having to switch back and forth between talk pages in order to make sense of the conversation.
Line 16: Line 16:
Two examples of the use of this template are:
Two examples of the use of this template are:


* If you receive a message from a user, you can notify the user that you have responded to his/her message on your own talk page.
* If you receive a message from a user, you can notify the user that you have responded to their message on your own talk page.
* If you create a topic on your talk page, you can notify a user that the discussion might need his/her attention.
* If you create a topic on your talk page, you can notify a user that the discussion might need their attention.


==Usage==
==Usage==

In this discussion, it is assumed that you (the sender) are ''user1'' and that ''user2'' is the recipient.
In this discussion, it is assumed that you (the sender) are ''user1'' and that ''user2'' is the recipient.


===First message===
===First message===
Place this template under a new section at the bottom of ''user2'''s talk page.<ref>Originally, this template was meant to be placed on top of ''user2''<nowiki>'</nowiki>s talk page.</ref> To use this template to direct the attention of another Wikipedian to your talk page:
Place this template under a new section at the bottom of ''user2''{{'}}s talk page.

To use this template to direct the attention of another Wikipedian to your talk page:


#Go to the recipient's talk page. User talk pages start with "User talk:" prefix.
#Go to the recipient's talk page. User talk pages start with "User talk:" prefix.
Line 30: Line 31:
#In the "Subject/headline" box, type "Re: " and the subject of the original discussion.
#In the "Subject/headline" box, type "Re: " and the subject of the original discussion.
#In the message section, enter one of the following (remember, you are ''user1''):
#In the message section, enter one of the following (remember, you are ''user1''):
#*Simple form: This is the simplest way to use this template:<blockquote>{{tlx|{{BASEPAGENAME}}|''user1''}}</blockquote>.
#*Simple form: This is the simplest way to use this template:<br/><code>{{tlx|{{BASEPAGENAME}}|''user1''}}</code>.
#*More accurate form: This form has an additional parameter but takes the reader right to the section in which the discussion is in progress:<blockquote>{{tlx|{{BASEPAGENAME}}|''user1''|''section''}}</blockquote>
#*More accurate form: This form has an additional parameter which takes the reader right to the section in which the discussion is in progress:<br/><code>{{tlx|{{BASEPAGENAME}}|''user1''|''section''}}</code>
#*Recommended form: This form is complete and recommended. It adds a timestamp:<blockquote>{{tlx|1={{BASEPAGENAME}}|2=''user1''|3=''section''|4=ts = <nowiki>~~~~~</nowiki>}}</blockquote>Instead of five tildes (<nowiki>~~~~~</nowiki>), you can enter any date and time.
#*Recommended form: This form is complete and recommended. It adds a timestamp:<br/><code>{{tlx|1={{BASEPAGENAME}}|2=''user1''|3=''section''|4=ts = <nowiki>~~~~~</nowiki>}}</code>Instead of five tildes (<nowiki>~~~~~</nowiki>), you can enter any date and time.
#Save the page.
#Save the page.


Wikipedia will notify ''user2'' of having a new message in his/her talk page. When (s)he visits his/her talk page, (s)he should see your notice and (hopefully) follow the link to your user talk page.
Wikipedia will notify ''user2'' of having a new message in their talk page. When they visit their talk page, they should see your notice and (hopefully) follow the link to your user talk page.


====Example====
====Example====
For example, this code:
For example, this code:<br/>
<code>
<blockquote>
<nowiki>== Re: Testing on Wikipedia ==</nowiki><br/>
<pre>
== Re: Testing on Wikipedia==
<nowiki>{{Talkback|Sandbox|Testing on Wikipedia|ts = ~~~~~}}</nowiki>
</code>
{{Talkback|Sandbox|Testing on Wikipedia|ts = ~~~~~}}
</pre>
</blockquote>


Generates:
Generates:
Line 59: Line 58:
So, what if you had another reply for the same user in the same topic? In case you think that the recipient has not visited your user talk page since you inserted the {{tld|{{BASEPAGENAME}}}} notice, simply do nothing. On the other hand, if the discussion continued and you think the recipient must once again read what you have posted, you can simply do one of the following:
So, what if you had another reply for the same user in the same topic? In case you think that the recipient has not visited your user talk page since you inserted the {{tld|{{BASEPAGENAME}}}} notice, simply do nothing. On the other hand, if the discussion continued and you think the recipient must once again read what you have posted, you can simply do one of the following:
#Do nothing. Most of the time, Wikipedians keep their correspondents' user talk pages in their watchlists and will see when another reply is posted.
#Do nothing. Most of the time, Wikipedians keep their correspondents' user talk pages in their watchlists and will see when another reply is posted.
#Update the <tt>ts</tt> parameter. Simply edit the recipient's user talk page and replace the time and date in the <tt>ts</tt> parameter with a new time and date (or with <nowiki>~~~~~</nowiki>). This will notify the user.
#Update the <code>ts</code> parameter. Simply edit the recipient's user talk page and replace the time and date in the <code>ts</code> parameter with a new time and date (or with <nowiki>~~~~~</nowiki>). This will notify the user.
#Add another {{tld|{{BASEPAGENAME}}}} in the same section under the first one. However, the recipient user might find this obtrusive.
#Add another {{tld|{{BASEPAGENAME}}}} in the same section under the first one. However, the recipient user might find this obtrusive.


Line 65: Line 64:
To have the links point to a '''non'''-user talk page, you must include the full talk page link.
To have the links point to a '''non'''-user talk page, you must include the full talk page link.


*{{tld|1={{BASEPAGENAME}}|2=Talk:<Page name>|3=[Section title]|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tlx|1={{BASEPAGENAME}}|2=Talk:''page name''|3=''section title''|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tld|1={{BASEPAGENAME}}|2=Category talk:<Page name>|3=[Section title]|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tlx|1={{BASEPAGENAME}}|2=Category talk:''page name''|3=''section title''|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tld|1={{BASEPAGENAME}}|2=File talk:<Page name>|3=[Section title]|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tlx|1={{BASEPAGENAME}}|2=File talk:''page name''|3=''section title''|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tld|1={{BASEPAGENAME}}|2=Template talk:<Page name>|3=[Section title]|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tlx|1={{BASEPAGENAME}}|2=Template talk:''page name''|3=''section title''|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tld|1={{BASEPAGENAME}}|2=Wikipedia talk:<Page name>|3=[Section title]|4=ts=<nowiki>~~~~~</nowiki>}}
*{{tlx|1={{BASEPAGENAME}}|2=Wikipedia talk:''page name''|3=''section title''|4=ts=<nowiki>~~~~~</nowiki>}}

For example, suppose talkback should be used to link to [[Help talk:Using talk pages#Message notification formatting]]:
;Example:
*{{tld|1={{BASEPAGENAME}}|2=Help talk:Using talk pages|3=Message notification formatting|4=ts=<nowiki>~~~~~</nowiki>}}


===Notes===
===Notes===
{{reflist}}
* Do not [[Wikipedia:Template substitution|substitute]] this template!
* Do not [[Wikipedia:Template substitution|substitute]] this template!
* Do not insert this template in a section header; use it on a line by itself
* Do not insert this template in a section header; use it on a line by itself

==Redirects==
*{{tlx|Tb}}
*{{tlx|Reply}}


==Announcing your conversation policy==
==Announcing your conversation policy==
Line 86: Line 86:
{{Usertalkback|you=watched}}
{{Usertalkback|you=watched}}


'''''NOTE:''''' These examples say "<nowiki>{{Talkback|Talkback}}</nowiki>" only because ''this page'' is for Talkback. In real use they would show your own username: "<nowiki>{{Talkback|</nowiki>''user1''<nowiki>}}</nowiki>". Where the first example says "<nowiki>{{Talkback|</nowiki><u>''your username''</u><nowiki>}}</nowiki>", it would appear just like that: The "you" there is addressed to the person reading the notice that the <code><tt>Usertalkback</tt></code> template will put at the top of your User Talk page.
'''''NOTE:''''' These examples say "<nowiki>{{Talkback|Talkback}}</nowiki>" only because ''this page'' is for Talkback. In real use they would show your own username: "<nowiki>{{Talkback|</nowiki>''user1''<nowiki>}}</nowiki>". Where the first example says "<nowiki>{{Talkback|</nowiki><u>''your username''</u><nowiki>}}</nowiki>", it would appear just like that: The "you" there is addressed to the person reading the notice that the <code>Usertalkback</code> template will put at the top of your User Talk page.



You might, however, like to make a custom message using {{tl|mbox}} or {{tl|notice}}.
You might, however, like to make a custom message using {{tl|mbox}} or {{tl|notice}}.


==Redirects==
*{{tlx|Tb}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
<templatedata>
{
{
Line 110: Line 114:
}
}
</templatedata>
</templatedata>

==See also==
==See also==
* <!--
-->[[User:Qwerfjkl/scripts/talkback{{!}}User:Qwerfjkl/scripts/talkback]]<!--Write piped link to article
-->{{#if: |&nbsp;()|}}<!--If parameter abbreviation exists, write abbreviation in parentheses with leading space
-->{{#if: |, also known as |}}<!--If parameter aka exists, write following standard prefix string
-->{{#switch:{{Template parameter value|User:Qwerfjkl/scripts/talkback|Short description|1|1|1}}||blank|none|null|not required|redundant|&nbsp;=|<!--Test for null Short description cases. If found do nothing.
-->&nbsp;&ndash; {{#invoke:String|replace|{{Template parameter value|User:Qwerfjkl/scripts/talkback|Short description|1|1|1}}|pattern=1=|}} }}<!-- If not null, get and write short description for capitalised template
-->{{#switch:{{Template parameter value|User:Qwerfjkl/scripts/talkback|short description|1|1|1}}||blank|none|null|not required|redundant|&nbsp;=|<!--Test for null short description cases. If found do nothing.
-->&nbsp;&ndash; {{#invoke:String|replace|{{Template parameter value|User:Qwerfjkl/scripts/talkback|short description|1|1|1}}|pattern=1=|}} }}<!-- If not null, get and write short description for uncapitalised template
-->
{{Talkback see also}}
{{Talkback see also}}


<includeonly>{{Sandbox other||
==Notes==
<!-- Categories below this line, please; interwikis at Wikidata -->
{{reflist}}

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->

[[Category:User namespace templates]]
[[Category:User namespace templates]]
}}</includeonly>


</includeonly>

Latest revision as of 03:33, 18 August 2023

Purpose

In simplest terms, talkback allows a user (user1) to direct the attention of another user (user2) to a discussion on a specific talk page.

One benefit of this tool is to maintain the flow of a discussion on a single user's talk page, rather than having to switch back and forth between talk pages in order to make sense of the conversation.

Two examples of the use of this template are:

  • If you receive a message from a user, you can notify the user that you have responded to their message on your own talk page.
  • If you create a topic on your talk page, you can notify a user that the discussion might need their attention.

Usage

In this discussion, it is assumed that you (the sender) are user1 and that user2 is the recipient.

First message

Place this template under a new section at the bottom of user2's talk page.

To use this template to direct the attention of another Wikipedian to your talk page:

  1. Go to the recipient's talk page. User talk pages start with "User talk:" prefix.
  2. On the top of the page, click on "New Section" button/link. It should look like this:
  3. In the "Subject/headline" box, type "Re: " and the subject of the original discussion.
  4. In the message section, enter one of the following (remember, you are user1):
    • Simple form: This is the simplest way to use this template:
      {{Talkback|user1}}.
    • More accurate form: This form has an additional parameter which takes the reader right to the section in which the discussion is in progress:
      {{Talkback|user1|section}}
    • Recommended form: This form is complete and recommended. It adds a timestamp:
      {{Talkback|user1|section|ts = ~~~~~}}Instead of five tildes (~~~~~), you can enter any date and time.
  5. Save the page.

Wikipedia will notify user2 of having a new message in their talk page. When they visit their talk page, they should see your notice and (hopefully) follow the link to your user talk page.

Example

For example, this code:
== Re: Testing on Wikipedia ==
{{Talkback|Sandbox|Testing on Wikipedia|ts = ~~~~~}}

Generates:

Re: Testing on Wikipedia
Hello, Talkback. You have new messages at Sandbox's talk page.
Message added 12:49, 13 April 2012 (UTC). You can remove this notice at any time by removing the {{Talkback}} or {{Tb}} template.

NOTE: This example says "Hello, Talkback" only because this page is for Talkback. In real use it would have the name of the recipient: "Hello, user2".

Shortcut

Instead of manually typing out the username parameter, you may use {{subst:Mytalk}}, which automatically inserts your username.

Second message

So, what if you had another reply for the same user in the same topic? In case you think that the recipient has not visited your user talk page since you inserted the {{Talkback}} notice, simply do nothing. On the other hand, if the discussion continued and you think the recipient must once again read what you have posted, you can simply do one of the following:

  1. Do nothing. Most of the time, Wikipedians keep their correspondents' user talk pages in their watchlists and will see when another reply is posted.
  2. Update the ts parameter. Simply edit the recipient's user talk page and replace the time and date in the ts parameter with a new time and date (or with ~~~~~). This will notify the user.
  3. Add another {{Talkback}} in the same section under the first one. However, the recipient user might find this obtrusive.

Pointing to other talk pages

To have the links point to a non-user talk page, you must include the full talk page link.

  • {{Talkback|Talk:page name|section title|ts=~~~~~}}
  • {{Talkback|Category talk:page name|section title|ts=~~~~~}}
  • {{Talkback|File talk:page name|section title|ts=~~~~~}}
  • {{Talkback|Template talk:page name|section title|ts=~~~~~}}
  • {{Talkback|Wikipedia talk:page name|section title|ts=~~~~~}}

For example, suppose talkback should be used to link to Help talk:Using talk pages#Message notification formatting:

Example
  • {{Talkback|Help talk:Using talk pages|Message notification formatting|ts=~~~~~}}

Notes

  • Do not substitute this template!
  • Do not insert this template in a section header; use it on a line by itself

Announcing your conversation policy

If you are going to use this template, please consider putting {{Usertalkback}} on the top of your own talk page. It generates:

You may also use {{Usertalkback|you=watched}}, which tells your visitors not to use {{Talkback}}. It generates:

NOTE: These examples say "{{Talkback|Talkback}}" only because this page is for Talkback. In real use they would show your own username: "{{Talkback|user1}}". Where the first example says "{{Talkback|your username}}", it would appear just like that: The "you" there is addressed to the person reading the notice that the Usertalkback template will put at the top of your User Talk page.

You might, however, like to make a custom message using {{mbox}} or {{notice}}.

Redirects

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Talkback in articles based on its TemplateData.

TemplateData for Talkback

A template for notifying users that they have messages waiting on other pages

Template parameters

ParameterDescriptionTypeStatus
User name1

The username of the recipient.

Stringrequired
Status2

The linked page or page section

Stringoptional

See also

  • {{Talkback}} – the original, large "you have new messages" notice to put on other users' talk pages
    • {{subst:Mytalk}} – invokes the talkback template and automatically fills in your username
    • {{Talkbacktiny}} – a somewhat smaller version of {{Talkback}}
  • {{Interwiki talkback}} – a "you have new messages" notice to put on other users' talk pages for interwiki purposes
  • {{Whisperback}} – a less obtrusive template than {{Talkback}}, with more features and without the box
  • {{You've got mail}} – like {{Talkback}} but to notify of an offsite e-mail
  • {{Please see}} – similar to {{Whisperback}}, but notifying others of a topic they may wish to participate in
  • {{Discussion notice}} – an alternative to {{Please see}}, similar to {{ANI-notice}}
  • {{Usertalkback}} and {{Userwhisperback}} – notices for the top of one's own user talk page, so as to inform your interlocutors of your user discussion preferences
  • {{FYI}} – icon box to give a visual hint to readers of talk page items
  • {{Notified}} – disclosure indicating that a notification has been posted on another page
  • {{Reply to}} – ping a user without posting on their talk page (uses the mentions notification)
  • {{Response}} – to direct the attention of another user to a discussion on a specific talk page
  • {{No talkback}} – opt-out of talkback messages from Twinkle