Template:Ping/doc: Difference between revisions
Jump to navigation
Jump to search
m MrJaroslavik moved page Template:Reply to/doc to Template:Ping/doc |
Cleanup for Miraheze |
||
| Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | ||
{{template shortcut|ping|re | {{template shortcut|ping|re|reply}} | ||
{{Lua|Module:Reply to}} | {{Lua|Module:Reply to}} | ||
This template is used to link one or more users' names, in the form "<kbd>@Username:</kbd>", to trigger a [[ | This template is used to link one or more users' names, in the form "<kbd>@Username:</kbd>", to trigger a [[mw:Notifications|notification]] for user(s) you are replying to in a discussion. The notification will work successfully only if you sign your post in the same edit in which you use this template. It works on any talk page or Project 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 [[WP:WIKILINK|wikilink]] to their [[WP:USERPAGE|user page]].<br /> The "@" symbol is used by this template for display purposes only.''' | '''You cannot directly type the "@" symbol to notify a user of your reply, you must use the template documented here or manually create a [[WP:WIKILINK|wikilink]] to their [[WP:USERPAGE|user page]].<br /> 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 | 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 post 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 == | == Usage == | ||
| Line 24: | Line 22: | ||
* If the number of detected to-be-pinged users exceeds 50, no notifications will be delivered. | * If the number of detected to-be-pinged users exceeds 50, no notifications will be delivered. | ||
See | See [[: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. | 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: | Note: {{SITENAME}} 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. <code><nowiki>[[User:Example|@Example]]</nowiki></code>) to ping them. | ||
<code><s><nowiki>@Username Message text. ~~~~</nowiki></s></code> '''''DOES NOT WORK''''' | <code><s><nowiki>@Username Message text. ~~~~</nowiki></s></code> '''''DOES NOT WORK''''' | ||
| Line 48: | Line 46: | ||
For example, <code><nowiki>{{reply to|Example|Jimbo Wales}}</nowiki></code> will produce: | For example, <code><nowiki>{{reply to|Example|Jimbo Wales}}</nowiki></code> will produce: | ||
{{reply to|Example| | {{reply to|Example|John}} | ||
[[File:Ambox warning pn.svg|20px|link=|alt=⚠]] '''<span style="color:red;">''Warning:''</span> If the total number of detected to-be-pinged users in an edit exceeds 50, no notifications will be delivered.''' This is a software limit, and applies to the entire edit, even if the mentions are split between multiple templates. If you need to ping more than 50 users, it will need to be spread across multiple edits, and each edit needs to add new lines and be signed by you. | [[File:Ambox warning pn.svg|20px|link=|alt=⚠]] '''<span style="color:red;">''Warning:''</span> If the total number of detected to-be-pinged users in an edit exceeds 50, no notifications will be delivered.''' This is a software limit, and applies to the entire edit, even if the mentions are split between multiple templates. If you need to ping more than 50 users, it will need to be spread across multiple edits, and each edit needs to add new lines and be signed by you. | ||
| Line 110: | Line 108: | ||
* {{Tlx|Ping}} | * {{Tlx|Ping}} | ||
* {{Tlx|Re}} | * {{Tlx|Re}} | ||
* {{Tlx|Reply}} | * {{Tlx|Reply}} | ||
* | * [{{fullurl:Special:WhatLinksHere/Template:Reply to|hidelinks=1&hidetrans=1}} ''Complete list of (alias) redirects'']<!-- checks WhatLinksHere to template, not doc --> | ||
== TemplateData == | == TemplateData == | ||
| Line 280: | Line 276: | ||
* {{tl|noping}} – Links a user's name without triggering the Echo notification system | * {{tl|noping}} – Links a user's name without triggering the Echo notification system | ||
* {{tl|to}} – Uses "To " (with a space) at the beginning instead of the @ sign | * {{tl|to}} – Uses "To " (with a space) at the beginning instead of the @ sign | ||
* [[:mw:Manual:Echo|Manual:Echo]] – the manual page for the underlying ''Echo'' feature that provides the notifications | * [[:mw:Manual:Echo|Manual:Echo]] – the manual page for the underlying ''Echo'' feature that provides the notifications | ||
* {{subst:[[Template:Plsping|Please ping]]}} – generates this: <small>(please use {{tlx|ping|Example}} on reply)</small> | * {{subst:[[Template:Plsping|Please ping]]}} – generates this: <small>(please use {{tlx|ping|Example}} on reply)</small> | ||