Quelltext der Seite Vorlage:LinkPhone/Doku

{{DU}}__NOTOC__
{{Lua|Modul:LinkPhone}}

{{TemplateData|JSON=
{
	"params": {
		"phone": {
			"aliases": [
				"1",
				"mobile"
			],
			"label": "Telefonnummer",
			"description": "Kommagetrennte Liste von Telefonnummern. Jede Telefonnummer kann einen in Klammern gesetzten Kommentar enthalten.",
			"type": "line",
			"required": true
		},
		"cc": {
			"label": "Ländervorwahl",
			"description": "Ländervorwahl, wenn sie nicht bereits in der Telefonnummer enthalten ist.",
			"type": "line"
		},
		"isFax": {
			"label": "Faxnummer",
			"description": "Der Wert <code>true</code> besagt, dass es sich um eine Faxnummer handelt. Faxnummern werden zwar geprüft, aber nicht verlinkt.",
			"type": "line",
			"suggestedvalues": [
				"true"
			]
		},
		"isTollfree": {
			"label": "gebührenfreie Telefonnummer",
			"description": "Der Wert <code>true</code> besagt, dass es sich um eine gebührenfreie Telefonnummer handelt. In vielen Fällen können derartige Nummern nicht vom Ausland aus angerufen werden und besitzen deshalb auch keine Landesvorwahl (bzw. dürfen es auch nicht). Es wird geprüft, ob die Telefonnummern mit der Vorwahl 800, 0503, 0800, 1300, 1800 oder 01800 beginnen, damit diese Nummern nicht als fehlerhaft gekennzeichnet werden.",
			"type": "line",
			"suggestedvalues": [
				"true"
			]
		},
		"format": {
			"label": "Formatieren",
			"description": "Der Wert <code>true</code> bewirkt, dass die Telefonnummer, die meist aus Wikidata stammt, neu formatiert wird. Die Bindestriche werden durch Leerräume ersetzt, die letzte Zifferngruppe wird mit Leerräumen aufgelockert und dadurch besser lesbar gemacht, und es wird, falls nötig, eine Verkehrsausscheidungsziffer an die Ortsvorwahl angefügt.",
			"type": "line",
			"suggestedvalues": [
				"true"
			]
		},
		"size": {
			"label": "Zifferngruppenbreite",
			"description": "Wird zusammen mit dem Parameter <code>format</code> verwendet und benennt die Breite der Zifferngruppen. Standard ist ''2''. Der Wert für size wird meist dem Array [[Modul:CountryData/Geography]] entnommen. Der Wert ''0'' (Null) bedeutet, dass keine Aufteilung in Zifferngruppen vorgenommen werden soll.",
			"type": "number"
		},
		"demo": {
			"label": "Fehlerkategorien unterdrücken",
			"description": "Der Wert <code>true</code> bewirkt, dass keine Fehlerkategorien ausgegebene werden. Dient hauptsächlich für die Dokumentation im Modul-Namenraum.",
			"type": "line",
			"suggestedvalues": [
				"true"
			]
		}
	},
	"description": "Prüft und verlinkt Telefonnummern. Faxnummern werden überprüft, aber nicht verlinkt.",
	"format": "inline"
}
}}

== Beispiele ==

{| class="wikitable"
|-
! Code
! Ergebnis
|-
| <nowiki>{{LinkPhone | phone = +49 123 2 567.890 App. 5}}</nowiki>
| {{LinkPhone | phone = +49 123 2 567.890 App. 5}}
|-
| <nowiki>{{LinkPhone | phone = +49 123 2 567.890 App. 5 | isFax=true}}</nowiki>
| {{LinkPhone | phone = +49 123 2 567.890 App. 5 | isFax=true}}
|-
| <nowiki>{{LinkPhone | phone = ++49 (123) 2 56 78 90 ext. 34 (Bar)}}</nowiki>
| {{LinkPhone | phone = ++49 (123) 2 56 78 90 ext. 34 (Bar)}}
|-
| <nowiki>{{LinkPhone | phone = +''49'' (0)123 VOYAGE}}</nowiki>
| {{LinkPhone | phone = +''49'' (0)123 VOYAGE}}
|-
| <nowiki>{{LinkPhone | phone = (0)123 256 78 90 | cc=+49}}</nowiki>
| {{LinkPhone | phone = (0)123 256 78 90 | cc=+49}}
|-
| <nowiki>{{LinkPhone | phone = +49 (123) 2 56 78 90 (Lobby Bar), 0049 (123) 2 56 78 91 (Oasis Restaurant)}}</nowiki>
| {{LinkPhone | phone = +49 (123) 2 56 78 90 (Lobby Bar), 0049 (123) 2 56 78 91 (Oasis Restaurant)}}
|-
| <nowiki>{{LinkPhone | phone = +49 (123) 2 56 78 90 oder +49 (123) 2 56 78 90}}</nowiki>
| {{LinkPhone | phone = +49 (123) 2 56 78 90 oder +49 (123) 2 56 78 90}}
|-
| <nowiki>{{LinkPhone | phone = (212) 307 4100 (USA) | cc=+1}}</nowiki>
| {{LinkPhone | phone = (212) 307 4100 (USA) | cc=+1}}
|-
| <nowiki>{{LinkPhone | phone = +49-345-1234567 | format = true }}</nowiki>
| {{LinkPhone | phone = +49-345-1234567 | format = true }}
|-
| <nowiki>{{LinkPhone | phone = +20-92-1234567 | format = true | size = 4 }}</nowiki>
| {{LinkPhone | phone = +20-92-1234567 | format = true | size = 4 }}
|-
| <nowiki>{{LinkPhone | phone = 0800 12 34 56 (gebührenfrei) | isTollfree = true }}</nowiki>
| {{LinkPhone | phone = 0800 12 34 56 (gebührenfrei) | isTollfree = true | demo=true}}
|-
| <nowiki>{{LinkPhone | phone = 112 | cc=+49}}</nowiki>
| {{LinkPhone | phone = 112 | cc=+49 | demo=true}}
|-
| <nowiki>{{LinkPhone | phone = 112 (Notruf) }}</nowiki>
| {{LinkPhone | phone = 112 (Notruf) | demo=true}}
|-
| <nowiki>{{LinkPhone | phone = 0900 12 34 56 (teure Servicenummer)}}</nowiki>
| {{LinkPhone | phone = 0900 12 34 56 (teure Servicenummer) | demo=true}}
|}

