View source for Template:Infobox soap character/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
Adapted from the generic {{tl|Infobox character}}, this infobox has been designed specifically to address the particular needs of {{W|fictional character}}s from {{W|soap opera}}s. The template supports all appropriate parameters of the generic template, so that simply replacing '''<nowiki>{{Infobox character}}</nowiki>''' with '''<nowiki>{{Infobox soap character}}</nowiki>''' will preserve all information but add functionality.

The infobox includes a collapsible Family section, with expanded parameters that only appear if used. This portion of the infobox is intended to eliminate the need for additional relationship lists within articles. These lists have repeatedly been identified as unencyclopedic and detrimental to an article's [[Wikipedia:WikiProject Soap Operas/Assessment|quality and status by WP 1.0 standards]]. The collapsing feature allows for the preservation of notable relationship data in an accessible manner while conserving space and not negatively impacting the article.

The template also features the ability to present the Series name in a colored bar below the main image, hidden bars when fields below are empty, standardized image sizing and additional image parameters (for alternate performers in the same role only).

== Usage ==
All parameters are optional, and will not display if empty. The "name" parameter will default to PAGENAME if the parameter is not used; this is usually preferable to keep infobox heading concise, considering that full names (with multiple married names) are usually noted in the lead of each article. If a parameter contains more than two entries, {{tl|Plainlist}} should be used rather than line breaks (<nowiki><br/></nowiki>).

<pre style="overflow:auto">
{{Infobox soap character
| name             = 
| series           = 
| portrayer        = 
| years            = 
| first            = 
| last             = 
| creator          = <!-- Only sourced content -->
| introducer       = <!-- Executive producer at the time -->
| books            = 
| spinoffs         = 
| crossover        = 
| classification   = 
| image1           = <!-- Filename.jpg  (Bare filename) -->
| imagesize1       = <!-- Defaults to 240px -->
| imagealt1        = 
| caption1         = 
| image2           = <!-- For alternate performer only -->
| imagesize2       = <!-- Defaults to 240px -->
| imagealt2        = 
| caption2         = 
| image3           = <!-- For alternate performer only -->
| imagesize3       = <!-- Defaults to 240px -->
| imagealt3        = 
| caption3         = 
| alias            = 
| species          = <!-- For non-humans only -->
| breed            = <!-- For non-humans only -->
| occupation       = 
| residence        = <!-- Or "home" -->
| family           = 
| owner            = <!-- For non-humans (pets) only -->
| parents          = <!-- Or "father" and "mother" -->
| adoptiveparents  = <!-- Or "adoptivefather" and "adoptivemother" -->
| stepparents      = <!-- Or "stepfather" and "stepmother" -->
| siblings         = <!-- Or "brothers" and "sisters" ; "halfbrothers" and "halfsisters" -->
| spouse           = <!-- Or "husband" and "wife" -->
| civilpartner     = 
| children         = <!-- Or "sons" and "daughters" -->
| adoptivechildren = <!-- Or "adoptivesons" and "adoptivedaughters" -->
| stepchildren     = <!-- Or "stepsons" and "stepdaughters" -->
| grandchildren    = <!-- Or "grandsons" and "granddaughters" -->
| grandparents     = <!-- Or "grandfathers" and "grandmothers" -->
| aunts/uncles     = <!-- Or "uncles" and "aunts" -->
| nieces/nephews   = <!-- Or "nephews" and "nieces" -->
| cousins          = <!-- First cousins only -->
| relatives        = <!-- For any other relative not listed above who is essential to the understanding of the character -->
}}
</pre>

