Modul:GetString
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 GetString/Test und die Anwendung auf der Spielwiese getestet werden, da wiederholte Trial-and-Error-Edits die Resourcen stark belasten können. |
Funktion
Das Modul bietet einige Funktionen, um Wikidata-Eigenschaften anzuzeigen, die als Zeichenkette gespeichert sind. Das sind die Datentypen string
(einfache Zeichenkette), monolingualtext
(Zeichenkette mit Angabe der Sprache) und external-id
(Objekt-IDs auf externen Webseite, z. B. bei Sozialen Medien). Dabei können sowohl ein Wert (der erste, den die Datenbank liefert) als auch alle Werte geliefert werden. Die Werte werden dabei in der Reihenfolge alphanumerisch sortiert. Gibt es viele Werte kann man das Modul anweisen, einen Bereich auszugeben. Das sind dann der kleinste Wert, gefolgt von drei Punkten und dem größten Wert (siehe z. B. die Postleitzahl in der Infobox von Chiang Mai). Social-Media-IDs können auch als Symbol mit Link ausgegeben werden.
Im Submodul GetString/Properties können einzelne Eigenschaften parametriert werden. Dem Modul nicht bekannte Eigenschaften werden trotzdem ausgegeben. Derzeit sind folgende Eigenschaften implementiert:
- Adresse (P6375)
- Faxnummer (P2900)
- Facebook-Numeric-ID (P11705)
- Facebook-Places-ID (P1997)
- Facebook-Profilkennung (P2013)
- Facebook-Seite (P4003)
- Flickr-Benutzerkennung (P3267)
- IATA-AirlineCode (P229)
- IATA-Code (P238)
- ICAO-Code (P239)
- Instagram-Benutzername (P2003)
- Name in der Amtssprache (P1705)
- Postleitzahl (P281)
- Telefonvorwahl (P473)
- TikTok-Benutzername (P7085)
- TikTok-Place-ID (P11559)
- YouTube-Kanal (P2397)
- YouTube-Alias (P11245)
- X-Benutzername (P2002)
getStrings
getStrings ( id, property, values, show, delimiter, max )
- Aufruf in einer Vorlage:
{{#invoke:GetString|getStrings|id|property|values|show|delimiter|max}}
- Aufruf in einem Modul:
gs.GetString().getStrings(id,property,values,show,delimiter,max)
- Funktion: Liefert den/die numerischen Werte als Tabelle mit ihren Einheiten
- Aufruf in einer Vorlage:
Bei der Verwendung in anderen Modulen muss am Skriptanfang noch ein gs = require( 'Module:GetString' )
eingefügt werden.
Die Funktion arbeitet mit den folgenden anonymen Parametern
|id=
Wikidata-ID des Objektes, kann leer bleiben, wenn der eigene Artikel abgefragt werden soll.|property=
Angabe der Eigenschaft, die abgefragt werden soll.|values=
gibt an, ob der erste gelieferte Wert, oder, wenn vorhanden, alle erfassten Werte eusgegeben Werte, standardmäßig wird nur der erste gefundene Wert verwendet.|values=single
der erste Wert|values=all
alle Werte (Standard)
|show=
gibt die gewünschte Formatierung an.|show=text
gibt nur die Zeichenkette aus (Standard).|show=text_with_language
gibt den Text und danach in Klammern den Sprachcode aus.|show=symbol_with_link
funktioniert nur bei externen Links. Dann wird anstatt der ID ein Symbol mit einem Link erzeugt.|delimiter=
gibt die gewünschte Trennung zwischen den Werten an. Standardmäßig ist das ein Komma gefolgt von einem ungeschützten Leerzeichen.|max=
gibt maximale Anzahl von Werten an, die separat ausgegeben werden. Liefert Wikidata mehr Werte werden nur der kleinste und der größte Wert mit einem Auslassungszeichen dazwischen ausgegeben.
Beispiele:
- Sabah (Postleitzahl, ein Wert auf WD):
{{#invoke:GetString|getStrings|Q179029|P281}}
– 88000–91999 - Sabah (Vorwahl, ein Wert auf WD):
{{#invoke:GetString|getStrings|Q179029|P473}}
– 087-089 - Chiang Mai (Postleitzahl, mehrere Werte auf WD):
{{#invoke:GetString|getStrings|Q233588|P281}}
– 50000, 50110, 50120, 50130, 50140, 50150, 50160, 50170, 50180, 50190, 50210, 50220, 50230, 50240, 50250, 50260, 50270, 50280, 50310, 50320, 50350, 50360 - Chiang Mai (Postleitzahl, mehrere Werte auf WD, nur einen ausgeben):
{{#invoke:GetString|getStrings|Q233588|P281|single}}
– 50000 - Chiang Mai (Postleitzahl, mehrere Werte auf WD, anderes Trennzeichen):
{{#invoke:GetString|getStrings|Q233588|P281||| - }}
– 50000 - 50110 - 50120 - 50130 - 50140 - 50150 - 50160 - 50170 - 50180 - 50190 - 50210 - 50220 - 50230 - 50240 - 50250 - 50260 - 50270 - 50280 - 50310 - 50320 - 50350 - 50360 - Chiang Mai (Postleitzahl, mehrere Werte auf WD, bei mehr als 3 einen Bereich ausgeben):
{{#invoke:GetString|getStrings|Q233588|P281||||3}}
– 50000…50360 - Chiang Mai (Vorwahl, mehrere Werte auf WD):
{{#invoke:GetString|getStrings|Q233588|P473}}
– 52, 53 - Wat Phra Singh (Name in Amts- oder Originalsprache):
{{#invoke:GetString|getStrings|Q1657130|P1705}}
– วัดพระสิงห์วรมหาวิหาร - Wat Phra Singh (Name in Amts- oder Originalsprache + Sprachangabe):
{{#invoke:GetString|getStrings|Q1657130|P1705||text_with_language}}
– วัดพระสิงห์วรมหาวิหาร (th) - Glas-Hotel (alle Adressen + Sprachangabe):
{{#invoke:GetString|getStrings|Q95795329|P6375||text_with_language|<br />}}
- Wincentego Witosa 50, 68-200 Żary, Polen (de-ch)
Wincentego Witosa 50, 68-200 Żary, Polen (de)
Wincentego Witosa 50, 68-200 Żary, Poland (en)
Wincentego Witosa 50, 68-200 Żary, Polska (pl)
Wincentego Witosa 50, 68-200 Żary, Polen (de-at)
- Wincentego Witosa 50, 68-200 Żary, Polen (de-ch)
getStringsQuickbar
Sabah | |
Postleitzahl | 88000–91999 |
---|---|
Vorwahl | 087-089 |
Chiang Mai | |
Postleitzahl | 50000…50360 |
Vorwahl | 52, 53 |
Wat Phra Singh | |
Name (lokal) | วัดพระสิงห์วรมหาวิหาร |
getStringsQuickbar ( id, property, values, wikiValue, label )
- Aufruf in einer Vorlage:
{{#invoke:GetString|getStringsQuickbar|id|property|values|wikiValue|label}}
- Aufruf in einem Modul:
gn.GetString().getStringsQuickbar(id, property, values, wikiValue, label)
- Funktion: Liefert die Werte als Tabellenzeile zur Einbindung in einer Infobox (Quickbar). Es wird immer nur ein Wert abgerufen. Diese Funktion wird im Regelfall nur in anderen Modulen, speziell denen für die Quickbars, benutzt. Der Einsatz in individuell zusammengestellten Infoboxen direkt in Artikeln ist aber trotzdem möglich.
- Aufruf in einer Vorlage:
Dieser Funktion kann auch ein „Sollwert“ für die Ausgabe übergeben werden. Das bewirkt eine Ausgabe dieses Wertes und keine Ausgabe des auf Wikidata gespeicherten Wertes. Ungeachet dessen wird der übergebene Wert mit Wikidata verglichen. Das Ergebnis des Abgleich finden sich in einer Wartungskategorie sowie in zusätzlichen CSS-Klassen. Für den Leser gibt es ein zusätzliches Tooltip mit dem Ergebnis des Vergleichs und dem Wert von Wikidata.
Ein lokaler Wert kann hier auch angegeben werden. Er wird stattdessen ausgegeben aber trotzdem zusätzlich mit Wikidata verglichen. Mit dem optionalen Parameter label
kann man eine den Text in der linken Spalte vorgeben. Ansonsten wird die hinterlegte Standardanzeige verwendet.
getSocialMediaQuickbar
getSocialMediaQuickbar ( id )
- Aufruf in einer Vorlage:
{{#invoke:GetString|getStringsQuickbar|id}}
- Aufruf in einem Modul:
gn.GetString().getStringsQuickbar(id)
- Funktion: Gibt die Social-Media-Links eines Objektes aus. Die Ausgabe erfolgt als Symbol mit Link. Bestimmt Social-Media-Links kann man nicht spezifizieren. Es werden grundsätzlich alle ausgegebne. Lokale ANgaben sind nicht möglich. Es wird immer Wikidata verwendet.
- Aufruf in einer Vorlage:
Wartungskategorien
- Wikidata:Fehlende Eigenschaft
- Wikidata:Unbekannte Eigenschaft
- Kein Wert auf Wikidata: Postleitzahl • Vorwahl • Telefonnummer • IATA-Code • ICAO-Code
- Identischer Wert auf Wikidata: Postleitzahl • Vorwahl • Telefonnummer • IATA-Code • ICAO-Code
- Abweichender Wert auf Wikidata: Postleitzahl • Vorwahl • Telefonnummer • IATA-Code • ICAO-Code
HTML bei Nutzung in den Quickbars
Folgendes HTML wird erzeugt:
<!-- Eintrag für die Zeile -->
<tr class="voy-qb-item voy-qb-item-xxx"> <!-- xxx: Eintrag für die Eigenschaft, Einsehbar in Modul:GetString/Properties unter dem EIntrag "cssClass"-->
<!-- Eintrag für die erste Spalte -->
<th class="voy-qb-item-key">Eigenschaft</th>
<!-- Je nach Auswertung der Daten wird eine der folgenden Zellen ausgegeben -->
<!-- Ein Wikidata-Wert kann nicht ermittelt werden -->
<td class="voy-qb-item-value1 voy-qb-item-value-nowikidata" data-wikidata-id="Wikidata-ID, wenn vorhanden" data-wikidata-value="Wert" title="Tooltip-Info">Wert</td>
<!-- Wikidata-Wert und lokaler Wert sind identisch -->
<td class="voy-qb-item-value1 voy-qb-item-value-wikidata-equal voy-wikidata-content" data-wikidata-id="Wikidata-ID" data-wikidata-value="Wert" title="Tooltip-Info">Wert</td>
<!-- Wikidata-Wert und lokaler Wert unterscheiden sich -->
<td class="voy-qb-item-value1 voy-qb-item-value-wikidata-noequal voy-wikidata-content" data-wikidata-id="Wikidata-ID" data-wikidata-value="Wert" title="Tooltip-Info">Wert</td>
<!-- alle anderen Fälle -->
<td class="voy-qb-item-value1 voy-wikidata-content" data-wikidata-id="Wikidata-ID, wenn vorhanden" data-wikidata-value="Wert">Wert</td>
</tr>
CSS-Klassen bei Nutzung in den Quickbars
Jedes einzelne Informationsfeld der Quickbar lässt sich über CSS individuell gestalten, entweder zentral über die Systemdatei Mediawiki:common.css oder über benutzerspezifische Einstellungen Benutzer:<Dein Name>/common.css. Für Programmierer ist es damit auch möglich, an jedem Feld per Javascript Änderungen vorzunehmen und Werkzeuge zu programmieren.
Die gesamte Quickbar (<table>...</table>
) besitzt drei Klassen.
voy-qb
– Immer vorhanden ist die Klasseqb
. Über diese kann man jede Infobox beeinflussen.voy-qb-ort
- Alle Orts-Quickbars, die direkt oder indirekt über diese Vorlage eingebunden sind, besitzen diese Klassevoy-qb-<top-level-domain>
– Zusätzlich gibt es eine landesspezifische Klasse, die die Top-Level-Domain beinhaltet. Alle Artikel über Deutschland haben in ihrer Quickbar somit zusätzlich die Klassevoy-qb-de
hinterlegt. Lässt sich keine TLD ermitteln, heißt die Klasseqb-unknown-tld
.
Jede Zeile einer Quickbar besitzt eine allgemeine und eine eigene Klasse.
voy-qb-item
– Klasse, die alle Zeilen einer Infobox-Tabelle besitzen.
Jede Spalte einer Zeile der Quickbar (<tr>...</tr>
) hat eine individuelle Klasse, über die die Formatierungen angewendet werden können. Zusätzlich haben alle Spalten jeder Zeile eine individuelle Klasse:
voy-qb-item-key
– Erste Spalte mit der Eigenschaftsbezeichnung (standardmäßig fett geschrieben)voy-qb-item-value1
– Erste (und in der jetzigen Quickbar Ort im Regelfall einzige) Spalte mit einem Wert.voy-qb-item-value2
– weitere Spaltevoy-qb-item-value3
– weitere Spalte
Bei Bildern gibt es nur eine Tabellenzelle mit einem Div-Tag
voy-qb-item-image
– Klasse des<div>...</div>
. Die Positionierung der Bilder erfolgt dann über Flexboxen.
Die value-Spalten haben noch eine oder mehrere Klassen, wenn Daten aus Wikidata bezogen wurden.
voy-wikidata-content
– Zusätzliche Klasse, wenn die angezeigten Daten aus Wikidata stammen. Diese Klasse ist nicht auf die Quickbars beschränkt und kann überall im Artikel auftauchen.voy-qb-item-value-nowikidata
– Über Wikidata konnten keine Daten ermittelt werden. Es ist kein Objekt vorhanden, oder die gewünschte Information ist im Objekt nicht verfügbar.voy-qb-item-value-wikidata-equal
– Es gibt die Information auf Wikidata und es wirde ein lokaler Wert in der Quickbar angegeben (der auch angezeigt wird). Diese Klasse zeigt an, dass beide Werte identisch sind.voy-qb-item-value-wikidata-noequal
– Es gibt die Information auf Wikidata und es wirde ein lokaler Wert in der Quickbar angegeben (der auch angezeigt wird). Diese Klasse zeigt an, dass sich beide Werte unterscheiden.
Beispiele:
.voy-qb-item-population .voy-qb-item-value1 { color:blue; font-style:italic; }
– Die Einwohnerzahl wird blau und kursiv dargestellt..voy-qb-item-value-wikidata-equal { color:green; font-weight:bold; }
– Einträge werden grün und fett dargestellt, wenn sie lokal angegeben wurden und identisch mit Wikidata sind..voy-qb-item-value-wikidata-noequal { color:red; font-weight:bold; }
– Einträge werden rot und fett dargestellt, wenn sie lokal angegeben wurden sich von Wikidata unterscheiden.
Siehe auch:
- Wikivoyage:CSS-Klassen – Dokumentation der CSS-Klassen auf Wikivoyage
Verwendung in Vorlagen
Das Modul wird von folgenden Vorlagen verwendet:
- {{Wikidata}} – Allgemeine Vorlage zur Nutzung von Wikidata
- {{Quickbar Fluggesellschaft}} – Quickbar für Fluggesellschaften
- {{Quickbar Flughafen}} – Quickbar für Flughäfen
- {{Quickbar Ort}} – Quickbar für Orte
- {{Quickbar Region}} – Quickbar für Regionen
Submodule
- GetString/Properties – Enthält Wartungkategorien und Voreinstellungen für die einzelnen Properties. Obwohl theoretisch jede Property ohne Voreinstellungen abgefragt werden kann, sollten häufig benutzte Properties hier konfiguriert werden.
Benötigte weitere Module
Dieses Modul benötigt folgende weitere Module: CountryData • LinkPhone
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:
- Quickbar Fluggesellschaft • Quickbar Flughafen • Quickbar Ort • Quickbar Region
- Modul benötigt das Modul GetString – Wartungskategorie, in der nochmals alle Module gelistet sind, die von diesem Modul abhängig sind.
Verwandte Module
- GetP856 – Liefert die Offizielle Webseite eines Objektes.
- GetNumber – Liefert numerische Eigenschaften eines Objektes, wie z. B. Fläche, geografische Höhe und Einwohnerzahl von Regionen bzw. Orten.
- GetImage – Liefert Dateinamen von Bildateien.
- GetItem – Liefert Eigenschaften, die als Wikidata-Objekt erfasst sind. Das Ergebnis können Links auf Wikivoyage oder Wikipedia-Artikel sein.
- GetProvince – Ermittelt rekursiv die erste Verwaltungsstufe eines Ortes (Bundesland, Provinz usw.).
Trackingkategorien und Spezialseiten
- Seiten mit Skriptfehlern – Listet Seiten auf, bei denen Lua-Skripte Fehler verursachen.
- Gewünschte Kategorien – Gewünschte Kategorien. Hier tauche eine neue Kategorie der Art Seiten, die die Wikidata-Eigenschaft Pxxx benutzen auf, wenn eine bisher nicht genutzte Eigenschaft irgendwo verwendet wird.
- Die obige Dokumentation wurde aus der Seite Modul:GetString/Doku eingefügt. (bearbeiten | Versionsgeschichte) Die Kategorien für dieses Modul sollten in der Dokumentation eingetragen werden. Die Interwiki-Links sollten auf Wikidata eingepflegt werden.
- Liste der Unterseiten
--[=[ getString 2023-10-04
* local getStringsWithLanguage (internal use)
* getStrings
* getStringsQuickbar
* getSocialMediaQuickbar
]=]
local GetString = {}
-- maximum number of entries in quickbar
local maxDisplayQuickbar = 3
-- categories and properties for data evaluation
local gsp = require ( 'Modul:GetString/Properties' )
-- modules for linking and formatting phone number
-- loaded later,if necessary
local cm
local lp
local args = {}
-- returns nil, if both values are equal, otherwise the value
-- similar to the SQL function nullif()
local function nilIf ( value, equalValue )
if ( value == nil ) then
return nil
elseif ( tostring ( value ) == tostring ( equalValue ) ) then
return nil
else
return value
end
end
-- returns the first value that is not nil
-- similar to the SQL function coalesce()
local function coalesce ( value1, value2, value3 )
return value1 or value2 or value3
end
-- getStringsWithLanguage() -> just for internal use. it delivers the url to the public functions
-- gets text of a property
-- it supports the datatypes "string", "monolingualtext" and "external-id"
-- id: Wikidata-ID (own, if not provided)
-- property: requested property
local getStringsWithLanguage = function ( id, property )
-- local variables
-- ID of the item
-- Determined, if not provided
local localID = id or mw.wikibase.getEntityIdForCurrentPage() or ''
-- compatibility to existing modules and templates:
-- some use the keyword "self" for using the own entity-ID
if ( ( localID == 'self' ) or ( localID == '' ) ) then
localID = mw.wikibase.getEntityIdForCurrentPage() or ''
end
-- no Wikidata object
if localID == '' then
return {}, '', ''
end
-- maintenance categories
local maintenanceCategory = ''
-- property
local requestedProperty = property or 'none';
if string.sub(requestedProperty,1,1) ~= 'P' then
requestedProperty = 'none'
end
-- no property given: category and exit
if requestedProperty == 'none' then
maintenanceCategory = maintenanceCategory .. gsp.noProperty
return {}, localID, maintenanceCategory
end
-- property unknown in table "gsp": category but continue
if not gsp[requestedProperty] then
maintenanceCategory = maintenanceCategory .. gsp.unknownProperty
end
-- phone numner? load the linkphone modules
if requestedProperty == 'P1329' then
cm = require( 'Module:CountryData' )
lp = require( 'Module:LinkPhone' )
end
-- getting the values
local wdStatements = mw.wikibase.getBestStatements( localID, requestedProperty )
-- running through the array and store it in a simple table
local wdValues = {}
local language = ''
for i, entry in pairs ( wdStatements ) do
-- check for string
if entry.mainsnak.datatype == 'string' then
-- phone numner? then format and link it
-- and adding to the list
if requestedProperty == 'P1329' then
args = {
phone = entry.mainsnak.datavalue.value,
format = true,
isFax = false,
isTollfree = false
}
args.cc, args.size = cm.getCountryCode()
wdValues[i] = lp.linkPhoneNumbers( args )
else
wdValues[i] = entry.mainsnak.datavalue.value
end
end -- if entry.mainsnak.datatype == 'string'
-- check for monolingualtext
if entry.mainsnak.datatype == 'monolingualtext' then
-- getting the amount, converted into a number
language = entry.mainsnak.datavalue.value.language or i
-- adding to the list
if not wdValues[language] then
wdValues[language] = entry.mainsnak.datavalue.value.text
end
end -- if entry.mainsnak.datatype == 'monolingualtext'
-- check for external-id
if entry.mainsnak.datatype == 'external-id' then
wdValues[i] = entry.mainsnak.datavalue.value
end -- if entry.mainsnak.datatype == 'external-id'
language = ''
end -- for i, entry in ipairs ( wdStatements )
-- adding category
if #wdValues > 0 then
maintenanceCategory = maintenanceCategory .. '[[Kategorie:Seiten, die die Wikidata-Eigenschaft ' .. requestedProperty .. ' benutzen]]'
end
table.sort( wdValues, function(a,b) return a < b end )
return wdValues, localID, maintenanceCategory
end
-- getStrings()
-- gets the text of a property including its language
-- first parameters: see internal function
-- values:
-- - single: Only one (first) entry is shown
-- - all (standard): All entries ar shown
-- show:
-- - text (standard): just the text
-- - text_with_language: text with language in brackets
-- - symbol_with_link: for social media: displays the link as symbol
-- delimiter: delmiter between the numbers; standard is comma and breakable space
-- max: if the number of rows exceeds the given maximum, it will be displayed as a range
GetString.getStrings = function ( id, property, values, show, delimiter, max )
-- returning String
local returnString = ''
-- values
local requestedValues = values or 'all'
-- WD-Values
local stringList = {}
local wikidataID = ''
local categories = ''
stringList, wikidataID, categories = getStringsWithLanguage ( id, property, values )
-- show options
local stringShow = coalesce ( nilIf ( show, '' ), 'text' )
-- no delimiter in front of the first entry
local stringDelimiter = ''
-- maximum
local maxDisplay = tonumber( max ) or 0
local showRange = false
-- displaying the values
local allValues = true
local numberOfRows = #stringList
if ( maxDisplay > 0 ) and ( numberOfRows > maxDisplay ) then
showRange = true
end
local rowNumber = 1
for key, value in pairs( stringList ) do
if allValues then
if showRange and ( rowNumber + 1 == numberOfRows ) then
returnString = returnString .. '…'
elseif not ( showRange ) or ( rowNumber == 1 ) or ( rowNumber == numberOfRows ) then
-- displaying with language
if stringShow == 'text_with_language' then
if key == '1' then
returnString = returnString .. stringDelimiter .. value
else
returnString = returnString .. stringDelimiter .. value .. ' (' .. key .. ')'
end
-- displaying social media with string
elseif stringShow == 'symbol_with_link' then
local span = mw.html.create ( 'span' )
local href = ''
-- property specific classes and links
if gsp[property] ~= nil then
if gsp[property].cssSymbolClass ~= nil then
span:addClass('voy-social-media voy-social-media-icon ' .. gsp[property].cssSymbolClass)
end
if gsp[property].link ~= nil then
span:wikitext('[' .. mw.ustring.format ( gsp[property].link, value ) .. ' <span title="' .. gsp[property].label .. ': ' .. value .. '" data-icon="facebook" style="color-adjust:exact;-webkit-print-color-adjust:exact;print-color-adjust:exact"> </span>]' )
else
span:wikitext(value)
categories = categories .. '[[Kategorie:Social-Media-Link nicht konfiguriert]]'
end
returnString = returnString .. stringDelimiter .. tostring(span)
end
-- displaying just the text
else
returnString = returnString .. stringDelimiter .. value
end
-- setting the delimiter after the first entry
if not ( showRange ) then
stringDelimiter = delimiter or ', '
end
-- Abbruch?
if requestedValues == 'single' then
allValues = false
end
end
end
rowNumber = rowNumber + 1
end
-- providing the list of capitals
return returnString .. categories
end
-- Get the string as wiki markup for quickbars (infoboxes)
-- "values" is set to "all", if not provided
-- "label" is an optional text, shwon as key in the left side of the quickbar entry
GetString.getStringsQuickbar = function ( id, property, values, wikiValue, label )
-- checking property
if coalesce ( property, '' ) == '' then
return ''
end
-- getting the link with the base function above
local wikidataID
local wikidataStrings = {}
local wikidataCategories
wikidataStrings, wikidataID, wikidataCategories = getStringsWithLanguage ( id, property )
-- if it is taken from wikidata, this variable provides an additional class for: MediaWiki:Gadget-Wikidata-Content.css
-- space is needed becaus its simply added to the existing class string
local wikidataClass = ' voy-wikidata-content'
-- comparing a possibly given value with Wikidata
local category = ''
-- is Wikidata value not available?
local wikidataNoData = false
if wikidataID == '' then
if gsp[property] ~= nil then
category = gsp[property].noData
wikidataNoData = true
end
wikidataClass = ''
end
-- values
local requestedValues = coalesce ( nilIf ( values, '' ), 'all' )
-- creating text for display
local returnString = ''
local stringDelimiter = ''
local allValues = true
-- maximum
local showRange = false
-- Wikidate comparision tags
-- is Wikidata available
local wikidataAvailable = true
-- is one of the entries equal to the wiki value?
local wikidataOneIsEqual = false
local wikidataEqualData = false
-- are none of the entries equal to the wiki value?
-- starting with false
-- later initialised to true, when local wiki value is given
local wikidataNothingIsEqual = false
local wikidataNoEqualData = false
-- processing nil value for wikiValue
if wikiValue == nil then
wikiValue = ''
end
-- wikivalues, that can be interpreted as "TRUE" are removed and Wikidata is used
-- it's used to switch entries on and off in Quickbars
if wikiValue =='yes'
or wikiValue == 'y'
or wikiValue == 'true'
or wikiValue == 'wahr'
or wikiValue == 'ja'
or wikiValue == 'j'
then
wikiValue = ''
end
-- processing wikiValue
if wikiValue ~= '' then
-- starting with TRUE by default
-- set to FALSE if one value is equal
wikidataNothingIsEqual = true
wikidataNoEqualData = true
end
-- displaying the values and compare with Wikidata
local allValues = true
local numberOfRows = #wikidataStrings
if ( maxDisplayQuickbar > 0 ) and ( numberOfRows > maxDisplayQuickbar ) then
showRange = true
end
local rowNumber = 1
for key, value in pairs( wikidataStrings ) do
if allValues then
if showRange and ( rowNumber + 1 == numberOfRows ) then
returnString = returnString .. '…'
elseif not ( showRange ) or ( rowNumber == 1 ) or ( rowNumber == numberOfRows ) then
returnString = returnString .. stringDelimiter .. value
-- setting the delimiter after the first entry
if not ( showRange ) then
stringDelimiter = ', '
end
-- Abbruch?
if requestedValues == 'single' then
allValues = false
end
end
end
-- comparing with Wikidata
if wikiValue ~= '' then
if value == wikiValue then
wikidataOneIsEqual = true
end
end
rowNumber = rowNumber + 1
end
-- phone numner? then format and link it
if wikiValue ~= '' and coalesce ( property, '' ) == 'P1329' then
cm = require( 'Module:CountryData' )
lp = require( 'Module:LinkPhone' )
args = {
phone = wikiValue,
format = true,
isFax = false,
isTollfree = false
}
args.cc, args.size = cm.getCountryCode()
wikiValue = lp.linkPhoneNumbers( args )
end
-- saving wikidata value in case of a local string is used
local wikidataString = returnString
-- do not state "different values", when no wikidata value is available
if numberOfRows == 0 then
wikidataNoEqualData = false
wikidataClass = ''
end
-- Setting Wikidata categories
if wikiValue ~= '' then
-- setting the categories
if gsp[property] ~= nil then
if wikidataOneIsEqual then
category = category .. gsp[property].equalData
wikidataEqualData = true
end
if wikidataNothingIsEqual and numberOfRows > 0 then
category = category .. gsp[property].noEqualData
wikidataNoEqualData = true
end
end
-- displaying the wikiValue
returnString = wikiValue
-- removing the WD-Class
wikidataClass = ''
end
-- displaying only, if any data available
local trClass = ''
if returnString == '' then
trClass = ' voy-qb-empty'
end
-- creating the table row
local tr = mw.html.create ( 'tr' )
-- first table cell (heading)
local trLabel = label or ' '
if gsp[property] then
trClass = ' ' .. gsp[property].cssQBClass .. trClass
if trLabel == ' ' then
trLabel = gsp[property].label
end
end
tr:addClass('voy-qb-item' .. trClass )
:tag('th')
:addClass('voy-qb-item-key')
:wikitext(trLabel)
-- second table cell (the requested number)
if wikidataNoData then
tr:tag('td')
:addClass( 'voy-qb-item-value1 voy-qb-item-value-nowikidata' .. wikidataClass )
:attr('data-wikidata-id',wikidataID)
:attr('title','Kein(e) ' .. trLabel .. ' auf Wikidata' )
:wikitext( returnString )
elseif wikidataEqualData then
tr:tag('td')
:addClass( 'voy-qb-item-value1 voy-qb-item-value-wikidata-equal' .. wikidataClass )
:attr('data-wikidata-id',wikidataID)
:attr('data-wikidata-value',wikidataString)
:attr('title','Daten identisch - Angabe auf Wikidata: ' .. wikidataString)
:wikitext( returnString )
elseif wikidataNoEqualData then
tr:tag('td')
:addClass( 'voy-qb-item-value1 voy-qb-item-value-wikidata-noequal' .. wikidataClass )
:attr('data-wikidata-id',wikidataID)
:attr('data-wikidata-value',wikidataString)
:attr('title','Daten unterschiedlich - Angabe auf Wikidata: ' .. wikidataString )
:wikitext( returnString )
else
tr:tag('td')
:addClass( 'voy-qb-item-value1' .. wikidataClass )
:attr('data-wikidata-id',wikidataID)
:attr('data-wikidata-value',wikidataString)
:wikitext( returnString )
end
-- returning the row
return tostring ( tr ) .. category .. wikidataCategories
end
-- Gets the socialmedia-Links and creates a quickbar row
GetString.getSocialMediaQuickbar = function ( id )
-- creating the wikitext for the row
-- facebook profile
local socialmedia = coalesce ( GetString.getStrings ( id, 'P2013', 'all', 'symbol_with_link' ) )
-- facebook page
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P4003', 'all', 'symbol_with_link' ) )
-- facebook places id
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P1997', 'all', 'symbol_with_link' ) )
-- instagram username
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P2003', 'all', 'symbol_with_link' ) )
-- X username
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P2002', 'all', 'symbol_with_link' ) )
-- YouTube-Kanal
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P2397', 'all', 'symbol_with_link' ) )
-- YouTube-Alias
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P11245', 'all', 'symbol_with_link' ) )
-- TikTok username
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P7085', 'all', 'symbol_with_link' ) )
-- TikTok place ID
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P11559', 'all', 'symbol_with_link' ) )
-- Flickr user ID
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P3267', 'all', 'symbol_with_link' ) )
-- Hashtag
socialmedia = socialmedia .. coalesce ( GetString.getStrings ( id, 'P2572', 'all', 'symbol_with_link' ) )
-- creating only, when any social media is available
if socialmedia ~= '' then
-- creating the table row
local tr = mw.html.create ( 'tr' )
tr:addClass('voy-qb-item voy-qb-item-social-media' )
:tag('th')
:addClass('voy-qb-item-key')
:wikitext( 'Social Media' )
tr:tag('td')
:addClass( 'voy-qb-item-value1' )
:wikitext(socialmedia)
-- returning the row
return tostring ( tr )
else -- socialmedia == '' then
return ''
end -- if socialmedia ~= '' then
end
-- Providing template access
local p = {}
function p.getStrings( frame )
return GetString.getStrings( frame.args[ 1 ], frame.args[ 2 ], frame.args[ 3 ], frame.args[ 4 ], frame.args[ 5 ], frame.args[ 6 ] ) or ""
end
function p.getStringsQuickbar( frame )
return GetString.getStringsQuickbar( frame.args[ 1 ], frame.args[ 2 ], frame.args[ 3 ], frame.args[ 4 ] ) or ""
end
function p.getSocialMediaQuickbar( frame )
return GetString.getSocialMediaQuickbar( frame.args[ 1 ] ) or ""
end
-- for usage in other modules
-- using it the following way:
--
-- local GetString = require( 'Module:GetString' )
-- foo = getString.GetString().xxx( id, lang )
function p.GetString()
return GetString
end
return p