Develop and submit plugins

Package format v1, review process and licensing model for Tickessa download-package extensions.

Version 0.17.0 – rental editions

Tickessa 0.17.0 introduces the clearly separated Light, Business and AI editions. The Light and Business installation packages are edition-bound, signed and are only offered in the customer account for the entitled licence. Existing legacy licences and subscriptions remain unchanged.

  • Light is designed for manual email support: up to 2 email accounts, 2 active projects and 3 active users. AI — including the use of your own API keys —, knowledge base, portals, forms, automations, plugins and the external integration API are not included.
  • Business includes the full Tickessa feature set without Light limits. Your own AI provider can be connected; Tickessa AI tokens are not included.
  • AI includes all Business features, hosting and 5 million Tickessa AI tokens per billing month.
  • Self-hosted rental licences do not require continuous online checks. A 14-day grace period applies after the paid term; sign-in, reading, attachments and exports remain available afterward, while editing and sending are locked until renewal.
  • New installations and updates were verified through both browser and command line with PHP 8.5 and MariaDB 11.4. Signed updates, backup, restore, migration rollback and preservation of configuration and attachments are part of the release qualification.

Plans: Light €69/month without or €99/month with hosting; Business €149/month or €1,490/year without hosting, or €199/month with hosting; AI €299/month including hosting. All euro prices exclude VAT.

1. Start with the example

The example is a standalone browser-based support checklist. It demonstrates the package format and requires no customer data or access keys. Extract it and open checklist.html.

Download example package →

Standalone marketplace extensions include their own setup. Operator plugins such as the Tickessa issue tracker are installed separately and are not included in customer packages. The internal extension interfaces are not a public SDK; integration must be agreed before development and approval.

2. Manifest and ZIP structure

Place tickessa-plugin.json at the ZIP root, without a parent directory. The key and version must be unique. Use three numeric components for a stable version; each submission requires a higher 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 and description in German and English. Plain text only; HTML is not executed.
  • Explicit tested Tickessa version range and platforms: web, mac-arm64, windows, linux.
  • Describe all access and data transfers in permissions. Disclose external services and costs in the description.
  • Include INSTALL.md, UPDATE.md, UNINSTALL.md, LICENSE.txt and CHANGELOG.md. The update instructions must cover backups and restoration.
  • Maximum 4 MiB ZIP, 16 MiB expanded, 200 entries and 1 MiB per file. Source and text files are accepted: JSON, Markdown, TXT, JS/TS, PHP, CSS, HTML, SQL, shell and YAML. No executables, nested archives, symbolic links, dependency directories or credentials.

3. Submit, test and approve

Apply for developer access, complete your billing profile and accept the partner terms. For each version, set an initial price and an additional update-year price in EUR excluding tax.

Upload checks validate ZIP structure, checksums, metadata and required documents. Tickessa then reviews source, rights and privacy, and tests installation, updates with existing data, restoration and uninstallation in an isolated environment. An optional AI report supplements the review. It is not a security certificate and cannot publish software.

Only a manually approved version can update the Paddle catalog and sales page. Price changes affect new orders; existing orders retain their agreed price.

4. Usage, updates and remuneration

Buyers receive perpetual use of their purchased version and one year of updates. An optional renewal starts at the existing expiry date, or on confirmed purchase if updates have expired. Plugins must not disable paid perpetual usage on expiry or temporary loss of the portal connection.

Tickessa grants access after server-confirmed payment. Downloads check the licence, plugin and release date. Previously entitled versions remain available. Paddle is synchronized through payment notifications and additional periodic reconciliation.

Remuneration and monthly self-billing follow the linked partner terms. Statements provide a breakdown of sales, fees and adjustments.

5. Issues and developer support

Report bugs, ask technical questions or suggest improvements. Choose a template, describe reproduction steps and include affected versions. You can use multiple labels, Markdown, code blocks, task lists and sanitized attachments.

By default, only your organization and support can read an issue. Explicitly select the developer community to let all signed-in developers participate. Do not include credentials or private customer data in community posts.

The support team works on the same case in Tickessa. Replies appear directly in the issue history. Subscriptions and @mentions lead to your portal inbox. AI replies identify their origin; drafts and internal notes are not published.

Open issue tracker →