Modul:LinkSkype/Doku
 | Dies ist eine nachgeordnete Seite der Dokumentation von Modul:LinkSkype. Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Modul-Seite ist. |
 | Dieses Modul ist halbgeschützt. Es wird sehr häufig verwendet oder substituiert. Änderungen können zu einer großen Serverlast führen, und Vandalismus kann sich auf eine Vielzahl von Artikel auswirken. |
Anwendung
[Bearbeiten]Das Modul stellt Funktionen zur Verlinkung von Skype-Adressen bereit.
Versionsbezeichnung auf Wikidata: 2023-12-08 
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
[Bearbeiten]Dieses Modul benötigt folgende weitere Module: Link utilities • Link utilities/i18n
Verwendung in anderen Modulen
[Bearbeiten]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:
- vCard
- Modul benötigt das Modul LinkSkype – Wartungskategorie, in der nochmals alle Module gelistet sind, die von diesem Modul abhängig sind.
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.