Editing Template:Marker/doc

{{Documentation subpage}}
__NOTOC__ __NOEDITSECTION__
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
* '''Function:''' This template automatically numbers listings (Points of Interest) which have geographical coordinates (latitude and longitude) given and is typically used in-line in the prose of articles.
* '''Usage:''' <code><nowiki>{{marker|type=|name=|wikidata=}}</nowiki></code>
* '''Recommended parameters:'''
** <code> |type </code> type of listing (see, do, buy, eat, drink, sleep, listing, around, city, other, go, vicinity) — defaults to "listing"
** <code> |name </code> name of listing
**Either <ul><li><code> |wikidata </code> if specified, the missing name/lat/long/image fields will be fetched from the respective wikidata entry fields</li></ul> or <ul><li><code> |lat </code> latitude of listing, valid range: -90.0 to 90.0; specify NA to disallow fetching the value from wikidata</li><li><code> |long </code> longitude of listing, valid range: -180.0 to 180.0; specify NA to disallow fetching the value from wikidata</li></ul>
* '''Optional parameters:'''
** <code> |zoom </code> zoom level for the full-screen map that opens when the listing number is clicked – default=17, valid range: 1 to 18 (1=Earth, 18=city block)
** <code> |url </code> name of listing becomes a link to the specified URL
** <code> |image </code> name of image for the thumbnail that pops up when the map marker is clicked – "File:" prefix not necessary
** <code> |group </code> a map group to which the marker should be added. This parameter should only be necessary when multiple dynamic maps are used on a page; in such cases, the {{tl|mapframe}} template's "show" parameter should match the "group" parameter for its corresponding marker.
* '''Microformat:''' The template emits an [[wikivoyage:Microformats|hCard microformat]].
* '''Examples:'''
** <code><nowiki> {{marker|type=see|name=Museum|lat=51.47766|long=0.00115}} </nowiki></code>
** <code><nowiki> {{marker|type=do|name=Theme Park|lat=51.47766|long=0.00115|zoom=15|url=http://www.example.com/|image=Legoland.jpg}} </nowiki></code>
* '''Associated template:'''
** [[Template:Listing]] for a full listing
** [[Module:TypeToColor]] converts the "type" value passed to this template to a color
** [[Module:Marker]]
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Dynamic map templates]]
</includeonly>

===TemplateData===
<templatedata>
{
	"params": {
		"type": {
			"description": "Type of listing (see, do, buy, eat, drink, sleep, listing, around, city, other, go, vicinity)",
			"type": "content",
			"suggested": true,
			"default": "listing",
			"label": "Type"
		},
		"lat": {
			"label": "Latitude",
			"description": "Latitude of listing, valid range: -90.0 to 90.0;  Specify NA to disallow fetching the value from wikidata or when coordinates are not applicable",
			"type": "number",
			"suggested": true
		},
		"long": {
			"label": "Longitude",
			"description": "Longitude of listing, valid range: -180.0 to 180.0;  Specify NA to disallow fetching the value from wikidata or when coordinates are not applicable",
			"type": "number",
			"suggested": true
		},
		"name": {
			"description": "Name of listing",
			"type": "string",
			"suggested": true,
			"label": "Name"
		},
		"wikidata": {
			"label": "wikidata ID",
			"description": "If specified, the missing name/lat/long/image fields will be fetched from the respective wikidata entry fields.",
			"type": "string",
			"suggested": true
		},
		"zoom": {
			"label": "Zoom level",
			"description": "Zoom level for the full-screen map that opens when the listing number is clicked – default=17, valid range: 1 to 18 (1=Earth, 18=city block)",
			"type": "number",
			"default": "17"
		},
		"image": {
			"description": "Name of image for the thumbnail that pops up when the map marker is clicked – \"File:\" prefix not necessary",
			"type": "wiki-file-name",
			"label": "Image"
		},
		"group": {
			"description": "A map group to which the marker should be added. This parameter should only be necessary when multiple dynamic maps are used on a page",
			"type": "string",
			"default": "Same as type (which itself defaults to listing)",
			"label": "Group"
		},
		"url": {
			"label": "URL",
			"description": "Name of listing becomes a link to the specified URL",
			"type": "url"
		},
		"islisting": {
			"label": "Is listing?",
			"description": "If set to \"yes\", wraps the marker with a <span class=\"vcard\">.",
			"type": "string"
		}
	},
	"description": "This template automatically numbers listings (Points of Interest) which have geographical coordinates (latitude and longitude) given and is typically used in-line in the prose of articles.",
	"paramOrder": [
		"type",
		"name",
		"wikidata",
		"lat",
		"long",
		"zoom",
		"url",
		"image",
		"group",
		"islisting"
	],
	"format": "inline"
}
</templatedata>