Sofort verfügbar
Digitale Plugins direkt nach dem Kauf einsatzbereit.
Beschreibung
Lorzen Package Manager für Bagisto
Erweiterungen installieren und aktualisieren – direkt über das Bagisto-Backend.
Der Lorzen Package Manager erweitert Bagisto um eine zentrale Paketverwaltung für Plugins, Erweiterungen und Themes. Statt Pakete manuell auf den Server zu kopieren, Dateien an verschiedenen Stellen abzulegen und anschließend einzelne Artisan-Befehle auszuführen, können kompatible Pakete als ZIP-Datei direkt über die Administration installiert oder aktualisiert werden.
Dabei ist der Package Manager nicht auf Lorzen-Erweiterungen beschränkt. Ab Version 1.4.2 unterstützt er Pakete mit eigenen Vendor- und PHP-Namespaces und eignet sich damit auch als Grundlage für Erweiterungen von Drittanbietern.
Einfach installieren. Sicher aktualisieren.
Ein kompatibles Paket wird als ZIP hochgeladen. Der Package Manager prüft das Manifest und die enthaltenen Dateien, bevor die Installation durchgeführt wird.
Je nach Paket können anschließend automatisch weitere Schritte ausgeführt werden – beispielsweise Datenbankmigrationen, das Bereitstellen öffentlicher Assets oder definierte Nachinstallationsbefehle.
Bei einem Update wird die bestehende Paketversion zuvor gesichert. So reduziert sich das Risiko, dass ein fehlerhaftes Update die bisherige Installation überschreibt, ohne dass die vorherigen Dateien wiederhergestellt werden können.
Die wichtigsten Funktionen
- ZIP-Installation direkt im Bagisto-Admin
- Installation und Updates von Plugins und Themes
- Unterstützung eigener Vendor- und PHP-Namespaces
- Manifestbasierte Paketprüfung
- SHA-256-Prüfung der Paketdateien
- Versionsverwaltung für installierte Pakete
- Automatische Sicherung vor Updates
- Rollback der Paketdateien
- Unterstützung von Laravel-/Bagisto-Migrationen
- Automatische Bereitstellung öffentlicher CSS-, JavaScript- und Bilddateien
- Sichere Nachinstallationsroutinen über
do.md - Automatische Cache- und Wartungsbefehle nach Installationen
- Schutz vor unsicheren Zielpfaden und Überschreiben geschützter Bagisto-Core-Pakete
Offen für eigene Erweiterungen
Der Package Manager ist nicht nur ein Installer für Lorzen-Produkte.
Entwickler können ihre eigenen Bagisto-Erweiterungen für das Paketformat vorbereiten und anschließend über dieselbe Oberfläche verteilen und installieren. Ein Paket beschreibt dazu unter anderem seinen Namespace, Service Provider, Zielpfad, seine Version, öffentliche Assets und benötigte Migrationen in einer lorzen-package.json.
Damit entsteht für Bagisto eine einheitliche Installations- und Update-Struktur für Erweiterungen unterschiedlicher Hersteller.
Für wen eignet sich der Package Manager?
Der Lorzen Package Manager richtet sich an Bagisto-Shopbetreiber, Agenturen und Entwickler, die Erweiterungen kontrolliert installieren und aktualisieren möchten, ohne für jedes Update denselben manuellen Deployment-Prozess durchführen zu müssen.
Besonders interessant ist er für Installationen mit mehreren individuellen Erweiterungen oder für Entwickler, die eigene Bagisto-Pakete regelmäßig ausliefern.
Weniger manuelle Serverarbeit. Einheitliche Pakete. Kontrollierbare Updates.
Anleitung – Lorzen Package Manager
1. Erstinstallation
Für die erstmalige Installation wird das Classic-Installationspaket des Package Managers verwendet.
Dieses unterscheidet sich von späteren Updates: Solange der Package Manager noch nicht installiert ist, kann er sich naturgemäß nicht selbst über seine Verwaltungsoberfläche installieren.
Nach der Erstinstallation steht die Paketverwaltung im Bagisto-Administrationsbereich zur Verfügung.
Wichtig: Für spätere Updates des Package Managers wird die Managed-Version verwendet.
2. Ein Paket installieren
Lade zunächst die ZIP-Datei der gewünschten, Package-Manager-kompatiblen Erweiterung herunter.
Öffne anschließend im Bagisto-Backend den Lorzen Package Manager, wähle die ZIP-Datei aus und starte die Installation.
Vor der eigentlichen Installation überprüft der Package Manager das Paket. Dazu gehören insbesondere das Manifest und – sofern im Paket definiert – die SHA-256-Prüfsummen der enthaltenen Dateien.
Bei erfolgreicher Prüfung wird das Paket an seinen vorgesehenen Zielort installiert.
3. Was während der Installation automatisch passiert
Welche Aktionen notwendig sind, bestimmt das jeweilige Paket.
Der Package Manager kann unter anderem:
- Paketdateien installieren,
- Service Provider verfügbar machen,
- Datenbankmigrationen ausführen,
- öffentliche Assets bereitstellen,
- definierte Nachinstallationsbefehle aus
do.mdausführen, - Laravel-/Bagisto-Caches anschließend bereinigen.
Dadurch kann eine Erweiterung wesentlich mehr enthalten als lediglich PHP-Dateien.
4. Ein bestehendes Paket aktualisieren
Ein Update erfolgt ebenfalls über eine Package-Manager-kompatible ZIP-Datei.
Der Package Manager erkennt das bereits installierte Paket anhand seiner eindeutigen Paketkennung. Vor dem Austausch der vorhandenen Paketdateien wird eine Sicherung erstellt.
Anschließend werden die neue Version installiert und die für das Paket vorgesehenen Installations- beziehungsweise Aktualisierungsschritte ausgeführt.
5. Rollback
Vor Updates angelegte Sicherungen ermöglichen die Wiederherstellung der vorherigen Paketdateien.
Dabei ist wichtig: Ein Datei-Rollback ist nicht automatisch ein Datenbank-Rollback.
Hat eine neue Paketversion beispielsweise eine Datenbankmigration durchgeführt und Daten oder Tabellenstrukturen verändert, werden diese Änderungen durch die Wiederherstellung der alten Dateien nicht automatisch rückgängig gemacht.
Vor größeren produktiven Updates ist deshalb unabhängig vom Package Manager ein vollständiges Datenbank-Backup empfehlenswert.
6. Eigene Pakete installieren
Seit Version 1.4.2 sind kompatible Pakete nicht auf den Namespace Lorzen beschränkt.
Ein Entwickler kann beispielsweise ein Paket unter einem eigenen Namespace wie
Acme\BagistoTools\
bereitstellen und einen entsprechenden Zielpfad unter
packages/Acme/BagistoTools
verwenden.
Der Package Manager prüft dabei weiterhin die Struktur und verhindert unsichere Pfade beziehungsweise das Überschreiben geschützter Bagisto-Core-Bereiche.
7. Aufbau eines kompatiblen Pakets
Ein typisches Paket besitzt folgende Grundstruktur:
README.md
lorzen-package.json
package/
public/ optional
do.md optionalDie Datei lorzen-package.json beschreibt das Paket. Dazu gehören beispielsweise:
Paketkennung
Name
Version
PHP-Namespace
Service Provider
Installationsziel
Migrationen
Public Assets
Systemanforderungen
DateiprüfsummenDer eigentliche Laravel-/Bagisto-Code befindet sich unter package/.
8. Public Assets
Benötigt eine Erweiterung beispielsweise CSS, JavaScript oder Bilder, können diese über den public-Bereich des Pakets ausgeliefert werden.
Das Manifest definiert, von wo nach wo diese Dateien kopiert werden sollen. Dadurch muss der Shopbetreiber die Assets nicht nach jeder Installation manuell verschieben.
9. do.md – automatische Nachinstallationsschritte
Kompatible Pakete können optional eine do.md enthalten.
Damit können notwendige Nachinstallationsschritte definiert werden, beispielsweise:
php artisan migrate
php artisan mein-paket:install
php artisan optimize:clearDie Datei ist keine frei ausführbare Shell-Datei. Der Package Manager akzeptiert nur vorgesehene Befehlsarten und blockiert gefährliche Shell-Konstruktionen und Befehle.
10. Empfohlener Ablauf im Produktivbetrieb
Vor größeren Updates sollte zusätzlich ein vollständiges Shop- und Datenbank-Backup vorhanden sein. Danach kann das Paket über den Package Manager aktualisiert und die Funktion der Erweiterung geprüft werden.
Bei selbst entwickelten Paketen empfiehlt es sich, neue Versionen zunächst in einer Staging- oder Testinstallation zu installieren.
Zusätzliche Informationen
Marke
lorzen.de
Bewertungen