== Behandlung von Ausnahmen ==

Telefonnummern sollten üblicherweise aus Landesvorwahl, Ortsvorwahl und Anschlussnummer bestehen. Wenn die Landesvorwahl fehlt, wird getestet, ob eine derartige Vorwahl nötig bzw. erlaubt ist, oder es wird versucht, eine Landesvorwahl zu ergänzen. Dabei wird wie folgt vorgegangen:

# Es wird getestet, ob im Kommentar ein Hinweis zu einer Sondernummer enthalten ist. Wenn ja, erhält die Nummer keine Vorwahl und sie wird als nur im Inland nutzbare Telefonnummer gekennzeichnet. Als Begriffe innerhalb des Kommentars werden ''Servicenummer'', ''Sondernummer'', ''Ortstarif'', ''Inland'' und ''Notruf'' ausgewertet.
# Es wird getestet, ob es sich um eine gebührenfreie Nummer handelt und ob sie mit 800, 0503, 0800, 1300, 1800 oder 01800 beginnt. Wenn ja, erhält die Nummer keine Vorwahl und sie wird als nur im Inland nutzbare Telefonnummer gekennzeichnet.
# Es wird mit Hilfe der mitgelieferten Landesvorwahl {{Code|cc}} getestet, ob es sich um eine länderspezifische Sondernummer handelt. Wenn ja, erhält die Nummer keine Vorwahl und sie wird als nur im Inland nutzbare Telefonnummer gekennzeichnet.
# Es wird die mitgelieferte Landesvorwahl {{Code|cc}} vorangestellt und die Verkehrsausscheidungsziffer 0 eingeklammert.

Erst dann wird die Telefonnummer als fehlerhaft markiert.

== Klassenbezeichner ==

Im HTML-Quelltext werden folgende Klassenbezeichner eingesetzt:

* {{Code|error}} – Klasse der Fehlerausschrift
* {{Code|listing-phone-number}} – Kennzeichnung der Telefonnummer ohne Apparatenummer und Kommentar.
* {{Code|listing-phone-exception}} – Kennzeichnung der Telefonnummer als nur im Inland nutzbare Telefonnummer. Die Telefonnumer besitzt in diesem Fall auch einen entsprechenden Hinweis für den Tooltip. Standardmäßig werden diese Telefonnummern kursiv dargestellt.
* {{Code|listing-add-contact}} – Klassenbezeichner ausgeblendeter Telefonnummern. Wenn mehr als drei Telefon- oder mehr als zwei Faxnummern vorhanden sind, so werden die überzähligen Nummern ausgeblendet, sind aber im HTML-Quelltext vorhanden.
* {{Code|plainlinks}} – Link wird ohne Hinweis auf eine externe Quelle angegeben.

== Daten ==

Im HTML-Quelltext werden folgende Datenbezeichner eingesetzt:

* {{Code|data-phone}} – Enthält die Telefonnummer ohne Sonder- und Leerzeichen, Apparat und Kommentar.

== Wartungskategorien ==

* [[:Kategorie:Kontakt: Telefon ohne Ländervorwahl]]
* [[:Kategorie:Kontakt: Ungültiges Telefonformat]]
* [[:Kategorie:Kontakt: Telefon mit Schrägstrich]]

== Siehe auch ==

* [[Wikivoyage:Telefonnummern]]
<includeonly>[[Kategorie:Vorlagen:Formatierungshilfe|LinkPhone]]</includeonly>