Template:Listing

From Wikivoyage
Jump to: navigation, 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}}.

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

Parameter Description Type Status
Name name

Name of the listing

Default
empty
Example
Natolin metro station
Auto value
String required
Alternative name alt

Alternative name of the listing (if any)

Default
empty
Example
Kercelak
Auto value
empty
String suggested
URL url

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

Default
empty
Example
http://um.warszawa.pl
Auto value
empty
URL suggested
Email email

Email address of the listing

Default
empty
Example
empty
Auto value
empty
String suggested
Address address

Postal address of the listing

Default
empty
Example
c/Ochoa 23
Auto value
empty
String suggested
Latitude lat

Latitudinal position (use decimal notation, WGS84 style)

Default
empty
Example
52.231667
Auto value
empty
Number suggested
Longitude long

Longitudinal position (use decimal notation, WGS84 style)

Default
empty
Example
21.006389
Auto value
empty
Number suggested
Directions directions

Short description of how to get there

Default
empty
Example
Main gate at Mean Street
Auto value
empty
String suggested
Phone phone

Contact phone number

Default
empty
Example
+48 22 987-65-43
Auto value
empty
String suggested
Toll-free tollfree

Toll-free contact number

Default
empty
Example
empty
Auto value
empty
String suggested
Fax fax

Fax number

Default
empty
Example
+48 22 765-43-21
Auto value
empty
String suggested
Operating hours hours

Operating hours of listing

Default
empty
Example
Tu-Su 10AM-5PM; open W until 10PM, closed M
Auto value
empty
String suggested
Price price

Admission price

Default
empty
Example
Adults: $25, Students/seniors/youth: $19, Children age 5 and under: Free
Auto value
empty
String suggested
Wikipedia article wikipedia

Wikipedia article of the listing

Default
empty
Example
Natolin metro station
Auto value
empty
Page suggested
Wikidata link wikidata

Wikidata QID of the listing

Default
empty
Example
639010
Auto value
empty
Number suggested
Commons image image

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

Default
empty
Example
Giant Mirror at the Exploratorium.jpeg
Auto value
empty
String suggested
Last edit lastedit

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

Default
empty
Example
2016-05-17
Auto value
{{subst:#time:Y-m-d}}
Date suggested
Description content

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
Content suggested

See also