Handbuch:Erweiterung/ContentDroplets/Eigene Droplets hinzufügen

← Erweiterung/ContentDroplets

 

Es ist möglich eigene existierende Vorlagen oder Tags in den Content-Droplets anzuzeigen.

Wichtig:Wenn Ihre Vorlage Parameter enthält, zeigt das Wiki die Eingabemaske für Parameter erst nach dem ersten Speichern des eingefügten Droplets an. Bei Standard-Droplets wird die Eingabemaske bereits direkt nach dem Einfügen auf der Seite angezeigt.

Überlegen Sie daher, ob es sinnvoll ist, eigene Droplets mit Parametern anzulegen.

Gehen Sie zur Seite MediaWiki:ContentDroplets.json. Falls diese noch nicht existiert, erstellen Sie die Seite. Die Seite wird im json-Format gespeichert und muss eine öffnende und abschließende geschweifte Klammer enthalten:

{

}

Vorlagen-Droplet hinzufügen

Zwischen den Klammern können Sie Ihre Droplets definieren.

{
    "DropletName": {
    	"name": "TemplateDroplet",
        "type": "template",
        "template": "Lorem",
        "params": [
        	{ "color": "blue" },
            { "count": "5" }
        ],
        "description": "message-key",
        "icon": "MyIcon",
        "rlModules": [],
        "categories": [
            "content"
        ],
        "content": "{{Lorem|color=blue|count=5}}"
    }
}

Objekt/Node	Wert (Beispiele)	Beschreibung
DropletName	z. B. TOClimit	Name der Vorlage ohne Leerzeichen (für die Datenbank)
name	Inhaltsverzeichnis	Name, der im Droplet angezeigt wird.
type	template	Bei Vorlagen muss hier der Wert "template" gesetzt werden.
template	TOClimit	Name der existierenden Vorlagenseite im Vorlagennamensraum (kann Leerzeichen beinhalten)
params	"color":"blue"	Name der Parameter, die in der Vorlage existieren. Ein Standardwert kann mitgegeben werden
description	Formatierung des Inhlaltsverzeichnisses anpassen.	Beschreibung des Droplets, die im Droplet-Menü angezeigt wird (kann direkt eingegeben werden oder bei mehrsprachigen Wikis als "message-key".
icon		Hintergrund Icon, welches über MediaWiki:Common.css definiert ist. Wenn hier kein Wert existiert, wird ein graues BlueSpice-Icon angezeigt. /*icon for custom content droplet ISMS check */ .droplet .icon-droplet.MyIcon { background-image: url(/w/nsfr_img_auth.php/6/65/MyIcon.svg); background-size: 35px; }
rlModules	-	-
categories	content, featured	Zeigt die Vorlage in unterschiedlichen Reitern des Droplet-Menüs auf. Mögliche Werte: content, featured, media, visualization, data, navigation, lists, export,all
content	{{TOClimit|color=blue}}	Wikitext, der im Quelltext der Seite eingefügt werden soll (also die Transklusion der Vorlage).

Tag-Droplet hinzufügen

Falls Sie im Wiki ein Tag verwenden, welches unter den Droplets erscheinen soll, geben Sie es folgendermaßen an. Das Beispiel zeigt die Syntax für ein fiktives myTagDroplet nach dem Vorlagen-Droplet DropetName.

{
    "DropletName": {
    	"name": "TemplateDroplet",
        "type": "template",
        "template": "Lorem",
        "params": [
        	{ "color": "blue" },
            { "count": "5" }
        ],
        "description": "message-key",
        "icon": "check",
        "rlModules": [],
        "categories": [
            "content"
        ],
        "content": "{{Lorem|color=blue|count=5}}"
    },
        "myTagDroplet": {
    	"name": "TagDroplet",
    	"type": "tag",
    	"tagname": "Lorem",
    	"attributes": [
    		{ "color": "blue" }
    	],
    	"hasContent": false,
    	"veCommand": "droplet",
    	"description": "message-key",
        "icon": "check",
        "rlModules": [],
        "categories": [
        	"content"
        ],
        "content": "<myDroplet color=blue/>"
    }
}

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.