Modul:CountryData/Doku

Dies ist eine nachgeordnete Seite der Dokumentation von Modul:CountryData.
Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Modul-Seite ist.

Dieses Modul wird auf vielen Seiten benutzt, und Änderungen werden projektweit sofort wahrgenommen. Bitte teste Änderungen vorher im /Sandkasten oder in deinem Benutzernamensraum. Die getestete Änderung sollte dann in einem einzigen Edit auf dieser Seite eingefügt werden. Bitte diskutiere Änderungen zuerst auf der Diskussionsseite bevor du sie implementierst.

Dieses Modul ist getestet und für den projektweiten Gebrauch geeignet. Es kann in Vorlagen benutzt und auf Hilfeseiten erläutert werden. Entwicklungen an dem Modul sollten auf CountryData/Test und die Anwendung auf der Spielwiese getestet werden, da wiederholte Trial-and-Error-Edits die Resourcen stark belasten können.

Dieses Modul benutzt die Wikidata-Eigenschaften:

Staat (P17) (siehe Diskussion; Verlinkungen)
Amtssprache (P37) (siehe Diskussion; Verlinkungen)
Währung (P38) (siehe Diskussion; Verlinkungen)
liegt in der Verwaltungseinheit (P131) (siehe Diskussion; Verlinkungen)
ISO 639-1 (P218) (siehe Diskussion; Verlinkungen)
Ländercode (ISO 3166-1 alpha-2) (P297) (siehe Diskussion; Verlinkungen)
ist Teil von (P361) (siehe Diskussion; Verlinkungen)
internationale Telefonvorwahl (P474) (siehe Diskussion; Verlinkungen)
Währungscode (ISO 4217) (P498) (siehe Diskussion; Verlinkungen)

Verwendungszweck Bearbeiten

Das Modul stellt Funktion zur Bestimmung länderspezifischer Daten wie Wikidata-Qualifikator, ISO-3166-Code, Amtssprache, Landes-Telefonvorwahl und die Landeswährung zur Verfügung.

Die Werte werden teilweise aus der Tabelle Modul:CountryData/Geography bezogen, um teure Wikidata-Abfragen zu vermeiden.

Versionsbezeichnung auf Wikidata: 2023-07-07

Benötigte weitere Module

Dieses Modul benötigt folgende weitere Module: CountryData/Currencies • CountryData/Geography • Wikidata utilities

Verwendung in anderen Modulen

Dieses Modul ist notwendig für die Ausführung folgender Module. Bei Anpassungen sollte die Funktionstüchtigkeit der folgenden Module geprüft werden. Benutze dazu auch diese Tracking-Kategorie um Fehler zu finden, die sich dann auf Artikel auswirken:

GeoData • Phone • Marker • vCard
Modul benötigt das Modul CountryData – Wartungskategorie, in der nochmals alle Module gelistet sind, die von diesem Modul abhängig sind.

Funktionen Bearbeiten

Für den Einsatz in den Modulen vCard / Marker Bearbeiten

function cm.getCountryData( vcEntity )

Parameter: vcEntity: Wikidata-Entity oder nil.

Liefert die landesspezifischen Daten in einer Tabelle zurück.

country = {
	id = '',       -- Wikidata qualifier Q#######, string
	iso_3166 = '', -- ISO 3166-1 code, string, uppercase
	cc = '',       -- country calling code, string starting with +
	lang = '',     -- official language code ISO 639-1, string, lowercase
	currency = ''  -- currency code ISO 4217, string, uppercase
}

function cm.getCountryFromPhones( tab )

Bestimmung der landesspezifischen Daten anhand der Vorwahlnummern aus der Telefonnummerntabelle tab.

function cm.getAdm1st( countryId )

Liefert den ISO-Code 3166-2 für die Verwaltungseinheit erster Ordnung zurück. Übergeben wird die Wikidata-Id für das zugehörige Land, um sicherzustellen, dass die rechenzeitintensive Bestimmung des ISO-Codes nur bei bekanntem Land erfolgt.

function cm.getCategories( formatStr )

Liefert eine Zeichenkette mit den Kategorie-Links aller verwendeten Wikidata-Eigenschaften zurück.

Für den Einsatz im Modul Phone Bearbeiten

function cm.getCountryCode()

Liefert die Landes-Telefonvorwahl als Zeichenkette zurück.