View source for Template:Connected contributor/doc

<noinclude>{{pp-semi}}</noinclude>
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{High-use}}
{{Template shortcut|Conn|Concon}}
{{Lua|Module:Check for unknown parameters}}

==Usage==
{{Mbox|text=This template should be placed on article talk pages or draft talk pages.}}
{{Mbox|text=For paid editors, use {{txl|Connected contributor (paid)}} instead.}}

If you are user Example, and you have just checked an article for COI by user John Smith who has declared his connection at the diff with revision ID 442212827, use this:

{{tlx|Connected contributor|checked{{=}}{{tlxs|today}} by {{tlx|u|Example}}|user{{=}}John Smith|declared{{=}}yes|otherlinks{{=}}{{tlx|diff2|442212827|declared here}}}}

This produces the following:

{{Connected contributor|checked=20 September 2020 by {{u|Example}}|user=John Smith|declared=yes|otherlinks={{diff2|442212827|declared here}}}}

For a complete overview of parameters, see below. For a real example, the [[Talk:Assurant|Assurant talk page]] shows {{t|connected contributor}} and {{t|connected contributor (paid)}}.

Use this template when dealing with a [[WP:COIEDIT|general conflict of interest]], including financial conflict of interest that does not involve being paid to edit Wikipedia. It can be used whether there is an [[WP:ACTUALCOI|actual]] (confirmed) or an [[WP:APPARENTCOI|apparent COI]], but if the COI is unconfirmed do not add it without justifiably strong suspicion.

The template adds articles to [[:Category:Articles with connected contributors]].

{{Mbox|text=Do not use this template solely to identify an article subject as a Wikipedian.}}

