Editing Template:Plinkt/doc

{{Documentation}}
The '''picture link table''' template is a variant of {{t|plink}} used to created image-and-text links within tables.

==Usage==

===1===
The first unnamed parameter takes the name of the page to be linked to. The template will automatically use the same name for the image shown in the first column.

{|class="wikitable"
|+ Example
!Code
! colspan="2" |Produces
!Standard syntax
|-
|<code><nowiki>{{plinkt|Bucket}}</nowiki></code>
|{{plinkt|Bucket}}
| <pre>
| [[File:Bucket.png|link=Bucket]]
| [[Bucket]]
</pre>
|}

===pic===
If included, this changes the filename used; defaults to the first parameter. Do not include "File:" or ".png"

{|class="wikitable"
|+ Example
!Code
! colspan="2" |Produces
!Standard syntax
|-
|<code><nowiki>{{plinkt|Bucket|pic=Brown Kelp}}</nowiki></code>
|{{plinkt|Bucket|pic=Brown Kelp}}
| <pre>
| [[File:Brown Kelp.png|link=Bucket]]
| [[Bucket]]
</pre>
|}

===border===
Use the parameter <code>border=no</code> if the border between the picture and text cells should be removed. If the parameter is not given, the border will not be removed.
{| class="wikitable"
|+ Examples
! Code
! colspan="2" | Produces
! Standard syntax
|-
| <code><nowiki>{{plinkt|Bucket|border=no}}</nowiki></code>
| {{plinkt|Bucket|border=no}}
| <pre>
| style="border-right:	none;" | [[File:Bucket.png|link=Bucket]]
| style="border-left:	none;" | [[Bucket]]
</pre>
|}

=== link ===
Use the parameter <code>link=</code> to set the target page to link to, use <code>link=no</code> to produce plain text:
{|class="wikitable"
!Code
! colspan="2" |Produces
!Standard syntax
|-
| <code><nowiki>{{plinkt|Bucket|link=Brown Kelp}}</nowiki></code>
| {{plinkt|Bucket|link=Brown Kelp}}
| <pre>
| [[File:Bucket.png|link=Brown Kelp]]
| [[Brown Kelp|Bucket]]
</pre>
|-
| <code><nowiki>{{plinkt|Bucket|link=no}}</nowiki></code>
| {{plinkt|Bucket|link=no}}
| <pre>
| [[File:Bucket.png|link=]]
| Bucket
</pre>
|}

=== rowspan ===
Use the parameter <code>rowspan=</code> to control how many rows to output:
{|class="wikitable"
!Code
! colspan="4" |Produces
!Standard syntax
|-
| rowspan="6" | <pre>
| {{plinkt|Jellied Eels|rowspan=4}}
| {{plinkt|Lesser Jellied Eels}}
|-
| {{plinkt|Gray Jellied Eels}}
|-
| {{plinkt|Rocky Jellied Eels}}
|-
| {{plinkt|Rord Jellied Eels}}
</pre>
| {{plinkt|Jellied Eels|rowspan=4}}
| {{plinkt|Lesser Jellied Eels}}
| rowspan="6" | <pre>
| rowspan="6" | [[File:Jellied Eels.png]]
| rowspan="6" | [[Jellied Eels]]
| [[File:Lesser Jellied Eels.png]]
| [[Lesser Jellied Eels]]
|-
| [[File:Gray Jellied Eels.png]]
| [[Gray Jellied Eels]]
|-
| [[File:Rocky Jellied Eels.png]]
| [[Rocky Jellied Eels]]
|-
| [[File:Rord Jellied Eels.png]]
| [[Rord Jellied Eels]]
</pre>
|-
| {{plinkt|Gray Jellied Eels}}
|-
| {{plinkt|Rocky Jellied Eels}}
|-
| {{plinkt|Rord Jellied Eels}}
|}

===size===
The size of an image if the image is too big. Only numbers are allowed; "px" is already included in the code.

===width===
Adjusts the width of the text cell only - without this, adjusting the width like <code><nowiki>| width="200" {{Plinkt|Bucket}}</nowiki></code> will increase the size of both cells. Only numbers are allowed; "px" is already included in the code. This only needs to be set once, on the first row of the table.

Primarily used to ensure consistent column widths across separate tables, as shown below.

<div style="display: flex; justify-content: center; gap: 3em">
<div>
'''Without <code>width</code> set:'''
{| class="wikitable"
! colspan="2" | Item
! Cost
|-
| {{Plinkt|Bucket}}
| {{Currency|20}}
|-
| {{Plinkt|Crate}}
| {{Currency|20}}
|-
| {{Plinkt|Fishing Spear|txt=Fishing Spear and extra long title}}
| {{Currency|12000}}
|}

{| class="wikitable"
! colspan="2" | Item
! Cost
|-
| {{Plinkt|Bucket}}
| {{Currency|20}}
|-
| {{Plinkt|crate}}
| {{Currency|20}}
|}
</div>

<div>
'''With <code>width</code> set:'''
{| class="wikitable"
! colspan="2" | Item
! Cost
|-
| {{Plinkt|Bucket}}
| {{Currency|20}}
|-
| {{Plinkt|Crate}}
| {{Currency|20}}
|-
| {{Plinkt|Fishing Spear|txt=Fishing Spear and extra long title}}
| {{Currency|12000}}
|}

{| class="wikitable"
! colspan="2" | Item
! Cost
|-
| {{Plinkt|Bucket|width=290}} (<code>width</code> specified here)
| {{Currency|20}}
|-
| {{Plinkt|Crate}}
| {{Currency|20}}
|}
</div>
</div>

==See also==
* [[Template:Plink]]

{{TemplateData|<templatedata>
{
	"description": "A variant of the \"Picture Link\" (plink) template, \"Picture Link Table\" (plinkt) is used to display an item image and text link across two table cells.",
	"params": {
		"1": {
			"label": "Item",
			"description": "The item to link to and display",
			"required": true,
			"type": "wiki-page-name"
		},
		"pic": {
			"label": "Image",
			"description": "The name of the image file. Defaults to the Item param.",
			"default": "{{{1}}}",
			"type": "string"
		},
		"txt": {
			"label": "Label",
			"description": "Override the displayed link text.",
			"default": "{{{1}}}",
			"type": "string"
		},
		"link": {
			"label": "Link",
			"description": "The target page to link to.\nSet to \"no\" to produce plain text.\n",
			"suggestedvalues": [
				"no"
			],
			"default": "{{{1}}}",
			"type": "wiki-page-name"
		},
		"border": {
			"label": "Border",
			"description": "Set to \"no\" to hide the border between the picture and text cells",
			"default": "0",
			"autovalue": "1",
			"type": "boolean"
		},
		"size": {
			"label": "Size",
			"description": "The size of the image if resizing is needed (\"px\" is already appended)",
			"type": "string"
		},
		"rowspan": {
			"label": "Row Span",
			"description": "How many rows should the picture link span",
			"default": "1",
			"type": "number"
		}
	}
}
</templatedata>}}
<includeonly>[[Category:Link creating templates|{{PAGENAME}}]]</includeonly>