Dokumentation

Installieren, einrichten, loslegen

Alle contaolabs-Erweiterungen laufen unter Contao 4.13 LTS mit Isotope eCommerce 2.9 und PHP ab 8.1. Hier findest du Installation, Lizenzaktivierung und die wichtigsten Einstellungen.

Installation über den Contao Manager

  1. Erweiterung im Shop kaufen – Lizenzschlüssel und Paketdateien findest du anschließend unter „Mein Konto“.
  2. Im Contao Manager auf „Pakete hochladen“ klicken und die ZIP-Datei der Erweiterung auswählen. Beim ersten Mal zusätzlich license-client-….zip hochladen: Das ist die Lizenzprüfung, die sich alle contaolabs-Erweiterungen teilen.
  3. „Änderungen anwenden“ und anschließend „Datenbank aktualisieren“.
  4. Lizenzschlüssel unter System → Einstellungen → contaolabs-Lizenzen eintragen und speichern.

Lizenz & Domains

Die Standard-Lizenz gilt für eine Live-Domain, Entwicklungsumgebungen wie localhost, *.local, *.test, *.ddev.site oder staging.* zählen nie mit, Subdomains für Sprachversionen gehören zur selben Installation. Die Agentur-Lizenz gibt es in vier Stufen: S bis 5, M bis 15, L bis 30 Live-Installationen und Unlimited ohne Obergrenze (faire Nutzung).

Wie viele Installationen eine Lizenz schon nutzt, steht unter „Mein Konto“. Ist die Obergrenze erreicht, wird die nächste Live-Domain nicht freigeschaltet. Dann wechselst du unter „Mein Konto“ in eine höhere Stufe und zahlst nur den Unterschied. Lizenzschlüssel und Update-Zeitraum bleiben gleich. Domain-Wechsel? Schreib uns kurz an support@contaolabs.de – wir geben die alte Domain frei.

Lizenzschlüssel eintragen

Unter System → Einstellungen gibt es den Bereich contaolabs-Lizenzen mit einem Feld für jede installierte Erweiterung. Trag dort den Schlüssel aus „Mein Konto“ ein und speichere. Der Schlüssel wird sofort geprüft, darunter siehst du den Stand: gültig, Lizenzart und wie lange Updates und Support laufen.

  • Wann wird geprüft? Höchstens einmal am Tag, im Hintergrund nach dem Aufruf einer Backend-Seite. Das Frontend deines Shops wird nie gebremst.
  • Was wird übertragen? Nur Lizenzschlüssel, Produktkennung und die Domain deiner Website. Keine Daten deiner Besucher oder Kunden.
  • Welche Domain? Die Domains deiner Startpunkte (Feld „Domainname“ in der Seitenstruktur). Subdomains für Sprachversionen wie en.dein-shop.de gehören zur selben Standard-Lizenz.
  • Entwicklung und Staging: Unter localhost, *.local, *.test, *.ddev.site, dev.* oder staging.* brauchst du keinen Schlüssel. Dafür wird nichts übertragen.
  • Lizenz fehlt oder passt nicht? Dann sind die Einstellungen der Erweiterung im Backend gesperrt: Ihre Menüpunkte führen zu den Einstellungen, ihre Module und Inhaltselemente lassen sich nicht bearbeiten, und auf jeder Backend-Seite steht ein roter Hinweis. Dein Shop läuft im Frontend ganz normal weiter. Sobald ein gültiger Schlüssel gespeichert ist, ist alles wieder frei.
  • Lizenzserver nicht erreichbar? Dann wird nichts gesperrt. Das letzte Ergebnis gilt weiter, und die Prüfung wird einige Stunden später wiederholt.

Anleitungen nach Erweiterung

Einrichtung, Einstellungen und Anpassung findest du für jede Erweiterung auf einer eigenen Seite.

Für Entwickler: Lizenz-API

Die Prüfung übernimmt das Paket contaolabs/license-client. Es fragt einen schlanken JSON-Endpunkt und speichert das Ergebnis in var/contaolabs/licenses.json zwischen (ohne den Schlüssel selbst), damit deine Website auch bei Netzwerkproblemen weiterläuft.

POST https://contaolabs.de/api/license
action=verify&license_key=CL-XXX-…&product=isotope-onepage-checkout&domain=example.com

{"valid": true, "code": "valid", "license": {"type": "standard", "domains": ["example.com"], "updates_active": true}}

Mögliche Codes: valid, not_found, wrong_product, unpaid, revoked, domain_limit. Die Adresse lässt sich für Tests mit der Umgebungsvariable CONTAOLABS_LICENSE_API ändern.

Support

Fragen zur Installation oder ein Fehler gefunden? Schreib uns an support@contaolabs.de – mit Lizenzschlüssel, Contao-Version und kurzer Beschreibung geht es am schnellsten.