== Parameters ==
;{{para|checked}} 
:Text parameter. Most recent date that a neutral editor checked the edits of all known connected contributors for neutrality as well as the name of that editor. For example: {{para|checked|31 December 2016 by Example}} 
:You can use templates {{tl|today}} (substituted) and {{tl|u}} to insert this conveniently: {{para|checked|{{tlxs|today}}by{{tlx|u|Example}}}} 
;{{para|user}} 
:Text parameter. User name of the COI editor. For example: {{para|user|John Smith}}
:Note that the user name is automatically linked complete with talk page and contributions (i.e. the {{tl|user}} template is automatically applied for you)
;{{para|alt1}} {{para|alt2}} {{para|alt3}} {{para|alt4}} 
:Text parameters. Alternative names for the COI editor. Useful in cases of [[Wikipedia:Sockpuppetry]]. Otherwise works like {{para|user}}. 
;{{para|editedhere}}
:Yes/no parameter (optional). If the COI editor has edited the present article, enter "yes".
;{{para|declared}}
:Yes/no parameter (optional). If the COI editor has declared their connection/financial interest in Wikipedia, enter "yes".
;{{para|otherlinks}}
:Text parameter (optional). If the COI editor has declared their connection and you know where, you can provide a link to it. You can also provide a label for the link.
:If you provide a general URL (including to a Wikipedia edit) consider using the following format for the otherlinks parameter:
:<pre>[https://en.wikipedia.org/w/index.php?title=SomePageName&oldid=442212827 declared here]</pre>
:(Note how the URL is followed by the label "declared here" and enclosed in square brackets). 
:A more succinct way to do this for links to Wikipedia edits is to use the {{tl|diff2}} template, like this:
:{{tlx|diff2|442212827|declared here}}
:(Note how you only need the revision ID and label)
;{{para|banned}}
:Yes/no parameter (optional). If the COI editor user has been formally [[WP:BAN|banned]] from editing the present article, enter "yes". This adds a note to that user name, informing readers that if they spot contributions of that user that weren't caught and reverted, they may do so. Please do not use this parameter if you are not sure about the COI editor's status.
;{{para|small}}
:Yes/no parameter (optional). If you need to make the box small and right floating, enter "yes".

===Multi-listing===
The above example was for listing a single COI editor. 

This template is capable of listing up to 10 editors. Assign a number between 1 and 10 to each editor listed, and substitute that value for ''X'' in each of the parameters listed below. Parameters otherwise work as described for single-listing above. 

;User''X''
the user name of the COI editor. Note there is no capacity to list alternative names (per the {{para|alt1}}...{{para|alt4}} parameters above) in a multi-listing.
;U''X''-EH
Edited here: whether or not the COI editor has edited the present article
;U''X''-declared
COI declared: whether the COI user has declared their connection
;U''X''-otherlinks
Other links: a link to the diff of the editor's COI declaration
;U''X''-banned
Banned: whether the user has been formally banned from editing the present article

==== Example ====
<pre>{{Connected contributor
| checked = 31 December 2016 by {{u|Example}}
| User1 = WikiWriter2458 | U1-EH = yes | U1-declared = yes | U1-otherlinks = | U1-banned = no
| User2 = John Smith | U2-EH = no | U2-declared = no | U2-otherlinks = | U2-banned = no
| User3 = Janet Doe | U3-EH = yes | U3-declared = yes | U3-otherlinks = | U3-banned = yes
| User4 = xx | U4-EH = yes | U4-declared = no | U4-otherlinks = | U4-banned = no
}}</pre>

This code produces the following:

{{{{PAGENAMETDOC}}
| checked = 31 December 2016 by {{u|Example}}
| User1 = WikiWriter2458 | U1-EH = yes | U1-declared = yes | U1-otherlinks = | U1-banned = no
| User2 = John Smith | U2-EH = no | U2-declared = no | U2-otherlinks = | U2-banned = no
| User3 = Janet Doe | U3-EH = yes | U3-declared = yes | U3-otherlinks = | U3-banned = yes
| User4 = xx | U4-EH = yes | U4-declared = no | U4-otherlinks = | U4-banned = no
}}

==Template Data==
{{TemplateData header}}
{{collapse top}}
<templatedata>
{
	"params": {
		"1": {},
		"small": {},
		"U1-EH": {},
		"checked": {},
		"User1": {},
		"user": {},
		"alt1": {},
		"alt2": {},
		"alt3": {},
		"alt4": {},
		"editedhere": {},
		"U1-declared": {},
		"declared": {},
		"U1-banned": {},
		"banned": {},
		"U1-otherlinks": {},
		"otherlinks": {},
		"User2": {},
		"U2-EH": {},
		"U2-declared": {},
		"U2-banned": {},
		"U2-otherlinks": {},
		"User3": {},
		"U3-EH": {},
		"U3-declared": {},
		"U3-banned": {},
		"U3-otherlinks": {},
		"User4": {},
		"U4-EH": {},
		"U4-declared": {},
		"U4-banned": {},
		"U4-otherlinks": {},
		"User5": {},
		"U5-EH": {},
		"U5-declared": {},
		"U5-banned": {},
		"U5-otherlinks": {},
		"User6": {},
		"U6-EH": {},
		"U6-declared": {},
		"U6-banned": {},
		"U6-otherlinks": {},
		"User7": {},
		"U7-EH": {},
		"U7-declared": {},
		"U7-banned": {},
		"U7-otherlinks": {},
		"User8": {},
		"U8-EH": {},
		"U8-declared": {},
		"U8-banned": {},
		"U8-otherlinks": {},
		"User9": {},
		"U9-EH": {},
		"U9-declared": {},
		"U9-banned": {},
		"U9-otherlinks": {},
		"User10": {},
		"U10-EH": {},
		"U10-declared": {},
		"U10-banned": {},
		"U10-otherlinks": {}
	}
}
</templatedata>
{{collapse bottom}}

== Tracking category ==
* {{clc|Pages using connected contributor with unknown parameters}}

== See also ==
* {{tl|COI}}
* {{tl|COI edit notice}}
* {{tl|UserboxCOI}}
* {{tl|Connected contributor (paid)}}
* {{tl|Undisclosed paid}}
* [[Wikipedia:Wikipedians with articles]]

<includeonly>{{Sandbox other||
<!-- CATEGORIES HERE, THANKS -->
[[Category:Non-subject-matter-related article-talk header templates]]
[[Category:Wikipedia conflict of interest templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>