WSC 3.0 WSC 5.2 WSC 5.3 package.xml

Die package.xml ist die einzige Pflichtdatei, die ihr für die Erstellung eines Plugins benötigt. Die package.xml wird wie alle PIP Dateien in xml geschrieben und muss "package.xml" heißen. Eine andere Schreibweise ist nicht möglich. Innerhalb der package.xml werden die generellen Installations- und Updateinformationen eines Plugins verfasst und sie muss sich im Hauptverzeichnis des Plugins befinden.

1 Die XSD auf GitHub

2 Mögliche Parameter

3 Beispiel package.xml

<?xml version="1.0" encoding="UTF-8"?>
<package name="de.yourecom.example" xmlns="http://www.woltlab.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.woltlab.com https://www.woltlab.com/XSD/2019/package.xsd">
    <packageinformation>
        <packagename><![CDATA[Example Plugin]]></packagename>
        <packagename languagecode="de"><![CDATA[Beispiel Plugin]]></packagename>
        <packagedescription><![CDATA[This plugin is an example plugin.]]></packagedescription>
        <packagedescription languagecode="de"><![CDATA[Dieses Plugin ist ein Beispielplugin]]></packagedescription>
        <standalone>0</standalone>
        <version>1.0.0</version>
        <date>2020-10-01</date>
        <packageurl><![CDATA[http://yourecom.de]]></packageurl>
    </packageinformation>

    <authorinformation>
        <author><![CDATA[Marcel Beckers, YoureCom]]></author>
        <authorurl><![CDATA[http://yourecom.de]]></authorurl>
    </authorinformation>

    <requiredpackages>
        <requiredpackage minversion="5.3.0 Alpha 1">com.woltlab.wcf</requiredpackage>
    </requiredpackages>

    <optionalpackages>
        <optionalpackage file="optionals/de.yourecom.definition2.wbb.tar.gz">de.yourecom.definition2.wbb</optionalpackage>
    </optionalpackages>

    <excludedpackages>
        <excludedpackage version="6.0.0 Alpha 1">com.woltlab.wcf</excludedpackage>
    </excludedpackages>

    <instructions type="install">
        <instruction type="file" />
        <instruction type="acpTemplate" />
        <instruction type="template" />
        <instruction type="sql" />
    </instructions>

    <instructions type="update" fromversion="2.0.*">
        <instruction type="file" />
        <instruction type="acpTemplate" />
        <instruction type="template" />
        <instruction type="sql">update.sql</instruction>
    </instructions>
</package>

4 Gut zu wissen

• Der Paketbezeichner, wird mittels des Parameters name im package Tag definiert. Dieser muss zwingend aus mindestens 3 Teilen bestehen, die jeweils durch einen Punkt voneinander getrennt werden. Es hat sich etabliert, dass der erste Teil des Paketbezeichners die Domain Endung der Website des Entwicklers und der zweite Teil des Paketbezeichners aus dem Domainnamen des Entwicklers besteht. Der dritte Teil besteht dann aus dem Namen des Plugins, der dann auch ggf. in camelCase geschrieben wird. In meinem Fall sieht der Paketbezeichner als folgendermaßen aus: de.yourecom.example
• Innerhalb von requiredpackages, compatibility, optionalpackages und excludedpackages können die Kindelemente beliebig oft wiederholt werden, um so mehrere Plugins verarbeiten zu können.
• Alle Möglichkeiten des type Parameters im instruction Tag werden innerhalb der jeweiligen PIP´s erklärt.
• Woltlab empfiehlt mittlerweile, mittels excludedpackage die nächste Major Version des WSC generell auszuschließen, um so Inkompatibilitäten bereits im Vorfeld auszuschließen.
• Sollte das WSC nicht innerhalb des requiredpackages explizit angegeben werden, so setzt das WSC diese Information während der Installation automatisch.
• Ein Update ist nur möglich, wenn mindestens eine instruction Anweisung vorhanden ist.
• Generell empfehle ich, sich anzugewöhnen, alle möglichen Tags zu setzen. So hat man immer volle Kontrolle darüber, was geschieht und muss nicht ggf. später lästig suchen, wie nochmal der eine Tag lautete, den man ewig nicht benötigte.

Ihr habt Fragen oder Anregungen? Lob oder Kritik? Lasst es mich doch durch einen Kommentar von euch wissen!