Editing Template:Extimage/doc

{{documentation}}

Embed external images using internal image-like styling for thumbnails. Only images hosted on the servers listed at the [[MediaWiki:External image whitelist|local image whitelist]] can be embedded directly into a page. Images on any other server will appear as a regular hyperlink. Currently, the following general image hosts are supported:

* [http://imageshack.us ImageShack]
* [https://photobucket.com PhotoBucket]
* [https://imgur.com Imgur]
* [http://tinypic.com TinyPic]
* [https://puu.sh.com Puu.sh]
* [https://dl.dropboxusercontent.com DropBox]
* Wikipedia*

<nowiki>*</nowiki>These sites should not be used as host, but it is possible to use images that are already uploaded to these sites.
===Usage===
<pre>{{Extimage|url|alignment|width|caption (optional)|link=url (optional)}}</pre>

Where:

;url
:The URL of the external image.
;alignment
:Either ''left'', ''center'', or ''right''. The image will be floated so that surrounding text flows around the image. Use {{t|clear}} to reset the document flow.
:For Wikipedia images, leaving this blank results in an in-text image.
;width
:Width of the image, in pixels (without the "px" suffix) but with two subtracted from the value due to poor sitewide CSS decisions (e.g. to achieve an image 300px wide, enter "298")
;caption (optional)
:An optional caption that appears below the image.
:For Wikipedia images, this parameter results in a link (so could be substituted with the <code>link</code> parameter).
;link (optional)
:The URL that the image will link to. By default, the image URL itself is also used as the link URL. The image can be made unclickable by specifying an empty link parameter.
:For Wikipedia images, this parameter is substitutable with the fourth parameter.

{{TemplateData|<templatedata>
{
	"params": {
		"1": {
			"label": "URL",
			"description": "Link to the image file",
			"type": "url",
			"required": true
		},
		"2": {
			"label": "Alignment",
			"description": "Alignment on the page (omit for in-text image)",
			"example": "left, center or right",
			"type": "string"
		},
		"3": {
			"label": "Width",
			"description": "Width of the image, in pixels.\t",
			"type": "number"
		},
		"4": {
			"label": "Caption",
			"description": "Caption to appear below the image. For Wikipedia images, this parameter results in a link(so could be substituted with the link patameter).",
			"type": "string"
		},
		"link": {
			"label": "Link",
			"description": "The URL that the image will link to. The image can be made unclickable by specifying an empty link parameter. For Wikipedia images, this parameter is substitutable with the fourth parameter.",
			"type": "url"
		},
		"height": {
			"label": "Height",
			"description": "Height of the image, in pixels. Defaults to preserve aspect ratio with the image width.",
			"type": "number"
		}
	},
	"description": "Include externally hosted image with size scaling and captioning",
	"paramOrder": [
		"1",
		"2",
		"link",
		"3",
		"4",
		"height"
	],
	"format": "inline"
}
</templatedata>}}