Plugins entwickeln und einreichen

1. Mit dem Beispiel beginnen

Das Beispiel ist eine eigenständige Support-Checkliste im Browser. Es zeigt das Paketformat und benötigt keine Kundendaten oder Zugangsschlüssel. Entpacke es und öffne checklist.html.

Derzeit gibt es keinen allgemeinen Plugin-Loader und keine zugesicherten internen Laufzeit-Hooks in Tickessa. Eigenständige Erweiterungen bringen ihre Einrichtung mit. Eine Integration in interne Oberflächen oder Datenbanktabellen muss vor Entwicklung und Freigabe abgestimmt werden; diese Strukturen sind kein stabiles SDK.

2. Manifest und ZIP-Struktur

tickessa-plugin.json liegt direkt im ZIP, ohne übergeordneten Ordner. Schlüssel und Versionsnummer sind eindeutig. Verwende drei Zahlen für eine stabile Version; jede weitere Einreichung benötigt eine höhere Version.

{
  "schemaVersion": 1,
  "key": "example-checklist",
  "version": "1.0.0",
  "name": {
    "de": "Support-Checkliste",
    "en": "Support checklist"
  },
  "description": {
    "de": "Eine eigenständige Checkliste zur Vorbereitung und Prüfung von Supportfällen.",
    "en": "A standalone checklist for preparing and reviewing support cases."
  },
  "compatibility": {
    "tickessaMin": "0.13.0",
    "tickessaMax": "0.13.0",
    "platforms": [
      "web"
    ]
  },
  "permissions": [
    "browser:local-checklist"
  ],
  "supportUrl": "https://tickessa.de/",
  "license": "perpetual",
  "updates": "one_year",
  "installation": "INSTALL.md",
  "update": "UPDATE.md",
  "uninstall": "UNINSTALL.md"
}

• Name und Beschreibung auf Deutsch und Englisch. Nur Klartext; HTML wird nicht ausgeführt.
• Expliziter getesteter Tickessa-Versionsbereich und Plattformen: web, mac-arm64, windows, linux.
• Alle Zugriffe und Datenübertragungen unter permissions beschreiben. Externe Dienste und Kosten in der Beschreibung nennen.
• INSTALL.md, UPDATE.md, UNINSTALL.md, LICENSE.txt und CHANGELOG.md beilegen. Hinweise zur Sicherung und Wiederherstellung gehören in die Updateanleitung.
• Maximal 4 MiB ZIP, 16 MiB entpackt, 200 Einträge und 1 MiB je Datei. Erlaubt sind Quellcode und Textdateien: JSON, Markdown, TXT, JS/TS, PHP, CSS, HTML, SQL, Shell, YAML. Keine Binärprogramme, Archive im Archiv, symbolischen Links, Abhängigkeitsordner oder Zugangsdaten.

3. Einreichen, testen und freigeben

Beantrage einen Entwicklerzugang, vervollständige das Abrechnungsprofil und akzeptiere die Teilnahmebedingungen. Im Portal legst du pro Version den Erstkaufpreis und den Preis für ein weiteres Updatejahr in EUR netto fest.

Der Upload prüft ZIP-Struktur, Prüfsummen, Metadaten und Pflichtdokumente. Tickessa prüft danach Quellcode, Rechte und Datenschutz sowie Erstinstallation, Update mit vorhandenen Daten, Wiederherstellung und Deinstallation in einer getrennten Testumgebung. Ein optionaler KI-Bericht ergänzt diese Prüfung. Er ist kein Sicherheitszertifikat und veröffentlicht keine Software.

Erst eine manuell freigegebene Version kann den Paddle-Katalog und die Verkaufsseite aktualisieren. Preisänderungen betreffen neue Bestellungen; bestehende Bestellungen behalten ihren vereinbarten Preis.

4. Nutzung, Updates und Vergütung

Käufer erhalten unbegrenzte Nutzung der erworbenen Version und ein Jahr Updates. Eine optionale Verlängerung beginnt am bisherigen Ende, bei abgelaufener Updatezeit mit bestätigtem Kauf. Das Plugin darf bei Ablauf oder vorübergehend fehlender Portalverbindung nicht die bereits bezahlte Nutzung abschalten.

Tickessa vergibt die Berechtigung nach serverseitig bestätigter Zahlung. Der Download prüft Lizenz, Plugin und Veröffentlichungsdatum. Alte berechtigte Versionen bleiben zugänglich. Paddle wird über Zahlungsnachrichten und einen ergänzenden regelmäßigen Abgleich synchronisiert.

Die Vergütung und das monatliche Gutschriftverfahren richten sich nach den verlinkten Teilnahmebedingungen. Abrechnungen zeigen Verkäufe, Gebühren und Korrekturen nachvollziehbar an.