Template:Reply to/doc: Difference between revisions
meta>Renamed user mou89p43twvqcvm8ut9w3 high risk |
meta>Paine Ellsworth m update /doc – high use = 2,000 to 100,000 – high risk = more than 100,000 |
||
Line 3: | Line 3: | ||
{{template shortcut|ping|re|replyto|reply|yo}} | {{template shortcut|ping|re|replyto|reply|yo}} | ||
{{Lua|Module:Reply to}} | {{Lua|Module:Reply to}} | ||
{{High- | {{High-use| 90381 }} | ||
This template is used to link a user's name, in the form "<kbd>@Username:</kbd>" to trigger a [[Wikipedia:Notifications|notification]] to one or several registered user(s) you are replying to in a discussion. The notification will only work if you sign successfully your post in the same edit in which you use this template. If you make a mistake in placing this template or in signing, see [[Help:Fixing failed pings]]. It is an alternative to the {{tl|talkback}} template. It works on any talk page or Wikipedia namespace page. | This template is used to link a user's name, in the form "<kbd>@Username:</kbd>" to trigger a [[Wikipedia:Notifications|notification]] to one or several registered user(s) you are replying to in a discussion. The notification will only work if you sign successfully your post in the same edit in which you use this template. If you make a mistake in placing this template or in signing, see [[Help:Fixing failed pings]]. It is an alternative to the {{tl|talkback}} template. It works on any talk page or Wikipedia namespace page. |
Revision as of 02:32, 21 April 2017
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. |
This template uses Lua: |
This template is used on approximately 203,000 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 is used to link a user's name, in the form "@Username:" to trigger a notification to one or several registered user(s) you are replying to in a discussion. The notification will only work if you sign successfully your post in the same edit in which you use this template. If you make a mistake in placing this template or in signing, see Help:Fixing failed pings. It is an alternative to the {{talkback}} template. It works on any talk page or Wikipedia namespace page.
You cannot directly type the "@" symbol to notify a user of your reply, you must use the template documented here or manually create a wikilink to their user page. The "@" symbol is used by this template for display purposes only. |
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.
Usage
{{reply to|Username}} Message text. ~~~~
The edit that adds this template must be signed with new signature tildes at a minimum, or the notification(s) will not work. See Wikipedia:Notifications and mw:Help:Echo#Technical details for more information.
It is not 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.
Note: Wikipedia does not support using the at sign in a reply to notify the user you are replying to, as many discussion boards do. While Wikipedia shows the results of using this template with an at sign, you must either use a template or directly link to the user's user page (e.g. [[User:Example|@Example]]
) to ping them.
@Username Message text. ~~~~DOES NOT WORK
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 50 people at once. Use the following syntax:
{{reply to|User1|User2|User3|User4|User5|User6|User7|User8|User9|User10|...}} 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 50, 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:"
Specify a prefix
To change the prefix, use |prefix=custom prefix
. For example:
- "
{{reply to|Example|prefix=Hello }}
" produces "Hello Example:"
Or you can remove the prefix entirely by using |prefix=
. For example:
- "
{{reply to|Example|prefix=}}
" produces "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:
Or don't use!
If you are using the |prefix=
and |p=
together to just display one user name, then there is no need to use this template. Simply code [[User:username|]]
or {{u|username}}
. This will generate the same notifications as are generated by the template.
Error messages
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
See also
- Module:Reply to – the Lua module on which this template is based
- {{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
- {{talkback}} – Allows a user to direct the attention of another user to a discussion via a notification
- Manual:Echo – the manual page for the underlying Echo feature that provides the notifications
- Help:Fixing failed pings
TemplateData
TemplateData for Reply to