gratlinie / contao-gratframe-installer

v0.1.3 2026-11-02 09:14 UTC

Requires

• php: ^8.3
• ext-sodium: *
• ext-zip: *
• contao/core-bundle: ^5.7
• symfony/http-client: ^7.0

Requires (Dev)

• contao/manager-plugin: ^2.0

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

MIT

• Gratlinie

• installer
• theme
• contao
• gratframe

Published on Packagist.org on 2026-11-02 09:14 UTC

README

GratFrame-Installer

Installer für GratFrame, das Theme-Framework für Contao 5.7. Der Installer ist öffentlich (Contao Manager, Packagist); GratFrame selbst kommt aus dem Paket-Repository von www.gratframe.de und braucht eine Lizenz.

Ablauf

1. Installer im Contao Manager installieren: gratlinie/contao-gratframe-installer.
2. Im Backend System → GratFrame-Installer E-Mail-Adresse und Lizenzschlüssel aus der Lizenzmail eingeben. Der Installer prüft beides bei www.gratframe.de (signierte Antwort) und richtet ein:
   • das Paket-Repository https://www.gratframe.de/composer in der composer.json – mit dem Zugang in der URL, damit auch die Composer Resolver Cloud des Contao Managers das Repository lesen kann,
   • gratlinie/contao-gratframe als Anforderung,
   • den Zugang zusätzlich in der auth.json (nur für den Webserver lesbar, für Composer auf der Kommandozeile),
   • den Schlüssel in var/gratframe_license – GratFrame übernimmt ihn, solange im Theme keiner eingetragen ist.
3. Im Contao Manager Pakete aktualisieren, danach die Datenbank aktualisieren. Ist der Contao Manager schon geöffnet, die Seite vorher neu laden.
4. Optional: die Demo-Website „Studio Nord“ einspielen. Sie ersetzt Seitenstruktur, Artikel, Inhalte, Themes, Layouts, Module und Bildgrößen; Benutzer, Mitglieder und Nachrichten bleiben. Die Bilder landen unter files/.

Mit Lizenz entfernen (Schritt 1) nimmt der Installer alles wieder heraus: Repository und Paket aus der composer.json, den Zugang aus der auth.json und var/gratframe_license. Ist GratFrame installiert, entfernt der Contao Manager es bei der nächsten Paketaktualisierung. Die Schaltfläche erscheint auch, wenn nur noch Reste einer Einrichtung da sind, etwa nachdem GratFrame im Contao Manager deinstalliert wurde.

Updates

Schritt 2 zeigt an, wenn eine neue GratFrame-Version erschienen ist, die die Lizenz umfasst (mit Link zum Changelog); aktualisiert wird im Contao Manager. Ist eine neue Hauptversion erschienen, die die Lizenz nicht mehr umfasst, weist der Installer darauf hin. Die Versionen fragt er höchstens einmal pro Stunde bei www.gratframe.de ab.

Lizenz und Domain

Eine Lizenz gilt für eine Domain (beispiel.de, www.beispiel.de) und ihre Entwicklungs-Subdomains dev., staging. und test. sowie eine optionale Entwicklungsdomain, die beim Kauf angegeben wird (z. B. die Vorschau einer Agentur), nicht für andere Subdomains. Die Domain wird bei der Bestellung angegeben; der Installer fragt sie nicht ab, sondern prüft die Domain des Startpunkts (sonst den Host der Anfrage). Mehrere Domains in einer Installation brauchen je eine eigene Lizenz. Lokale Umgebungen (localhost, .local, .test, .ddev.site, IP-Adressen) lassen sich mit jeder gültigen Lizenz einrichten; die Domain wird dann auf der Live-Website geprüft.

Ohne Contao Manager

composer require gratlinie/contao-gratframe-installer

Nach Schritt 2 genügt composer update gratlinie/contao-gratframe und vendor/bin/contao-console contao:migrate.

Entwicklung

GRATFRAME_SERVER (Umgebungsvariable) zeigt auf einen anderen Lizenzserver, z. B. eine lokale GratLicense-Installation.

Lizenz

Der Installer steht unter der MIT-Lizenz. GratFrame selbst ist kommerziell.