Plantilla:VCard/doc

Uso

This template describes facilities, accomodations, instituitions etc, but not things like dishes. It should be used as listing elements in articles. If you need it anywhere in the continuous text (to set a marker for an airport or something like that) please use the {{Marker}}

There is a minimum of two parameters, the name and type. If you use Wikidata, the name may not be necessary but you can not identify your listing in the plain wiki text. So please always provide the name. The template has got a huge amount of parameters. The most of them are not needed when Wikidata is used, preferably but setting auto=yes. Misusage of the template or one of its parameters categorizes the article into one or more of the maintenance categories.

Verwendung

Wartung

Fehler bei der Nutzung der Vorlage vCard werden in der Wartungskategorie Wartung vCard angezeigt.

In den meisten Ländern wird die VCard im Blockmodus dargestellt, d. h., sie bildet einen vollständigen Absatz. Ausnahmen sind gegenwärtig nur Deutschland, Österreich, die Schweiz und Italien, in denen die vCard aus historischen Gründen noch im Inline-Modus (Zeilenmodus) angezeigt wird. Diese Ausnahmen werden zukünftig aufgehoben.

Die Vorlage VCard sollte deshalb nicht innerhalb einer Zeile verwendet werden. Möglich sind die Nutzung als allein stehender Absatz oder die Nutzung als ein Listenelement. Ausnahmen können mit dem Parameter show vereinbart werden. Alternativ kann auch die Vorlage {{Marker}} verwendet werden, die für die Verwendung innerhalb einer Zeile geeignet ist.

• Funktion: Die Vorlage dient zur Ausgabe von Angaben, wie sie auf einer Visitenkarte stehen könnten.
• Verwendung: {{VCard | type=a_type | subtype=a_subtype | subtype=a_name | alt=alt_name | comment=a_comment | address=an_adress | directions=directions | wikidata=an_object | url=an_url | facebook=an_username | instagram=an_username | twitter=an_username | lat=a_latidude | long=a_longitude | image=map_image | phone=a_phone | mobile=a_mobile | fax=a_fax | email=an_email | skype=a_contact | hours=hours | checkin=checkin_time | checkout=checkout_time | price=prices | payment=accepted payment | description=a_description }}

• Erforderlicher Parameter:
  • |name= Name der Einrichtung. Der Name darf keine HTML-Tags oder Anführungszeichen " enthalten. Typografische Anführungszeichen sind möglich.
  • |type= Typ der Einrichtung (z. B. hotel, restaurant, nature reserve). In der Vorlage {{vCard}} werden dieselben Typen verwendet. Der Typ legt die Hintergrundfarbe des Markers fest. Die Typbezeichnung besteht aus Kleinbuchstaben und einem bzw. mehreren Leerräumen. Der Typ sollte auch bei vorhandener wikidata-Angabe spezifiziert werden, um Rechenzeit zu sparen. Alle verfügbaren Typen sind in einer Tabelle aufgelistet. Der Typ kann auch aus einer Komma-separierten Aufzählung mehrerer Typen bestehen. Farbbestimmend ist der erste Typ. Beispiele:
    • type = observatory
    • type = restaurant, bar, cafe

