View source for Template:No ping/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Template shortcut|np}}
{{lua|Module:No ping}}
== Purpose ==
This template links to a [[Wikipedia:User pages|user page]], or to multiple user pages, without triggering the [[Wikipedia:Notifications|notification system]]. It is not necessary to use this template if you are not [[Wikipedia:Signatures|signing your post]], as Notifications mentions only work with a signature included.

== Usage ==

Basic usage:

 &#123;{no ping|''username 1''|''username 2''|...}}

By default, usernames are displayed, but this can be overridden with the {{para|label''n''}} parameters.

 &#123;{no ping|''username 1''|label1=''label 1''|''username 2''|label2=''label 2''|...}}

== Appropriate use ==
As transparency is a core value of Wikipedia, please be cautious when using this template. It is fine to use it to avoid bothering an editor about something in which there is no reasonable expectation they would be interested. On the other hand, using it when criticizing another editor will often be perceived negatively, as not [[Wikipedia:Notification|notifying]] them denies them the [[right of reply|chance to respond]].

== Examples ==

* <code><nowiki>{{no ping|Example|Example2}}</nowiki></code> &rarr; {{no ping|Example|Example2}}
* <code><nowiki>{{no ping|Example|label1=User 1|Example2|label2=User 2}}</nowiki></code> &rarr; {{no ping|Example|label1=User 1|Example2|label2=User 2}}

== Consequences ==
The template avoids notifications by making external links with code like <code><nowiki><span class="plainlinks">[https://en.wikipedia.org/wiki/User:Username username]</span></nowiki></code> instead of wikilinks like <code><nowiki>[[User:Username|Username]]</nowiki></code>. An external link icon is avoided with <code><nowiki>plainlinks</nowiki></code> but there are other consequences of not using a wikilink. The link will not be [[WP:RED|red]] for non-existing user pages, the blue link will have a lighter [[Help:Link color|color]] than usual for most readers, and the page the template is used on will not appear at [[Special:WhatLinksHere]] for the user page. The link is recognized by [[WP:POPUPS|Navigational Popups]], which handles it the way it would handle other links.

== Redirects ==
You can use the following text in place of "No ping":

* {{Tl-r|No-ping}}
* {{Tl-r|Np}}
* {{Tl-r|Noping}}
* {{Tl-r|Nping}}

== See also ==
* {{Tl|No ping2}}: This template functions similarly to <nowiki>{{no ping}}</nowiki>, but also provides Talk and Contributions links.
* {{Tl|Reply to}}
* {{Tl|Ping group}}
* {{tlxs|Please ping|no}} (inserts message asking not to be pinged)
* {{Tl|Hidden ping}}: pings without displaying any text
* {{Tl|No ping wikilink}}

{{Inline talk templates}}
<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Inline talk templates]]
[[Category:Username internal link templates]]
}}</includeonly>
<templatedata>
{
	"params": {
		"1": {
			"label": "Username",
			"description": "The name of the user you want to link to.",
			"example": "Example2",
			"type": "wiki-user-name",
			"required": true
		}
	},
	"description": "Link to userpages without generating an alert (a ping)"
}
</templatedata>