Template:No ping/doc: Difference between revisions

Content deleted Content added

Inline

Latest revision as of 01:24, 30 May 2024

This is a documentation subpage for Template:No ping.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 387,000 pages, or roughly 1% of all 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.

Shortcut

{{np}}

This template uses Lua:

Module:No ping (sandbox)

Purpose

This template links to a user page, or to multiple user pages, without triggering the notification system. It is not necessary to use this template if you are not signing your post, as Notifications mentions only work with a signature included.

Usage

Basic usage:

{{no ping|username 1|username 2|...}}

By default, usernames are displayed, but this can be overridden with the |labeln= parameters.

{{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 notifying them denies them the chance to respond.

Examples

{{no ping|Example|Example2}} → Example and Example2
{{no ping|Example|label1=User 1|Example2|label2=User 2}} → User 1 and User 2

Consequences

The template avoids notifications by making external links with code like <span class="plainlinks">[https://en.wikipedia.org/wiki/User:Username username]</span> instead of wikilinks like [[User:Username|Username]]. An external link icon is avoided with plainlinks but there are other consequences of not using a wikilink. The link will not be red for non-existing user pages, the blue link will have a lighter 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 Navigational Popups, which handles it the way it would handle other links.

Redirects

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

{{No-ping}}
{{Np}}
{{Noping}}
{{Nping}}

@@ Line 1: / Line 1: @@
+{{Documentation subpage}}
+{{high-use}}
+<!-- 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|Echo notification system]]. It is not necessary to use this template if you are not [[Wikipedia:Signatures|signing your post]], as Echo mentions only work with a signature included.
+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 ==
@@ Line 7: / Line 11: @@
 Basic usage:
- &#123;{noping|''username 1''|''username 2''|...}}
+ &#123;{no ping|''username 1''|''username 2''|...}}
 By default, usernames are displayed, but this can be overridden with the {{para|label''n''}} parameters.
- &#123;{noping|''username 1''|label1=''label 1''|''username 2''|label2=''label 2''|...}}
+ &#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>{{noping|Example|Example2}}</nowiki></code> &rarr; {{noping|Example|Example2}}
+* <code><nowiki>{{no ping|Example|Example2}}</nowiki></code> &rarr; {{no ping|Example|Example2}}
-* <code><nowiki>{{noping|Example|label1=User 1|Example2|label2=User 2}}</nowiki></code> &rarr; {{noping|Example|label1=User 1|Example2|label2=User 2}}
+* <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">[//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.
+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|Noping2}}
-*{{Tl|Reply to}}/{{Tl|Ping}}
+* {{Tl|Reply to}}
+* {{Tl|Ping group}}
+* {{tlxs|Please ping|no}} (inserts message asking not to be pinged)
-*{{Tl|Ping group}}
+* {{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>