• Optionale Parameter:
  • |subtype= Weitere Spezifikation der Einrichtung. Es werden nur diejenigen Werte angezeigt, die in der Tabelle Modul:vCard/Subtypes spezifiziert sind.
  • |name-extra= Namensergänzung, die nicht Bestandteil des Namens ist. Wird an den Namen angefügt.
  • |name-local= Name der Einrichtung in einer Landessprache.
  • |name-latin= Name der Einrichtung in der Umschrift der Landessprache.
  • |alt= Alternative Bezeichnung(en).
  • |comment= Anmerkung zur Bezeichnung.
  • |address= Anschrift der Einrichtung.
  • |address-local= Anschrift der Einrichtung in einer Landessprache.
  • |directions= Anfahrt zur Einrichtung.
  • |directions-local= Anfahrt zur Einrichtung in einer Landessprache.
  • |lat= Breitenangabe (Latitude) der Einrichtung, gültiger Bereich: -90.0 bis 90.0. Um Rechenzeit zu sparen, sollte die Koordinate in Dezimalform und nicht in der Form Grad-Minuten-Sekunden angegeben werden.
  • |long= Längenangabe (Longitude) der Einrichtung, gültiger Bereich: -180.0 bis 180.0. Um Rechenzeit zu sparen, sollte die Koordinate in Dezimalform und nicht in der Form Grad-Minuten-Sekunden angegeben werden.
  • |zoom= Zoomlevel der Karte, die beim Anklicken des Textmarkers angezeigt wird. Standard: 17, gültiger Bereich: 1 bis 19 (1 = Erde, 19 = Teil einer Stadt: Gebäude).
  • |wikidata= Wikidata-Datenobjekt.
  • |auto= j, ja, n, nein, no, y, yes. Alle weiteren in Wikidata verfügbaren Werte werden übernommen/nicht übernommen.
  • |commonscat= definiert eine Commons-Kategorie mit Medien zur Einrichtung. Der Parameter sollte nur verwendet werden, wenn es keinen Wikidata-Eintrag gibt.
  • |url= Internetadresse (URL) der Einrichtung. Dies darf nicht die URL eines Social-Media-Dienstes sein.
  • |facebook= Facebook-Benutzername oder -Webadresse der Einrichtung.
  • |flickr= Name der flickr-Gruppe.
  • |instagram= instagram-Benutzername der Einrichtung.
  • |twitter= Twitter-Benutzername der Einrichtung.
  • |youtube= Kennung oder Name des YouTube-Kanals.
  • |show= Legt den Anzeigemodus fest. Mögliche Werte sind: poi (nur Poi, Standard), all, coord (nur Koordinate), none (nichts), inline, outdent und symbol (Symbol anstelle einer Nummer). Standardmäßig wird die vCard im Block-Modus ausgegeben (bisherige Ausnahmen Deutschland, Italien, Österreich und die Schweiz). Wenn sie innerhalb einer Zeile verwendet werden soll, so muss die Option inline gesetzt werden.
  • |group= überschreibt die automatisch bestimmte Gruppenzugehörigkeit zu buy (Einkaufen), do (Aktivitäten), drink (Ausgehen), eat (Küche), go (Anreise), see (Sehenswürdigkeiten), sleep (Unterkunft) und other (Anderes) für das Marker-Symbol. Weiterhin stehen mehrere Farbangaben wie blue, gold, lime, maroon, mediumaquamarine, red, silver zur Verfügung. Standard ist eine leere Eingabe.
  • |map-group= Gruppenname einer Karte. Diese Gruppen-Namen dürfen nur aus den Zeichen A–Z, a–z und 0–9 bestehen. Diese Parameter wird im Allgemeinen nur genutzt, wenn mehrere Karten in einem Artikel verwendet werden, um die Zugehörigkeit von {{Marker}}n oder {{vCard}}s zu einer bestimmten Karte auszuweisen. Die Vorlage {{vCard}} unterstützt den Parameter map-group nur aus diesem Grund. Die Markerfarbe wird über den Parameter type oder group vermittelt. Die Parameter group und map-group haben unterschiedliche Bedeutung.
  • |image= Bild, das beim Anklicken der Nummer auf der Karte eingeblendet werden soll.
  • |phone= kommaseparierte Telefonnummern der Einrichtung. Zur Behandlung von Ausnahmen wie Notrufen, die nur im Inland gültig sind, siehe auch die Hinweise in der Vorlage {{LinkPhone}}.
  • |tollfree= kommaseparierte gebührenfreie Telefonnummern der Einrichtung.
  • |mobile= kommaseparierte Mobil-Telefonnummern der Einrichtung.
  • |fax= kommaseparierte Faxnummern der Einrichtung.
  • |email= E-Mail-Adresse der Einrichtung.
  • |skype= Skype-Benutzername der Einrichtung.
  • |hours= Öffnungszeiten der Einrichtung.
  • |checkin= Check-in-Zeit.
  • |checkout= Check-out-Zeit.
  • |payment= Akzeptierte Zahlungsarten.
  • |price= Kosten der Nutzung der Einrichtung.
  • |description= Beschreibung
    • |content= Alias für description.
  • |before= Vorangestellte Textteile oder Symbole. Für nachgestellte Angaben lässt sich description benutzen.
  • |lastedit= Datum der letzten Bearbeitung in der Form jjjj-mm-tt. Wenn das angegebene Datum bereits drei Jahre oder länger zurückliegt, wird neben dem Datum der Hinweis ausgegeben, dass die Angaben möglicherweise veraltet sind, und der Artikel wird in der Kategorie VCard: Angaben veraltet vermerkt. Diese Angabe ist keine Pflichtangabe und sollte nur verwendet werden, wenn zeitlich variable Angaben wie Uhrzeiten oder Preise spezifiziert wurden.

