Search by

contaolabs / license-client

contaolabs

Lizenzprüfung für die Erweiterungen von contaolabs.de (Contao 4.13 und 5.x). Prüft einmal täglich im Hintergrund und zeigt bei fehlender Lizenz nur einen Hinweis im Backend.

Package info

github.com/contaolabs/contaolabs-license-client

Homepage

Type:contao-bundle

pkg:composer/contaolabs/license-client

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 8

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.1.3 2026-10-26 13:50 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

Replaces

None

MIT faf7be8c969796bfbc25f69e34f0bd13dabadee8

Published on Packagist.org on 2026-10-26 14:04 UTC

This package is auto-updated.

Last update: 2026-10-26 14:07:12 UTC

README

Gemeinsame Lizenzprüfung für die Erweiterungen von contaolabs.de. Contao 4.13 (und 5.x), PHP 8.1 oder neuer. Wird als Abhängigkeit der Erweiterungen installiert und hat selbst keine Lizenzpflicht (MIT).

Für Shop-Betreiber

Lizenzschlüssel unter System → Einstellungen → contaolabs-Lizenzen eintragen. Die Seite zeigt darunter den Stand der Prüfung.

  • Wann: höchstens einmal täglich je Erweiterung und Domain, nur nach dem Aufruf einer Backend-Seite und erst nachdem die Seite ausgeliefert ist. Beim Speichern eines neuen Schlüssels sofort.
  • Was: Lizenzschlüssel, Produktkennung und Domain, per POST an https://contaolabs.de/api/license. Keine Daten von Besuchern oder Kunden.
  • Welche Domain: die Domains der veröffentlichten Startpunkte (Feld „Domainname“), sonst die Domain des Backend-Aufrufs.
  • Entwicklungsumgebungen: localhost, private IP-Adressen, *.local, *.test, *.localhost, *.ddev.site, *.lndo.site, dev.*, stage.*, staging.*, test.*. Dafür wird nichts gesendet.
  • Seiten von contaolabs: contaolabs.de und alle Subdomains (z. B. demo.contaolabs.de). Läuft eine Installation nur dort, sind alle Erweiterungen ohne Lizenzschlüssel freigeschaltet, und es wird nichts gesendet. Gibt es daneben eine andere Domain, braucht diese wie gewohnt einen Schlüssel.
  • Ohne gültige Lizenz: Die Backend-Bereiche der Erweiterung sind gesperrt (Menüpunkte leiten zu den Einstellungen um, ihre Frontend-Module und Inhaltselemente lassen sich nicht bearbeiten), und auf jeder Backend-Seite steht ein roter Hinweis. Das Frontend läuft immer weiter. Gesperrt wird nur bei fehlendem oder vom Lizenzserver abgelehntem Schlüssel, nie auf Entwicklungsdomains und nie, wenn der Lizenzserver nicht erreichbar ist.
  • Lizenzserver nicht erreichbar: Der letzte Stand bleibt gültig, neuer Versuch nach 6 Stunden. Zeitlimit je Anfrage 3 Sekunden.
  • Zwischenspeicher: var/contaolabs/licenses.json (ohne den Schlüssel selbst). Ist der Ordner nicht beschreibbar, wird gar nicht geprüft.

Die Adresse der API lässt sich mit der Umgebungsvariable CONTAOLABS_LICENSE_API überschreiben (mehrere Adressen durch Komma getrennt).

Für Erweiterungen

In der composer.json "contaolabs/license-client": "^1.1" verlangen und in der config.php die Produktkennung (Alias des Produkts im Shop) mit den Bereichen anmelden, die ohne Lizenz gesperrt werden:

$GLOBALS['CONTAOLABS_LICENSES']['isotope-rent-products'] = [
    'name' => 'Isotope Rent Products',
    'backend_modules' => ['cl_isotope_rent_bookings', 'cl_isotope_rent_blocks'], // do=…
    'module_types' => ['cl_isotope_rent_booking'],                               // tl_module.type
    'content_types' => ['cl_isotope_rent_booking_ce'],                           // tl_content.type
];

Tests

composer install
vendor/bin/phpunit