Modul:LinkSkype/Doku

Aus Wikivoyage

Anwendung[Bearbeiten]

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[Bearbeiten]

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

Wartungskategorie[Bearbeiten]

Beispiele[Bearbeiten]

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[Bearbeiten]

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

Beschreibung der Funktionen[Bearbeiten]

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[Bearbeiten]

  • 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[Bearbeiten]

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.