• Beispiele:
  • Geschrieben: {{VCard | type= museum | name= Ägyptisches Museum | address= Mīdān at-Taḥrīr | directions= Nordseite des Platzes | url= http://www.emuseum.gov.eg/ | lat= 30.047778 | long= 31°14' 0" E | phone= +20 (0)2 2579 6974 | fax= +20 (0)2 2579 4596 | email= egymu1@idsc.net.eg | hours= Geöffnet täglich 09:00 bis 17:00 Uhr | price= Eintritt LE 50 für Erwachsene, LE 25 für Kinder, Mumiensaal: LE 80 | show= coord }}
  • Leer: {{VCard| type= | name= | address= | directions= | url= | image= | lat= | long= | phone= | fax= | email= | hours= | checkin= | checkout= | price= | payment= | description= }}
  • Realisiert:
    30.04777831.233333Ägyptisches Museum, Mīdān at-Taḥrīr (Nordseite des Platzes). ☎ +20 (0)2 2579 6974, fax: +20 (0)2 2579 4596, ✉: egymu1@idsc.net.eg. 🕓 täglich 09:00 bis 17:00 Uhr. Precio: Eintritt LE 50 für Erwachsene, LE 25 für Kinder, Mumiensaal: LE 80. (30° 2′ 52″ N 31° 14′ 0″ O)última edición: sin información
• Sprungziel:
  • jede VCard erhält automatisch das Sprungziel „vCard_Vcardname“, zum Aufruf also Artikelname#vCard_Vcardname einsetzen, es ist Groß- und Kleinschreibung zu beachten
• Hinweis zu den Reisethemen:
  • Alle für den Reisenden relevanten Objekte (im Normalfall über die VCard in Artikel eingebunden) stehen im Regelfall immer im Ortsartikel. Beziehe dich bei der Arbeit an den Themenartikel nach Möglichkeit immer auf die Ortsartikel. In besonderen Fällen kannst du auch Objekte im Themenartikel platzieren, im Ausnahmefall in beiden. Detailliertere Hinweise findest du im Artikel Wohin damit.
• Bitte Beachten: Innerhalb der vCard keine Zeilenumbrüche (Return) einfügen. Das kann zu Fehlfunktionen führen.

type, group und map-group

Der Parameter type beschreibt möglichst genau die Art einer Einrichtung. Hier soll es nicht nur darum gehen, formal z. B. eine Unterkunft als Unterkunft auszuweisen, sondern konkret z. B. sie als Hotel, Herberge oder Campingplatz zu benennen. Zum einen ist es zukünftig beabsichtigt, die Angaben aus vCards sukzessive nach Wikidata zu transferieren. Dafür wird eine möglichst genaue Instanz („ist ein“) benötigt. Ein zukünftiges Projekt soll zudem ein Reiseplaner sein. Auch hierfür benötigt man eine möglichst genaue Klassifizierung.

Die Typen sind in geeignete Gruppen eingeteilt. Damit besitzen Einrichtungen mit ähnlicher Funktion, aber unterschiedlichen Typen, eine farblich einheitliche Darstellung auf den Karten. Es kann Fälle geben, in denen eine andere Gruppe geeigneter wäre. Mit dem Parameter group ist es möglich, die Standardzuordnung zu überschreiben, ohne den Typ selbst zu ändern. Z. B. werden Stadien üblicherweise für die Durchführung von Sportveranstaltungen verwendet, d. h., sie werden in die Gruppe Aktivitäten (do) einsortiert. Es könnte aber sein, dass architektonische Besonderheiten eine Rolle spielen oder es sich um eine archäologische Stätte handelt. Dann kann man die Einrichtung in eine andere Gruppe, nämlich Sehenswert (see), eingliedern. D. h., auf der Karte wird sie in die Gruppe „Sehenswert“ einsortiert und erhält die Farbe dieser Gruppe.

Auch der Parameter map-group überschreibt type oder group. Zweck ist es, diese Einrichtung auf einer weiteren Karte anzuzeigen, die diese Gruppe map-group anzeigen kann. Hierzu kann der Parameter show der Vorlage {{Mapframe}} angepasst werden. map-group ändert aber nicht die Farbe des Markers. Diese wird aus dem Typ bzw. seiner Gruppe bezogen.

Bezug von Daten aus Wikidata

Die Vorlage vCard kann Daten auch aus Wikidata beziehen. Der Parameter wikidata muss dann zwingend gesetzt sein.

• Erforderlicher Parameter:
  • |wikidata= Wikidata-Datenobjekt. Wenn nicht überschrieben, werden die Koordinate, der Typ, die Interwikilinks (Wikipedia, Commons, Wikidata) und der Hinweis auf ein Weltkulturerbe automatisch übernommen.

• Optionale Parameter:
  • |auto= j, ja, y, yes. Alle weiteren in Wikidata verfügbaren Werte werden übernommen.
  • |param= j, ja, y, yes. Der Parameter param wird aus Wikidata übernommen, falls vorhanden. Wird benutzt, wenn auto = y nicht gesetzt wurde.
  • |param= n, no, nein. Der Parameter param wird in keinem Fall aus Wikidata übernommen, auch wenn er vorhanden sein sollte. Wird benutzt, wenn auto = y gesetzt wurde.

Die Vorlage bezieht noch weitere Angaben wie die Kennungen von Buchungsportalen, Flughafencodes, sozialen Netzwerken und Websitelinks aus Wikidata, die hauptsächlich in der vCard-Info zur Anzeige gelangen.

Abhängigkeiten von show

show	Ansicht
	30.04777831.2333331 Ägyptisches Museum, Mīdān at-Taḥrīr.última edición: sin información
none	30.04777831.233333Ägyptisches Museum, Mīdān at-Taḥrīr.última edición: sin información
poi	30.04777831.2333332 Ägyptisches Museum, Mīdān at-Taḥrīr.última edición: sin información
coord	30.04777831.233333Ägyptisches Museum, Mīdān at-Taḥrīr. (30° 2′ 52″ N 31° 14′ 0″ O)última edición: sin información
all	30.04777831.2333333 Ägyptisches Museum, Mīdān at-Taḥrīr. (30° 2′ 52″ N 31° 14′ 0″ O)última edición: sin información

none ist stärker als poi, coord und all. all ist stärker als poi und coord. Standard ist poi.

Markermodus

Wenn in der vCard keine Anschriften, Kontaktdaten und keine Beschreibung enthalten sind – auch nicht aus Wikidata bezogen –, wird das Ergebnis im Markermodus ausgegeben: Es ist dann ein Inline-Element und enthält keine Interpunktionszeichen. Die Ausgabe ähnelt der der Vorlage {{Marker}}. Das Anfügen von Text hinter der Vorlage sollte dann vermieden werden, wenn weitere Angaben später ergänzt werden.

Beispiel: aus {{vCard | name = Ägyptisches Museum Kairo | wikidata = Q201219 | name-local = j | facebook = j | twitter = j }} wird:

• 30.04777831.2333334 Ägyptisches Museum Kairo (‏j‎), El Tahrir Sq., Downtown, Cairo, ​‏ميدان التحرير ، وسط البلد ، القاهرة‎. ☎ +20 (0)2 2579 6948, ✉: egyptianmuseum@moantiq.gov.eg ​ . 🕓 diario 9:00 am–5:00 pm, 9:00 am–4:00 pm (Ramadán). Precio: LE 30 (Árabes), LE 10 (estudiantes árabes), libre (hasta 5 años; Árabes, desde 61 años), LE 550 (extranjero), LE 275 (estudiantes extranjeros); a partir de 11/2024. (30° 2′ 52″ N 31° 14′ 0″ O)última edición: ene 2024

Template styles

• Plantilla:VCard/styles.css

Technische Dokumentation

• (German Wikivoyage) – Die Seite enthält eine technische Dokumentation zur VCard. Dort sind unter anderem abhängige Module für die Konfiguration und die von der VCard verwendeten CSS-Klassen angegeben.

TemplateData

Parámetros de la plantilla

Parámetro		Descripción	Tipo	Estado
tipo	tipo	tipo de local (hotel, acantilado, puente, oficina, etc.)	Cadena	sugerido
grupo de tipo	grupo	tipo de listado (ver, hacer, comprar, comer, beber y salir, dormir, etc.)	Cadena	obligatorio
características	estrellas	características del local (si disponen de baños, acceso a silla de ruedas, etc.); calificación de estrellas	Cadena	sugerido
opciones de pantalla	show		Cadena	en desuso
wikidata	wikidata	elemento de Wikidata	Cadena	opcional
nombre	nombre	nombre del listado	Cadena	obligatorio
nombre alternativo	alt	nombre alternativo del listado	Cadena	opcional
sitio web	url	sitio web oficial del listado (evítese sitios webs de terceros)	Cadena	opcional
dirección del listado	dirección	dirección del listado	Cadena	opcional
indicaciones	indicaciones	indicaciones sobre la ubicación del listado	Cadena	opcional
latitud	lat		Cadena	opcional
longitud	long		Cadena	opcional
teléfono	tlf		Cadena	opcional
teléfono gratuito	tlf_gratuito		Cadena	opcional
teléfono móvil	mobile		Cadena	opcional
fax	fax		Cadena	opcional
correo electrónico	email		Cadena	opcional
horario	horario		Cadena	opcional
horario de entrada	hora_entrada		Cadena	opcional
horario de salida	hora_salida		Cadena	opcional
precio	precio		Cadena	opcional
método de pago	payment		Cadena	opcional
imagen	imagen		Cadena	opcional
categoría de imagen	commonscat	categoría del listado en Wikimedia Commons (evítese lo más posible, use Wikidata)	Cadena	opcional
nivel de zoom	zoom		Cadena	opcional
preposición	before	Añade información o una imagen antes del listado (incluir alguna aclaración o añadir un icono a la línea de metro del listado, etc) Se debe usar moderadamente.	Cadena	en desuso

See also

related templates

• {{Marker}} – für Angabe von Objekten und Kartenlinks im Fließtext.
• {{Mapframe}} – Fügt eine Karte in den Artikel ein.