Revision as of 14:33, 5 May 2014 editArcticocean (talk | contribs)Edit filter managers, Extended confirmed users46,227 edits update documentation← Previous edit | Latest revision as of 22:19, 16 November 2024 edit undoHouseBlaster (talk | contribs)Edit filter managers, Administrators58,166 edits TM:ArbCom template | ||
(40 intermediate revisions by 23 users not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
{{ |
{{Always substitute|auto=yes|actualtemplate={{tlsp|alert/first|<i>topic code</i>}}}} | ||
⚫ | {{ArbCom template}} | ||
{{shortcut|1=Template:Alert|2=T:DSA}}__NONEWSECTIONLINK____NOTOC__ | |||
{{Shortcut|1=Template:Alert/first}} | |||
__TOC__ | |||
===Usage=== | ===Usage=== | ||
Some pages and topics on Misplaced Pages are |
Some pages and topics on Misplaced Pages are covered by ]. Users editing these pages may be ] about the contentious topics system. If this is the editor's first alert, you '''must''' use this template if you alert them. Otherwise you can use ] for alerts after their first alert, or ] if their last alert was for the old "discretionary sanctions" system. | ||
{{Contentious topics/alert/common doc|template-short-hand=alert/first|templatedata=<templatedata> | |||
Alerts ensure a user knows what is expected of them. Alerts are a neutral courtesy; never use them to intimidate, coerce, or shame another editor. | |||
{ | |||
"params": { | |||
"1": { | |||
"aliases": [ | |||
"topic", | |||
"t" | |||
], | |||
"label": "The contentious topic code", | |||
"description": "What contentious topic applies to this page. Specified using a shorthand code listed on this template's documentation page.", | |||
"type": "string", | |||
"required": true | |||
}, | |||
"2": { | |||
"label": "Extra content", | |||
"description": "Extra content that is appended to the alert but placed before your signature.", | |||
"type": "string" | |||
}, | |||
"sig": { | |||
"label": "Add your signature?", | |||
"description": "Whether to include your signature at the end of the message. Any text as the value adds your signature.", | |||
"type": "string" | |||
}, | |||
"heading": { | |||
"label": "Include a heading?", | |||
"description": "Whether a heading to the message should be included. Default is that it is included.", | |||
"type": "boolean" | |||
}, | |||
"headtext": { | |||
"label": "Custom heading text", | |||
"description": "Text for the heading that is used instead of the default.", | |||
"type": "string" | |||
} | |||
}, | |||
"description": " " | |||
} | |||
</templatedata>}} | |||
⚫ | <includeonly>{{sandbox other|| | ||
To alert a user, open a new section on their user talk page. Paste the following code into it, replacing <code>''topic code – see list''</code> with the corresponding code from ] below. Type an appropriate subject line, then save the page. | |||
] | |||
}}</includeonly> | |||
{{pre|1={{]:Alert|<u>''topic code here'' – select from ]</u>}} <nowiki>~~~~</nowiki>}} | |||
===Logging=== | |||
Using this template will trigger ]. As a result, your edit containing the alert will be ] with "discretionary sanctions alert". Edits with this tag can be searched for in user contributions, user talk page histories, ], and the log of EditFilter 602. | |||
Therefore, an automatic system log of all alerts is maintained. You need not do anything except leave the alert. | |||
To see whether a user has been Alerted to discretionary sanctions, load the history of their user talk page and search for <code>discretionary sanctions alert</code> under the 'tag filter' field. You can use the {{tl|Ds/log}} template (usually alongside {{tl|user}} in noticeboard reports) to quickly generate links for conducting searches of issued alerts. | |||
Additionally, current instances of the template are tracked and counted . Alerts that were subsequently deleted from the user's talk page will only appear in the EditFilter log, so this is the primary tracking mechanism. | |||
===Codes=== | |||
When leaving a user an Alert, you must replace <code>{{!}}''topic code – select from list''</code> with the relevant topic code: | |||
{{Ds/topics/table}} | |||
===Advanced users' notes=== | |||
* Substituted instances of this template are tracked using the Z-number template {{tl|Z33}}. Use of this template can be tracked at ]. | |||
* Edits containing a substituted instance of this template will trigger AbuseFilter 602. The exact text which triggers the AbuseFilter are declared in the publicly-viewable ]. | |||
* If the parameter {{para|1}} fails to display, {{para|topic}} or {{para|t}} can be used instead. | |||
* This template will return an error if: | |||
:*{{para|1}} or an equivalent is not declared; | |||
:*the template is not substituted; or | |||
:*the template is used outside the user talk or user namespaces. | |||
* ] is a mirror of (i.e. a redirect to) Template:Ds/alert. Instructions for this template, ''Ds/alert'', are often given with reference to the template ''Alert''. This is for brevity's sake; the two templates are identical. | |||
* Information on adding ''new'' topic areas to the index above is given at the bottom of ], which is displayed {{#ifeq:{{PAGENAME}}|Template:Ds/alert|below|at the bottom of the ]}}. | |||
* This template is included in ], so AnomieBOT will automatically substitute it. (As the template returns an error if used unsubstituted, AnomieBOT will not have to frequently, if ever, do this.) | |||
⚫ | <includeonly> |
||
{{subst only}} | |||
⚫ | {{ |
||
{{Used in system|2=Template talk:Ds}}</includeonly> | |||
<noinclude> | |||
<div class="metadata topicon" style="right: 10px; font-size: 105%;">←]</div> | |||
</noinclude> |
Latest revision as of 22:19, 16 November 2024
This is a documentation subpage for Template:Contentious topics/alert/first. It may contain usage information, categories and other content that is not part of the original template page. |
This template should always be substituted (i.e., use {{subst:alert/first|topic code}}). Any accidental transclusions will be automatically substituted by a bot. |
This template is within the jurisdiction of the Arbitration Committee, as one of its associated enforcement processes. Therefore, you must not make significant changes to the wording or functionality of this template without the Committee's consent. Thank you! |
Usage
Some pages and topics on Misplaced Pages are covered by contentious topics. Users editing these pages may be alerted about the contentious topics system. If this is the editor's first alert, you must use this template if you alert them. Otherwise you can use Template:Contentious topics/alert for alerts after their first alert, or Template:Contentious topics/alert/DS if their last alert was for the old "discretionary sanctions" system.
Alerts ensure a user knows what is expected of them. Alerts are a neutral courtesy; never use them to intimidate, coerce, or shame another editor.
To alert a user, open a new section on their user talk page. Paste the following code into it, replacing topic code here – select from list
with the corresponding code from the table below. Type an appropriate subject line, then save the page.
{{subst:alert/first|topic code here – select from list}} ~~~~
You also should not issue alerts to editors who have posted a {{Contentious topics/aware}} notice on their talk page for a particular topic area, thus declaring they are already aware of the topic sanctions. If that is the case, the filter will remind you that leaving an alert for this user is not necessary.
The template is flexible through the parameters |2=
, which adds text to the box, and |sig=
, which adds your signature.
{{subst:alert/first|topic code here – select from list|2=If you have questions, please contact me or ask at the [[WP:AC/CN|Arbitration Committee Clerks Noticeboard]].|sig=yes}}
Parameter | Description | Type | Status | |
---|---|---|---|---|
The contentious topic code | 1 topic t | What contentious topic applies to this page. Specified using a shorthand code listed on this template's documentation page. | String | required |
Extra content | 2 | Extra content that is appended to the alert but placed before your signature. | String | optional |
Add your signature? | sig | Whether to include your signature at the end of the message. Any text as the value adds your signature. | String | optional |
Include a heading? | heading | Whether a heading to the message should be included. Default is that it is included. | Boolean | optional |
Custom heading text | headtext | Text for the heading that is used instead of the default. | String | optional |
Logging
Using this template will trigger EditFilter 602. As a result, your edit containing the alert will be tagged with "contentious topics alert". Edits with this tag can be searched for in user contributions, user talk page histories, Special:RecentChanges, and the log of EditFilter 602.
Therefore, an automatic system log of all alerts is maintained. You need not do anything except leave the alert.
To see whether a user has been Alerted for a contentious topic, load the history of their user talk page and search for contentious topics alert
under the 'tag filter' field. You can use the {{Contentious topics/log}} template (usually alongside {{user}} in noticeboard reports) to quickly generate links for conducting searches of issued alerts.
If your alert does not log, please seek assistance at Template talk:Contentious topics.
Codes
When leaving a user an Alert, you must replace |topic code – select from list
with the relevant topic code:
Advanced users' notes
- Edits containing a substituted instance of this template will trigger AbuseFilter 602. The exact text which triggers the AbuseFilter are declared in the publicly viewable filter conditions.
- If the parameter
|1=
fails to display,|topic=
or|t=
can be used instead. - This template will return an error if:
|1=
or an equivalent is not declared;- the template is not substituted; or
- the template is used outside the user talk or user namespaces.
- Template:Alert is a redirect to Template:Contentious topics/alert. Instructions for this template, Contentious topics/alert, are often given with reference to the template name Alert. This is for brevity's sake; the two template names refer to the same actual template.
- Information on adding new topic areas to the index above is given at the bottom of Template:Contentious topics/list/single notice, which is displayed at the bottom of the main template page.
- This template is included in Category:Misplaced Pages templates to be automatically substituted, so AnomieBOT will automatically substitute it. (As the template returns an error if used unsubstituted, AnomieBOT will not have to frequently, if ever, do this.)
Standardised Arbitration Enforcement (AE) templates
This section transcluded from: Template:Contentious topics/list/single notice
Alerting
- {{alert/first}} ({{Contentious topics/alert/first}}), to alert an editor to the CT system which is mandatory for the first time an editor is alerted to contentious topics (except if they've previously been alerted to discretionary sanctions in any topic area)
- {{alert}} ({{Contentious topics/alert}}), to alert an editor to the CT system
- {{alert/DS}} ({{Contentious topics/alert/DS}}), to alert an editor to the CT system who had previously been alerted of DS
- {{Contentious topics/aware}}, to register oneself as already aware of CT
- {{Contentious topics/talk notice}}, for announcing CT in a talk page messagebox
- {{Contentious topics/editnotice}}, for announcing CT in an editnotice
- EditFilter 602, which automates the logging of alerts
- Log of recent alerts
Enforcement
- Individual restrictions
- {{AE sanction}}, for telling a user they have been sanctioned (under CT or otherwise)
- {{AE sanction/topicban}}, specifically for an AE topic ban
- {{Uw-aeblock}}, for notifying users of arbitration enforcement blocks
- {{Uw-aepblock}}, for notifying users of arbitration enforcement partial blocks
- Page restrictions
- {{Contentious topics/page restriction editnotice}}, editnotice that must be used for announcing active page restrictions (except page protection)
- {{Contentious topics/page restriction talk notice}}, talk page messagebox that should be used for announcing active page restrictions
- {{Contentious topics/list}} & {{Contentious topics/table}}, the lists of contentious topics
- Contentious topics enforcement templates, the category for all enforcement-related templates created for the current contentious topics template
- Case/decision specific enforcement templates
- {{Contentious topics/log}}, to display links for searching whether a user has ever been alerted; use like/alongside {{user}}.
Whenever contentious topics are (de)authorised for a topic, update these: {{Contentious topics/list}} (edit), WP:GS §3.1 (edit), and {{Contentious topics/table}} (edit).