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.

Diese Vorlage wird auf vielen Seiten verwendet

Um große Unterbrechungen und unnötige Serverauslastung zu vermeiden, solltest du Änderungen an anderer Stelle testen, indem du beispielsweise den Quellcode dieser Vorlage kopierst und in den Benutzerbereich oder in die Sandbox einfügst. Erwäge, deine Änderungen auf der Diskussionsseite vorzuschlagen, bevor du diese Vorlage bearbeitest.

This module is rated as ready for general use. It has reached a mature form and is thought to be relatively bug-free and ready for use wherever appropriate. It is ready to mention on help pages and other Wikipedia resources as an option for new users to learn. To reduce server load and bad output, it should be improved by sandbox testing rather than repeated trial-and-error editing.

Dieses Modul benutzt die Wikidata-Eigenschaften:

Staat (P17) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P37) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P38) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P131) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P218) (siehe Diskussion; Verlinkungen)
Ländercode (ISO 3166-1 alpha-2) (P297) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P361) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P474) (siehe Diskussion; Verlinkungen)
Keine Bezeichnung (P498) (siehe Diskussion; Verlinkungen)

Verwendungszweck

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-01-01

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

Für den Einsatz in den Modulen vCard / Marker

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

function cm.getCountryCode()

Liefert die Landes-Telefonvorwahl als Zeichenkette zurück.