Contao 4: Installation von Erweiterungen - ComposerToolbox
In diesem Artikel wird die Installation von Kundenerweiterungen mit der ComposerToolbox gezeigt. Dies ist eigentlich etwas irreführend, denn die ComposerToolbox installiert nichts, sie kümmert sich nur um die Eintragungen in der composer.json
. Die eigentliche Installation übernimmt ganz normal der Manager, bzw. Composer.
Die eingetliche Installation und deren Vorbereitung läuft, wie bereits in den folgenden Artikeln beschrieben:
- Contao 4: Installation von Erweiterungen - Repository 2
- Contao 4: Installation von Erweiterungen - Repository
- Contao 4: Installation von Erweiterungen - Grundlagen
Damit private Pakete installiert werden können, müssen einige Einträge in der Datei composer.json
erstellt werden. Dies kann man zwar auch manuell machen, vielen Anwendern ist es aber zu umständlich, oder es fehlt an den entsprechenden Kenntnissen. Um meinen Kunden das Leben zu erleichtern, habe ich deshalb die ComposerToolbox entwickelt. Die Nutzung für Anwender soll in diesem Artikel besprochen werden. Eine Anleitung für Entwickler werde ich in einen separaten Artikel schreiben.
Installation der ComposerToolbox
Die ComposerToolbox wird einfach über den Manager installiert. Nach der Anmeldung klickt man auf Pakete suchen und gibt in das Suchfeld composertoolbox
ein:
Nun klick man erst rechts auf Paket hinzufügen (s.o.) und dann auf Änderung prüfen (s.u.).
Dann muss man noch einmal auf Änderungen anwenden klicken:
Ist die Installation fertig, muss wie immer die Datenbank aktualisiert werden:
Das war's auch schon mit der Installation. Die ComposerToolbox sollte nun im Backend zur Verfügung stehen.
Benutzung
Im Backend findet man die ComposerToolbox unten links in der Seitenleist:
Klickt man auf Daten importieren (s.u.) gelangt man zum Formular für das Einfügen der Daten.
Hier kann eine composer.json
hoch geladen werden, die im Abschnitt extra
die Eintragungen enthält, die eingefügt werden sollen. Diese muss vom Entwickler erstellt werden. Zusätzlich wird eine Signatur des Inhalts benötigt. Auch diese muss vom Entwickler zur Verfügung gestellt werden, weshalb uns die Erstellung hier nicht weiter interessieren muss.
Wenn beides eingetrage ist und zusammenpasst, werden die Daten in die comopser.json
übernommen und auf der Seite noch einmal ausgegeben.
Installation der privaten Pakete
Nun können wir im Manager einfach auf Pakete aktualisieren klicken, hierbei werden die privaten Pakete automatisch installiert. Ein Update kann so ebenfalls gemacht werden.
Die Eintragung über die ComposerToolbox muss nur einmal gemacht werden, alles weitere übernimmt der Manager.
Löschen
Werden die Einträge im Backend gelöscht, werden sie auch aus der composer.json
entfernt. Werden dann über den Manager die Pakete aktualisiert, werden die Pakete gelöscht. Natürlich können sie auch direkt über den Manager entfernt werden.
Kommentare
Einen Kommentar schreiben