Template:Ping

From RationalWiki
Jump to navigation Jump to search

@Example

[edit] [purge] Documentation

Usage

This template triggers a notification to one or several registered user(s) you are replying to in a discussion. This template is particularly helpful in discussions that are not threaded, to indicate which user's comment is referenced. 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.

Single recipient

Use the following syntax:

{{Ping|Username}} Message text. ~~~~

For example, "{{Ping|Example}}" generates "@Example".

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:

{{Ping|User1|User2|User3|User4|User5|User6|User7}} Message text. ~~~~

For example, {{Ping|Example|User}} will produce:

@Example and User

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:

"{{Ping|Example|label1=Exemplar|Example2|label2=John}}" produces "@Exemplar and John"

You can also use |label= in place of |label1=. For example:

"{{Ping|Example|label=John}}" produces "@John"

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:

"{{Ping|Example|Example2|c=or}}" produces "@Example or Example2"
"Neither {{Ping|Example|Example2|Example3|c=nor}}" produces "Neither @Example, Example2, nor Example3"

To simply remove the conjunction, use the parameter with an empty value:

"{{Ping|Example|Example2|c=}}" produces "@Example, Example2"

Bugs

Sometimes, when the recipient's username contains an equal sign, for example {{Ping|test=test}}, it will show

Error in Template:Replyto: 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:

{{Ping|1=test=test}}

Redirects