Dokumentation für das Modul GetString[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

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:

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

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)
getStringsQuickbar
Sabah
Postleitzahl88000–91999
Vorwahl087-089
Chiang Mai
Postleitzahl50000…50360
Vorwahl52, 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.

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.

Wartungskategorien

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 Klasse qb. Über diese kann man jede Infobox beeinflussen.
  • voy-qb-ort - Alle Orts-Quickbars, die direkt oder indirekt über diese Vorlage eingebunden sind, besitzen diese Klasse
  • voy-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 Klasse voy-qb-de hinterlegt. Lässt sich keine TLD ermitteln, heißt die Klasse qb-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 Spalte
  • voy-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:

Verwendung in Vorlagen

Das Modul wird von folgenden Vorlagen verwendet:

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:

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.
Hinweise
--[=[ 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 '&nbsp;'
   if gsp[property] then
        trClass = ' ' .. gsp[property].cssQBClass .. trClass
        if trLabel == '&nbsp;' 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