View source for Template:Sockpuppet/doc

{{documentation subpage}}
{{Ivmbox|1=<big>'''Brief guide to using this template'''</big>

{{tlc|{{BASEPAGENAME}}|<var>sockmaster</var>|<var>blank/blocked/proven/confirmed</var>}}

*Sock has been blocked based on ''edits'': {{tlx|Sockpuppet|Master account|blocked}}
*Sock has been blocked based on ''CheckUser evidence'': {{tlx|Sockpuppet|Master account|confirmed}}.
<p>To append links, evidence, or a brief note, use {{para|3}}. Useful for adding a diff to a checkuser's talk page, if the check was not conducted at SPI. If explaining behavioural evidence, be mindful of [[WP:BEANS]].</p><p>For sock''masters'', use {{tlx|Sockpuppeteer}}.</p>}}
{{High use|187906}}
{{nosubst}}
===Usage=== 
In general, this template should only be applied by [[Wikipedia:Administrators|Administrators]] or [[Wikipedia:Sockpuppet investigations/SPI/Clerks|Clerks]] as part of the [[Wikipedia:Sockpuppet investigations|Sockpuppet investigations]] process. 

==== For use with a single master ====
{| class="wikitable"
! width="10%" | Code
! width="30%" | Use
! width="60%" | Displays
|-
|{{tlx|sockpuppet|Example|blocked}}
|The account has been blocked based on behavioural evidence.
|{{Sockpuppet|Example|blocked|spipage=Example|nocat=yes}}
|-
|{{tlx|sockpuppet|Example|proven}}
|Behaviour proved beyond a reasonable doubt ([[WP:DUCK]]) or similar but there is no CU {{confirmed}} result (CU may have given another result).
|{{Sockpuppet|Example|proven|spipage=Example|nocat=yes}}
|-
|{{tlx|sockpuppet|Example|confirmed}}<br/>{{tlx|sockpuppet|Example|cuconfirmed}}<br/>{{tlx|sockpuppet|Example|nbconfirmed}}
|A CU has {{confirmed}} that the accounts are related.
|{{Sockpuppet|Example|confirmed|spipage=Example|nocat=yes}}
|-
|{{tlx|sockpuppet|Example|confirmed|locked{{=}}yes}}
|Account has been confirmed by a CU, locally blocked indef and globally locked.
|{{Sockpuppet|Example|confirmed|locked=yes|nocat=yes}}
|-
|}

====For use with a suspected alternate master====
(can be used in addition to the parameters below)
{| class="wikitable"
! width="10%" | Code
! width="30%" | Use
! width="60%" | Displays
|-
|{{tlx|Sockpuppet|Example|<nowiki>confirmed |altmaster=Example2|altmaster-status=proven</nowiki>}}
|User:Example has been confirmed to another sock account but there is a very strong connection to another master (Example2) who is not CU confirmed.
|{{Sockpuppet|Example|confirmed|altmaster=Example2|altmaster-status=proven}}
|-
|{{tlx|Sockpuppet|Example|<nowiki>confirmed |altmaster=Example2|altmaster-status=suspected</nowiki>}}
|User:Example has been confirmed to another sock account but User:Example2 is the suspected master.
|{{Sockpuppet|Example|confirmed|altmaster=Example2|altmaster-status=suspected}}
|-
|{{tlx|Sockpuppet|Example|<nowiki>proven |altmaster=Example2|altmaster-status=suspected</nowiki>}}
|User:Example is proven to be a sock of another account but both are suspected to be a sock of User:Example2.
|{{Sockpuppet|Example|proven|altmaster=Example2|altmaster-status=suspected}}
|}
The template adds the [[Wikipedia:Controlling search engine indexing|<code><nowiki>__NOINDEX__</nowiki></code> magic word]].

===Parameters===
The first parameter in this table is '''required''' and the template will fail without it. All the other parameters are optional.

{| class="mbox-inside wikitable"
! Parameter(s)
! Values
! Notes
|-
| 
* ''First positional parameter'' (optionally {{para|1}})
| ''Username of the sockmaster or suspected sockmaster''
| Just include the name, no "User:" or square brackets.
|-
|
* ''Second positional parameter'' (optionally {{para|2}})
|
* <code>spi</code>
* <code>blocked</code>
* <code>proven</code>
* <code>confirmed</code>
* <code>cuconfirmed</code>
* <code>nbconfirmed</code>
| 
* <code>blocked</code> - this is used for sockpuppets that have been blocked on behavioural evidence (the [[WP:DUCK|duck test]]) or behavioural evidence combined with a non-conclusive CU result (such as {{possible}}).
* <code>proven</code> - Behaviour is beyond reasonable doubt but there is no CU {{Confirmed}} result (CU may have given a different result).
* <code>confirmed</code>, <code>cuconfirmed</code> and <code>nbconfirmed</code> - A CU has {{Confirmed}} that the accounts are related.
|-
| 
* ''Third positional parameter'' (optionally {{para|3}})
* {{para|evidence}}
| ''Evidence of sockpuppetry''
| This field can be used to link to the evidence of sockpuppetry, or to give a very brief summary (a couple of words). If this parameter is left blank and the sockpuppet investigation case page is a blue link, then a link to the case page is provided automatically.
|-
|
* {{para|spipage}}
| ''Subpage name (just the master) of the SPI if not the same as the master''
| This field can be used to specify a different SPI page if the page is not named for the master in parameter 1.
|-
|
* {{para|locked}}
| 
* <code>yes</code>
| Use {{para|locked|yes}} if the account is [[:m:Locked global account|globally locked]].
|-
|
* {{para|notblocked}}
| 
* <code>yes</code>
| This parameter can be used to remove the note about the account being blocked, such as if an account is globally locked as a sockpuppet, but has not been blocked locally. ''This parameter works with all parameters.''
|-
|
* {{para|length}}
| ''Length of time the sockpuppet or suspected sockpuppet was blocked''
| Use this field if the sockpuppet or suspected sockpuppet was blocked for a specific length of time. This parameter defaults to "indefinitely". This parameter is ignored, and does not default to indefinitely, if <code>nbconfirmed</code> is used.
|-
|
* {{para|cat}}
* {{para|category}}
| ''Custom category name for the sockpuppet or suspected sockpuppet''
| This parameter defaults to the category "Wikipedia sockpuppets of X" if the second positional parameter is set to "confirmed", and "Suspected Wikipedia sockpuppets of X" if the second positional parameter is set to anything else. Here, "X" is the username specified in the first positional parameter.
|-
|
* {{para|nocat}}
| ''Suppresses categorization of the page''
| When set to <code>nocat=1</code>, the page will not be categorized.  Should only be used in test or example uses of the template.
|}

=== Deprecated parameters ===
Use of this template with the second positional parameter {{code|suspected}} or {{code|spi}} or without any second positional parameter will produce 
{{Sockpuppet|Example|nocat=yes}}
The template should '''not be used in this manner''', as [[Wikipedia:Sockpuppetry#Handling suspected sock puppets]] mandates that only blocked accounts be tagged as sockpuppets.

===Categories===
This template adds pages to one of (as appropriate):
* [[:Category:Suspected Wikipedia sockpuppets]] and ''Category:Suspected Wikipedia sockpuppets of <nowiki>{{{1}}}</nowiki>'';
* ''Category:Wikipedia sockpuppets of <nowiki>{{{1}}}</nowiki>''. 

===TemplateData===
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Master's username",
			"description": "Username of the sockpuppeteer",
			"type": "wiki-user-name",
			"required": true
		},
		"2": {
			"label": "Status",
			"description": "The status of the account. Set to \"spi\" or \"suspected\" if the user is not yet blocked or confirmed by a checkuser but is under investigation. Set to \"blocked\" if the user has been blocked on behavioral evidence (checkuser not used). Set to \"proven\" if the user is a sock beyond reasonable doubt. Set to \"confirmed\" \"cuconfirmed\" or \"nbconfirmed\" if the account has been confirmed by a checkuser. If defined, defaults to the 'not yet blocked or confirmed by a checkuser but is under investigation'.",
			"type": "string",
			"suggested": true
		},
		"3": {
			"type": "content",
			"aliases": [
				"evidence"
			],
			"label": "Evidence",
			"description": "Use this parameter to specify evidence different from the normal link to the case page"
		},
		"length": {
			"label": "Block length (if not indefinite)",
			"description": "The length of time the user has been blocked for. Defaults to indefinite.",
			"type": "string"
		},
		"notblocked": {
			"label": "Not blocked?",
			"description": "Set to \"yes\" if the account has not been blocked and the status template is not the default",
			"type": "line"
		},
		"locked": {
			"label": "Globally locked?",
			"description": "Set to \"yes\" if the account has been globally locked",
			"type": "line"
		},
		"spipage": {
			"label": "Subpage name of SPI",
			"description": "Define if the SPI has a different name to the master",
			"type": "string"
		},
		"category": {
			"aliases": [
				"cat"
			],
			"label": "Custom category",
			"description": "Adds the user to a custom category. Defaults to \"Suspected Wikipedia sockpuppets of [sockmaster]\" or \"Wikipedia sockpuppets of [sockmaster]\" based on the \"Status\" parameter."
		},
		"nocat": {
			"label": "Remove categories",
			"description": "Defining this parameter will remove the categories",
			"type": "line"
		}
	},
	"description": "This template is placed on the user pages of accounts which are sockpuppets, usually by patrolling administrators at SPI."
}
</templatedata>

===See also===
* {{tls|Uw-socksuspect}}
* {{tl|Sockpuppeteer}}
* {{tl|Checked sockpuppet}}
* {{tl|SockmasterProven}}
* {{tl|SockBlock}}


<includeonly>{{Sandbox other||
[[Category:Sockpuppet templates|Sockpuppet]]
[[Category:Wikipedia templates which apply NOINDEX]]
[[Category:Userpage header templates]]
[[Category:User block templates]]
}}</includeonly>