== Formatting ==
* To conserve space and improve readability, [[W:WP:COMMONNAME|Common names]] (usually the article name) should be used for links in infoboxes. For example, [[[[W:Sami Brady]]]] instead of the piped link [[[[W:Sami Brady|Sami Brady|Samantha "Sami" Brady DiMera]]]].
* Per [[W:WP:NOTBROKEN]], proper redirects should be used when available rather than piping links directly; for example, use the redirect [[[[W:Pamela Stuart]]]] instead of the direct link [[[[W:List of One Life to Live characters (1980s)#Pamela Stuart|List of One Life to Live characters (1980s)#Pamela Stuart|Pamela Stuart]]]].
* After [[W:Wikipedia_talk:WikiProject_Soap_Operas/Archive_6#Universal_Colour_for_US_Soap_Character_Infoboxes|formed consensus]], all soap infoboxes will use the same color for consistency.
* Small text is no longer used in infoboxes for accessibility reasons. See [[Wikipedia:Manual of Style/Accessibility#Text]] for more information.
* Per the [[W:Wikipedia:CAPFRAG|Manual of Style]], most photo captions are sentence fragments and should ''not'' end with a period. Only captions in the form of complete sentences require punctuation.
* To keep infoboxes uncluttered and easy to read, the MOS also recommends "succinctness" (using no superfluous or needless words) when captioning photos. For the purpose of this infobox, that means:
::: Nancy Lee Grahn as Alexis Davis
::: '''''not''''' Nancy Lee Grahn currently portrays Alexis Davis.

== Relationship parameters ==
The Relationships section of this infobox is collapsed by default to conserve space, and is a direct replacement for any and all other relationship lists within an article. These lists have repeatedly been identified as unencyclopedic and detrimental to an article's [[Wikipedia:WikiProject Soap Operas/Assessment|quality and status by WP 1.0 standards]].

=== Inclusion and notability ===
* Relations need only be noted if the relationship holds some notable significance for the character in question.

* Character age is no longer used after [[W:Wikipedia_talk:WikiProject_Television/Archive_11#Age_fields_in_fictional_character_infoboxes|formed consensus at WikiProject Television]]. This includes the previously used fields "age", "born" and "died". The age of fictional characters is fluid and any ''relevant'' age information can be described in the article.

=== Qualifiers and detail ===
* Descriptions and qualifiers within parameter content are largely unnecessary because of the category names displayed in the infobox; for example, noting "father" or "sister" beside a listed name is discouraged because this information is made obvious by the categories "Parents" or "Siblings" and only clutters the box. 
* When listing children, grandchildren, etc., it is unnecessary to note the parents, etc. that may establish the connection, as in: Junior Jones ''(son, via Mama Mia)''. 
* The "deceased" qualifier should not be used as [[W:WP:FICTENSE|works of fiction exist in a kind of perpetual present tense]]. 
* Only include clarifications essential to understanding the information.
* In summary, '''the infobox is intended as a collection of basic information and a navigational tool, not an abbreviated article. Filling it with endless trivial data defeats this purpose.'''

== Parameter descriptions ==
{| class="wikitable"
! style="background: #C6C9FF; text-align: left;" | Parameter
! style="background: #C6C9FF; text-align: left;" | Explanation
|-
| '''name'''
| Character name for display in header bar; defaults to PAGENAME, which may be preferred to keep header a reasonable size.
|-
| '''series'''
| Applicable series name for display in bar under main image and caption. Do not use a link ( <nowiki>[[ ]]</nowiki> ); name is automatically linked and italicized.
|-
| '''portrayer'''
| Performer name(s), in chronological order with years (not full dates) noted. Closed dates should be separated by an en dash {{xt|–}}. Open dates (for actors currently appearing in the show) should end with {{xt|—present}} per [[W:MOS:DATETOPRES]]. Separate multiple people with line breaks ( <nowiki><br/></nowiki> ).
|-
| '''years'''
| Years the ''character'', not the actor, has appeared (not full dates), i.e. "1996–1999, 2001". Closed dates should be separated by an en dash {{xt|–}}. Open dates (for characters still in the show) should end with {{xt|—present}} per MOS:DATETOPRES. For multiple entries, use {{tl|Flatlist}}.
|-
| '''first'''
| Date, episode number and/or episode name of character's first appearance. Use {{tl|Start date}} for dates.
|-
| '''last'''
| Date, episode number and/or episode name of character's last appearance. Use {{tl|End date}} for dates.
|-
| '''creator'''
| Name of the writer who introduced the character. Only include sourced content; this is ''not'' necessarily the head writer at the time of introduction.
|-
| '''introducer'''
| Executive Producer who introduced the character. If the character was reintroduced by a different executive producer, more than one name can be listed, with the year they were (re)introduced.
|-
| '''books'''
| Novels that the character has appeared in (if any).
|-
| '''spinoffs'''
| [[Spin-off (media)|Spin-off]] series that the character has appeared in (if any).
|-
| '''classification'''
| Can be former, present or future; regular, recurring or guest. Do not use "past" (see talk page discussion about the use of "former" instead of "past").
|-
| '''image1'''
| Primary image to illustrate the character; preferably current or most notable portrayer. Use bare filename (Filename.jpg) with no link; sizing defaults to 240px.
|-
| '''caption1'''
| A caption explaining the image, including link to performer. A caption may not be necessary if a character has been portrayed by only one actor.
|-
| '''image2'''
| Additional character image to illustrate an alternate performer in the role; displays at bottom of main box, before collapsible Relationship section. Use bare filename (Filename.jpg) with no link; sizing defaults to 240px.
|-
| '''caption2'''
| A caption explaining the secondary image, including link to performer.
|-
| '''image3'''
| Additional character image to illustrate an alternate performer in the role; displays at bottom of main box, before collapsible Relationship section. Use bare filename (Filename.jpg) with no link; sizing defaults to 240px.
|-
| '''caption3'''
| A caption explaining the tertiary image, including link to performer.
|-
| '''alias'''
| Any notable aliases or other names used by the character, including married names, where different to the name at the top of the infobox
|-
| '''species'''
| To denote a character's non-human species, if applicable. '''To conserve space, this parameter should only be used for non-humans, which will be extremely rare.'''
|-
| '''occupation'''
| Character's most notable profession(s). The words "current" and "former" are not used, as [[W:WP:FICTENSE|works of fiction exist in a kind of perpetual present tense]]. Instead, durations can be used to clarify, if necessary.
|-
| '''residence'''
| Location where the character lives. If a character is dead, this should be left blank.
|-
| '''family'''
| If there is a Wikipedia article for the main family the character belongs to, add it here.
|-
| '''parents'''
| Names of the character's biological parents. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''adoptiveparents'''
| Names of the character's adoptive parents. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''stepparents'''
| Names of the character's stepparents. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>). Durations for stepparents are not required.
|-
| '''siblings'''
| Name(s) of the character's sibling(s). More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''spouse'''
| Name(s) of the character's spouse(s). Relations by marriage need only be noted if the relationship holds some ''notable'' significance for the characters in question. Durations are listed, any other qualifiers are assumed. Multiple marriages are listed once with additional years in the duration. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''children'''
| Name(s) of the character's biological child(ren). It is unnecessary to note the parents, etc. that may establish the connection, as in: Junior Jones ''(son, via Mama Mia)''. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''adoptivechildren'''
| Names of the character's adopted children. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''stepchildren'''
| Names of the character's stepchildren. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>). Durations for stepchildren are not required.
|-
| '''grandchildren'''
| Name(s) of the character's grandchild(ren). More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''grandparents'''
| Names of the character's grandparents. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''aunts/uncles'''
| Names of the character's aunts and uncles. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''nieces/nephews'''
| Names of the character's nieces and nephews. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
| '''cousins'''
| Names of the character's first cousins. More than two entries should be separated using {{tl|Plainlist}} rather than line breaks (<nowiki><br/></nowiki>).
|-
! style="background: #C6C9FF; text-align: center;" colspan="2" | Holdover parameters from {{tl|Infobox character}}: These parameters are supported to prevent data loss when implementing this infobox, but should be replaced by the appropriate new parameters
|-
! style="background: #C6C9FF; text-align: left;" | Old Parameter
! style="background: #C6C9FF; text-align: left;" | Explanation
|-
| '''image'''
| The old image parameter requires a link (<nowiki>[[ ]]</nowiki> ) and allows for divergent sizing; should be moved to new parameter '''image1''', without link.
|-
| '''caption'''
| Caption related to old image parameter; should be moved to new parameter '''caption1'''.
|}

==See also==
* [[Template:Infobox character]]

<includeonly>{{basepage subpage|
<!-- CATEGORIES HERE, THANKS -->
[[Category:WikiProject Soap Operas|Character]]
[[Category:Fictional character infobox templates|Soap character]]
}}</includeonly>