Template:Listing

From Wikivoyage
Jump to navigation Jump to search
[view] [edit] [history] [purge] Template-info.svg 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 on Wikipedia Exploratorium (Q206518) on Wikidata

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}}.

Tracking categories

TemplateData

This template is used for implementing generic business listings. There are a few attraction-specific templates (see, do, buy, eat, drink, sleep) which should be used instead, if applicable.

Template parameters

ParameterDescriptionTypeStatus
Namename

Name of the listing

Default
empty
Example
Natolin metro station
Auto value
Stringrequired
Alternative namealt

Alternative name of the listing (if any)

Default
empty
Example
Kercelak
Auto value
empty
Stringsuggested
URLurl

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

Default
empty
Example
http://um.warszawa.pl
Auto value
empty
URLsuggested
Emailemail

Email address of the listing

Default
empty
Example
empty
Auto value
empty
Stringsuggested
Addressaddress

Postal address of the listing

Default
empty
Example
c/Ochoa 23
Auto value
empty
Stringsuggested
Latitudelat

Latitudinal position (use decimal notation, WGS84 style)

Default
empty
Example
52.231667
Auto value
empty
Numbersuggested
Longitudelong

Longitudinal position (use decimal notation, WGS84 style)

Default
empty
Example
21.006389
Auto value
empty
Numbersuggested
Directionsdirections

Short description of how to get there

Default
empty
Example
Main gate at Mean Street
Auto value
empty
Stringsuggested
Phonephone

Contact phone number

Default
empty
Example
+48 22 987-65-43
Auto value
empty
Stringsuggested
Toll-freetollfree

Toll-free contact number

Default
empty
Example
empty
Auto value
empty
Stringsuggested
Faxfax

Fax number

Default
empty
Example
+48 22 765-43-21
Auto value
empty
Stringsuggested
Operating hourshours

Operating hours of listing

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

Admission price

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

English Wikipedia article of the listing

Default
empty
Example
Natolin metro station
Auto value
empty
Pagesuggested
Wikidata linkwikidata

Wikidata QID of the listing

Default
empty
Example
Q639010
Auto value
empty
Numbersuggested
Commons imageimage

Wikimedia Commons image of the listing for dynamic maps. Omit File:

Default
empty
Example
Giant Mirror at the Exploratorium.jpeg
Auto value
empty
Stringsuggested
Last editlastedit

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

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

Brief description of the listing

Default
empty
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.
Auto value
empty
Contentsuggested

See also