Zum Inhalt springen

Modul:LinkSkype

Aus Wikivoyage
Dokumentation für das Modul LinkSkype[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

Anwendung

Das Modul stellt Funktionen zur Verlinkung von Skype-Adressen bereit.

Versionsbezeichnung auf Wikidata: 2023-12-08 Ok!

Kommentare müssen hinter der Emailadresse in Klammern angefügt werden. Als Trenner für mehrere Skype-Namen kann das Komma nicht eingesetzt werden, da es Bestandteil des Skype-Namens sein könnte. Vielmehr muss das Semikolon als Trenner benutzt werden.

Benötigte weitere Module

Dieses Modul benötigt folgende weitere Module: Link utilities • Link utilities/i18n

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:

Regeln für einen Skype-Nutzernamen

  • 6 bis 32 Zeichen,
  • nur ASCII-Kleinbuchstaben, Ziffern, Punkt (.), Komma (,), Bindestrich (-) und Unterstrich (_),
  • erstes Zeichen muss ein Kleinbuchstabe sein.

Wartungskategorie

Beispiele

Text Code Ergebnis
nutzer.name {{#invoke:LinkSkype|linkSkype|nutzer.name}} nutzer.name
nutzer1.name; nutzer2.name {{#invoke:LinkSkype|linkSkype|nutzer1.name; nutzer2.name}} nutzer1.name, nutzer2.name
nutzer1.name, nutzer2.name {{#invoke:LinkSkype|linkSkype|nutzer1.name, nutzer2.name}} nutzer1.name, nutzer2.name Category:Kontakt: Ungültiger Skype-Nutzername Ungültiger Skype-Nutzername
info.name (Information); reserv.name?chat (Reservierung) {{#invoke:LinkSkype|linkSkype|info.name (Information); reserv.name?chat (Reservierung)}} info.name (Information), reserv.name?chat (Reservierung)
info.name (Information); reserv.name?chat (Reservierung); Anderer.Name {{#invoke:LinkSkype|linkSkype|info.name (Information); reserv.name?chat (Reservierung); Anderer.Name}} info.name (Information), reserv.name?chat (Reservierung), Anderer.Name Category:Kontakt: Ungültiger Skype-Nutzername Ungültiger Skype-Nutzername

Fehlersuche

Im Fehlerfall wird neben der Fehlerkategorie auch ein Fehlertext hinter der Email-Adresse ausgegeben.

Beschreibung der Funktionen

function ls.isSkypeName( s )
s: string;

Die Funktion prüft, ob der Skype-Name s gültig ist.

function ls.SkypeLink( m, args )
m: string;
args: arguments array;

Die Funktion prüft und bereitet die Verlinkung des Skype-Namens m vor. Die eigentliche Verlinkung wird mit dem JavaScript MediaWiki:Gadget-MarkerUtilities.js‎‎ durchgeführt.

function ls.linkSkypeSet( args )
args: arguments array;

Die Funktion spaltet eine Liste von Skype-Namen auf und übergibt jeden einzelnen Namen an ls.SkypeLink.

function ls.linkSkype( frame )
frame: frame object;

Die Funktion stellt die Schnittstelle für einen {{#invoke: ...}}-Aufruf zur Verfügung.

function ls.linkSkypeTemplate( frame )
frame: frame object;

Die Funktion stellt die Schnittstelle für einen Vorlagen-Aufruf zur Verfügung.

Bedeutung der Variablen

  • ls.categories – Array mit gleichnamigen Fehlerausschriften und Kategoriennamen.
  • ls.delimiters – Array mit Mustern für Trenner unterschiedlicher Telefonnummern. Das Komma muss nicht in dieses Array eingetragen werden.
  • ls.addNum – Anzahl der sichtbaren, nicht ausgeblendeten Skype-Links. Die überzähligen Links sind aber im HTML-Quelltext enthalten und lassen mit einer Stilvorlage einblenden.
  • ls.params – Array mit einer Liste der erlaubten Parameter in einem Skype-Link.

Klassenbezeichner

Im HTML-Quelltext werden folgende Klassenbezeichner eingesetzt:

  • error – Klasse der Fehlerausschrift.
  • listing-skype-link – Kennzeichnung des Skype-Links ohne Kommentar.
  • listing-add-contact – Klassenbezeichner ausgeblendeter Skype-Links. Wenn mehr als zwei Skype-Namen vorhanden sind, so werden die überzähligen Namen ausgeblendet, sind aber im HTML-Quelltext vorhanden.
Hinweise
-- module variable and administration
local ls = {
	moduleInterface = {
		suite  = 'LinkSkype',
		serial = '2023-12-08',
		item   = 65157314
	}
}

-- module import
-- require( 'strict' )
local li = require( 'Module:Link utilities/i18n' )
local lu = require( 'Module:Link utilities' )

-- check single skype name
function ls.isSkypeName( s )
	if not s or type( s ) ~= 'string' then
		return 0
	end

	local user = s
	local param
	local q = s:find( '?', 1, true )
	if q then
		user = s:sub( 1, q - 1 )
		param = s:sub( q + 1, #s )
		if not li.params[ param ] then
			return 0
		end
	end
	if #user > 32 or #user < 6 then
		return 0
	end
	if not user:match( "^%l[%l%d%.,_%-]+$" ) then
		return 0
	end
	return 1
end

function ls.SkypeLink( m, isDemo )
	m = mw.text.trim( m )
	if m == '' then -- empty string
		return ''
	end
	local catPrefix = '[[Category:'
	if isDemo then
		catPrefix = ' [[:Category:'
	end

	local comment = ''
	local t
	m, comment = lu.extractComment( m )

	m = m:gsub( 'skype:', '' )
	if ls.isSkypeName( m ) > 0 then
		t = '<span class="listing-skype-link">' .. m ..'</span>'
		-- skype: link is performed by a JavaSript: MediaWiki:VCard.js
	else
		t = m .. catPrefix .. li.categories.invalidSkype
	end
	if comment ~= '' then
		t = t .. ' ' .. comment
	end
	return t
end

function ls.linkSkypeSet( args )
	args.skype   = args.skype or args[ 1 ] or ''
	if args.skype == '' then
		return ''
	end

	local ns     = mw.title.getCurrentTitle().namespace
	local isDemo = ns == 10 or ns == 828

	-- split separate Skype names
	local items = lu.splitItems( args.skype, li.delimiters, ';' )

	-- analyse Skype names
	local i = 0
	local s
	local result = ''

	for j = 1, #items, 1 do
		s = ls.SkypeLink( items[ j ], isDemo )
		if s ~= '' then
			if result == '' then
				result = s
			else
				if i == li.addSkype then
					result = result .. '<span class="listing-add-contact">'
				end
				result = result .. li.texts.comma .. s
			end
			i = i + 1
		end
	end
	if i > li.addSkype then
		result = result .. '</span>'
	end
	return result
end

-- #invoke call
function ls.linkSkype( frame )
	return ls.linkSkypeSet( frame.args )
end

-- template call
function ls.linkSkypeTemplate( frame )
	return ls.linkSkypeSet( frame:getParent().args )
end

return ls