Dropper & Drops aktualisieren
Dropper und Drops werden stetig verbessert und müssen daher ab und an aktualisiert werden. Ein Update ist im Normalfall denkbar einfach und mit wenigen Klicks erledigt. Der Umweg über einen FTP Client wie FileZilla entfällt dabei komplett!
Schreibrechte im Dropper Ordner korrekt setzen
Stelle vor einem Update bitte sicher, dass alle Dateien und Unterordner im Ordner
[Shop-Root]/plugins/kk_dropper
beschreibbar sind. Dropper zeigt dir in der Top Bar an, falls hier etwas nicht stimmen sollte.
Update über die Paketverwaltung
Dropper bringt eine Paketverwaltung mit, die du über einen Link in der Top Bar erreichst. Darin findest du Hinweise zu den aktuellsten Versionen von Dropper bzw. deinen Drops und kannst diese mit wenigen Klicks aktualisieren.
Nach dem Update werden dir einige Statusinformationen angezeigt und Dropper lädt neu. Beachte auch die angezeigten Hinweise zum jeweiligen Release, gerade bei umfangreichen Updates lohnt sich ein Blick in unsere Release Notes!
Automatische Backups
Die Paketverwaltung erstellt vor jedem Update ein komplettes Backup deines Drop- oder Dropper-Ordners. Im unwahrscheinlichen Fall eines Fehlers während des Updatevorgangs können damit alle Daten problemlos wiederhergestellt werden.
Drops & Drop Instanzen
Updates deiner Drops kannst du außer in der Paketverwaltung auch über das Dropper Dashboard durchführen.
Mit einem Drop Update werden (wenn nötig) auch bestehende Instanzen des Drops mit aktualisiert. Informationen dazu erhältst du im Anschluss an das Update in der Top Bar.
Beachte auch, dass dir vor dem Update ein Auszug aus dem Changelog, also den letzten Änderungen des Drops, angezeigt wird. Ein Button führt dich zum kompletten Changelog auf der Store-Seite des Drops.
Abhängigkeiten von Updates
Manchmal verfügen Updates über Abhängigkeiten, zum Beispiel wenn ein Update eines Drops eine bestimmte Version von Dropper voraussetzt. Die Paketverwaltung zeigt dir Updates nur dann an, wenn du die entsprechenden Voraussetzungen erfüllst.
Sonderfall: JTL-Shop 5 Update
Mit dem Sprung auf die Version 5 ändern sich im JTL-Shop viele grundlegende Strukturen und APIs. Daher ist ein einfaches "One-Click-Update" über die Paketverwaltung nicht möglich. Bitte lies daher unsere umfangreichen Installations- und Updatehinweise für JTL-Shop 5.
Sonderfall: manuelles Update
Falls du eine ältere Version von Dropper oder Custom Drops aktualisieren möchtest, gehe bitte wie folgt vor:
Lade die aktuelle Dropper Version bzw. die aktuelle Version deines Drops herunter
Entpacke die ZIP Datei lokal und lade die entpackten Ordner (Dropper:
kk_dropper- Drops: z.B.KK_Plainfür das Plain Drop) mit dem FTP Tool deiner Wahl in das Plugin Verzeichnis deines Shops (Dropper:[Shop-Root]/plugins- Drops:[Shop-Root]/plugins/kk_dropper/drops) hoch. Achte dabei darauf, dass das im binären Übertragungsmodus passiert.Überschreibe dabei die alten Dateien auf deinem Server.
Lade das Dropper Backend in deinem Browser neu und beachte die Hinweise, die ggf. nach dem Neuladen im Dropper Dashboard angezeigt werden
Ein Update über die Pluginverwaltung des JTL-Shops ist nicht notwendig.
Backup vor dem Update nicht vergessen
Dropper trennt Anwendungslogik und Daten sauber voneinander. Normalerweise dürfte bei einem Update nichts schiefgehen, bei einem Update über die Paketverwaltung werden außerdem automatisch Backups erstellt.
Um trotzdem
auf Nummer sicher
zu gehen, empfehlen wir dir gerade bei einem manuellen Update immer ein Backup des Ordners
[Shop-Root]/plugins/kk_dropper
zu erstellen!
Alternative (Beta-) Repositories
Dropper nutzt primär die Paketverwaltung, um Updates oder neue Drops zu installieren. Repositories verweisen dabei im Hintergrund auf die Installationsdateien, die dabei genutzt werden sollen.
Neben dem regulären Repository kann die Paketverwaltung auch alternative Repositories nutzen, um bspw. an Betatests teilzunehmen.
Nur für Auskenner
Die nachfolgenden Informationen richten sich an versierte Anwender. Nutze alternative oder Beta-Repositories nur, wenn wir dich dazu aufgefordert haben und du weißt, was du tust.
Repository-Dateien
Die Repository-Dateien liegen unter
[Shop-Root]/plugins/kk_dropper/repos/*.json. Welche Datei aktiv ist, wird über den Wert
active
gesteuert:
{
"url": "https://kreativkonzentrat.de/repos/beta/dropper.json",
"active": true,
"publicKey": "..."
}
Eine Repository-Datei ist aktiv, wenn
"active": true
gesetzt ist. Nicht genutzte Repository-Dateien müssen dabei auf
"active": false
stehen.
Beta-Repository aktivieren
Gehe so vor, um bspw. das Dropper-Beta-Repository zu nutzen:
- Setze in
[Shop-Root]/plugins//kk_dropper/repos/01-kk-store-beta.jsonden Wert"active": true. - Setze in allen anderen
*.json-Dateien im Ordner[Shop-Root]/plugins//kk_dropper/repos/den Wert"active": false. - Lade das Dropper-Backend neu und prüfe, ob dir Updates angeboten werden.
- Beachte unsere Hinweise zu Backups und führe das Update durch.
Fortan verwendet Dropper die
Paketinformationen aus dem Beta-Repository. Im Problemfall kannst du die
active
-Werte wieder zurücksetzen und dein
Backup wiederherstellen.