Template:Reply to/doc
This is a documentation subpage for Template:Reply to. It may contain usage information, categories and other content that is not part of the original template page. |
Usage
This template triggers a notification to one or several registered user(s) you are replying to in a discussion. It is a replacement for the {{talkback}} template. It works on any talk page or Wikipedia namespace page.
This template is particularly helpful in discussions that are not threaded, to indicate which user's comment is referenced. If you feel that this template unnecessarily personalizes the discussion, you may still use the {{talkback}} template on the user's talk page to indicate that you have replied to a comment. IP addresses are only notified if you post to their user talk page.
Note that it isn't necessary to use this template to ping the user if you are already linking to the username from your post, neither is it necessary when posting on their own talk page.
The edit that adds this template must be signed with new signature tildes, or the notification(s) will not work. See Wikipedia:Notifications and mw:Help:Echo#Technical details for more information.
Single recipient
Use the following syntax:
{{reply to|Username}} Message text. ~~~~
For example, "{{Reply to|Jimbo Wales}}" generates "@Jimbo Wales:".
The comment must be signed and belong to a section in order for the notification to work.
Multiple recipients
You can reply to up to 7 people at once. Use the following syntax:
{{reply to|User1|User2|User3|User4|User5|User6|User7}} Message text. ~~~~
For example, {{reply to|Example|Jimbo Wales}}
will produce:
@Example and Jimbo Wales:
Warning: If the total number of detected to-be-pinged users in an edit exceeds 20, no notifications will be delivered.
Specify a nickname
You can display any text in place of a username by using |labelX=
, where X is the index of a positional parameter, counting from 1. For example:
You can also use |label=
in place of |label1=
. For example:
- "
{{reply to|Example|label=John}}
" produces "@John:"
Remove th@ silly @
OK, the @ @ the front is a style thing from Twitter but if you are a Wikipedian who holds Twitter in contempt, just add |prefix=
. For example:
- "
{{reply to|Example|prefix=}}
" produces "Example:"
Or you can use your own prefix. For example:
- "
{{reply to|Example|prefix=Hello }}
" produces "Hello Example:"
Customise punctuation
By default, the template will insert a colon after the final name. To change this, specify the required character using the |p=
parameter. For example:
- "
{{reply to|Example|p=—}}
" produces "@Example—"
The parameter omits leading or trailing spaces. Use
instead. For example:
- "
{{reply to|Example|p= –}} Text message
" produces "@Example – Text message"
To simply remove the colon, use the parameter with an empty value:
- "
{{reply to|Example|p=}}
" produces "@Example"
Customise conjunction
By default, the template will use the word "and" between multiple names. To change this, specify the required conjunction using the |c=
parameter. For example:
- "
{{reply to|Example|Example2|c=or}}
" produces "@Example or Example2:" - "
Neither {{reply to|Example|Example2|Example3|c=nor}}
" produces "Neither @Example, Example2, nor Example3:"
To simply remove the conjunction, use the parameter with an empty value:
Bugs
Sometimes, when the recipient's username contains an equal sign, for example {{reply to|test=test}}
, it will show
Error in Template:Reply to: Username not given.
To fix this, simply add 1= at the beginning of the username, 2= at the second username, 3= at the third username and so on:
{{reply to|1=test=test}}
Redirects
Related templates
- {{user link}} – Links to a single user's page (without the @ sign and colon)
- {{noping}} – Links a user's name without triggering the echo notification system
- {{to}} – Uses "To " (with a space) at the beginning instead of the @ sign
TemplateData
TemplateData for Reply to
Trigger a notification to one or several registered user(s) you are replying to in a discussion.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Username #1 | 1 | The name of the first user that you want to notify | User | required |
Username #2 | 2 | The name of the second user you want to notify (optional) | User | optional |
Username #3 | 3 | The name of the third user you want to notify (optional) | User | optional |
Username #4 | 4 | The name of the fourth user you want to notify (optional) | User | optional |
Username #5 | 5 | The name of the fifth user you want to notify (optional) | User | optional |
Username #6 | 6 | The name of the sixth user you want to notify (optional) | User | optional |
Username #7 | 7 | The name of the seventh user you want to notify (optional) | User | optional |
Label #1 | label1 label | An alternative nickname to be displayed instead of the first username (optional) | String | optional |
Label #2 | label2 | An alternative nickname to be displayed instead of the second username (optional) | String | optional |
Label #3 | label3 | An alternative nickname to be displayed instead of the third username (optional) | String | optional |
Label #4 | label4 | An alternative nickname to be displayed instead of the fourth username (optional) | String | optional |
Label #5 | label5 | An alternative nickname to be displayed instead of the fifth username (optional) | String | optional |
Label #6 | label6 | An alternative nickname to be displayed instead of the sixth username (optional) | String | optional |
Label #7 | label7 | An alternative nickname to be displayed instead of the seventh username (optional) | String | optional |
End punctuation | p | Custom punctuation to be displayed after the final name (defaults to ':')
| String | optional |
Conjunction | c | Custom conjunction to be displayed between the last two names (defaults to 'and')
| String | optional |