Template:Listing

From Wikivoyage
Jump to navigation Jump to search
[view] [edit] [history] [purge] Template documentation

Usage

This template is used for implementing generic business listings. There are a few attraction-specific specialized templates which should be used instead, if applicable (see at end of this documentation).

* {{Listing
| type=TYPE OF LISTING (see, do, buy, eat, drink, sleep)
| name=NAME OF LISTING (normally required)
| alt=ALTERNATE NAME (possibly name in a local language)
| wikidata=WIKIDATA QID IDENTIFIER OF THE LISTING
| wikipedia=WIKIPEDIA ARTICLE NAME OF THE LISTING
| url=FULL URL OF LISTING'S WEBSITE (including '''''http[s]://''''' at the start)
| email=EMAIL ADDRESS OF LISTING
| address=PHYSICAL ADDRESS OF LISTING
| lat=LATITUDINAL POSITION OF THE LISTING (positive in the northern hemisphere)
| long=LONGITUDINAL POSITION OF THE LISTING (positive in the eastern hemisphere)
| image=NAME OF IMAGE (for thumbnail displayed when the map marker is clicked – "Image:" or "File:" prefix omitted)
| directions=SHORT DESCRIPTION OF HOW TO GET TO LISTING
| phone=PHONE NUMBER (in international format: +countrycode areacode number)
| tollfree=TOLL-FREE OR FREEPHONE NUMBER (in international format, unless unreachable from abroad)
| fax=FAX NUMBER (in international format)
| hours=OPERATING HOURS OF LISTING
| price=ADMISSION PRICE (range for attractions, one main course for restaurants or one night double occupancy for inns)
| checkin=CHECKIN TIME (sleep listings only)
| checkout=CHECKOUT TIME (sleep listings only)
| lastedit=DATE OF LAST EDIT (in ISO standard format "yyyy-mm-dd", leave this blank if importing info from the venue's website or a secondary source)
| content=BRIEF DESCRIPTION OF THE LISTING
}}

There are no mandatory fields, but it strongly recommended to insert at least one (possibly the name) and preferably more as a {{listing}} with no information is useless to the voyager.

Some caveats:

  • Unlike the old XML listing syntax, do not use quotation marks around your entries.
  • "lat" and "long" are for WGS84 coordinates' latitude and longitude, respectively (as measured and reported by most GPS receptors). Both are indicated in signed decimal form in degrees (using only an optional leading "+" or "-" sign, basic Latin digits, and "." as decimals separator), see example.
    Do not specify any hemisphere name of abbreviation, use an optional leading sign instead: the "-" sign is required in the southern and western hemispheres; negative longitudes are used in the eastern Pacific Ocean, all the Americas, most of the northern Atlantic Ocean including Iceland, Ireland, western UK and France, the Iberian peninsula and north-western Africa).
    Their value should be in the range from -90 to 90 inclusively for the latitude, and in the range from -180 to 180 for the longitude. The geographic poles conventionally use the arbitrary longitude 0.
    However, world maps rendered for the most commonly used 2D projections (Mercator-like, preserving angles and shapes but not relative surfaces) will not display positions at polar latitudes (below roughly -87.5 degrees, or above roughly 87.5 degrees). Some other maps may render all positions, using projections suitable for specific regions (with their own limits).

Microformat

The template emits an hCard microformat.

Example

  • 1 Exploratorium, Pier 15, 698 The Embarcadero (at Green St), +1 415 528-4360. Tu-Su 10AM-5PM; open W until 10PM, closed M. A great kid friendly option, with lots of interactive exhibits teaching about science, with intriguing displays about the mind, natural systems, sound, sight, and much much more. Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free. Exploratorium (Q206518) on Wikidata Exploratorium on Wikipedia

Source:

* {{Listing
| name=Exploratorium | url=http://www.exploratorium.edu/ | email=
| address=Pier 15, 698 The Embarcadero | lat=37.8013 | long=-122.3988 | directions=at Green St
| phone=+1 415 528-4360 | tollfree= | fax=
| hours=Tu-Su 10AM-5PM; open W until 10PM, closed M
| price=Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free
| image=Giant Mirror at the Exploratorium.jpeg | wikipedia=Exploratorium | wikidata=Q206518
| lastedit=2015-01-15
| content=A great kid friendly option, with lots of interactive exhibits teaching about science, with intriguing displays about the mind, natural systems, sound, sight, and much much more.
}}

Notes:

  • This template also allows the insertion of an "edit" link near the end of the generated text. Clicking on it will open a custom form editor to fill in the existing or missing values for supported field values.
  • This "edit" link is added by a javascript extension tool (enabled on Wikivoyage), but it will not be visible in simple browsers (for old smartphones or some TV sets) that don't support Javascript, or in any browser whose Javascript has been disabled, or in any page which is not in the main namespace for articles (so it is also not visible in this template documentation page).

Associated template:

  • Dependent on Template:Marker for creating a listing's header (item type, number, name, URL). The "zoom" and "group" parameters for the {{Marker}} are not currently supported or passed through by {{Listing}}.
  • Lat, long, and wikidata are passed to {{marker}}. With the current behavior of {{marker}}, this means that explicit lat and long values are unnecessary if such values exist on the associated Wikidata item.

Tracking categories

TemplateData

This template is used for implementing business listings.

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
Namename

Name of the listing

Example
Natolin metro station
Auto value
Stringrequired
Alternative namealt

Alternative name of the listing (if any)

Example
Kercelak
Stringsuggested
URLurl

URL of listing's website, including http:// at the beginning

Example
http://um.warszawa.pl
URLsuggested
Emailemail

Email address of the listing

Stringsuggested
Addressaddress

Postal address of the listing

Example
c/Ochoa 23
Stringsuggested
Latitudelat

Latitudinal position (use decimal notation, WGS84 style). Specify NA when coordinates are not applicable, to disallow fetching the value from wikidata

Example
52.231667
Numbersuggested
Longitudelong

Longitudinal position (use decimal notation, WGS84 style). Specify NA when coordinates are not applicable, to disallow fetching the value from wikidata

Example
21.006389
Numbersuggested
Directionsdirections

Short description of how to get there

Example
Main gate at Mean Street
Stringsuggested
Phonephone

Contact phone number

Example
+48 22 987-65-43
Stringsuggested
Toll-freetollfree

Toll-free contact number

Stringoptional
Faxfax

Fax number

Example
+48 22 765-43-21
Stringoptional
Operating hourshours

Operating hours of listing

Example
Tu-Su 10AM-5PM; open W until 10PM, closed M
Stringsuggested
Priceprice

Admission price

Example
Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free
Stringsuggested
Wikipedia articlewikipedia

English Wikipedia article of the listing. Automatically acquired from Wikidata ID if present.

Example
Natolin metro station
Page nameoptional
Wikidata linkwikidata

Wikidata QID of the listing

Example
Q639010
Numbersuggested
Commons imageimage

Wikimedia Commons image of the listing for dynamic maps. Automatically acquired from Wikidata ID if preset. If specifying manually, omit 'File:'

Example
Giant Mirror at the Exploratorium.jpeg
Fileoptional
Last editlastedit

Date of last update (use yyyy-mm-dd)

Example
2016-05-17
Auto value
{{subst:#time:Y-m-d}}
Datesuggested
Descriptioncontent

Brief description of the listing

Example
A great kid friendly option, with lots of interactive exhibits teaching about science, with intriguing displays about the mind, natural systems, sound, sight, and much much more.
Contentsuggested

See also