Die Anwendung aktualisiert der Administrator auf der Registerkarte Einstellungen → Updates. Updates werden vom Server des Herstellers heruntergeladen. Neue Versionen werden mit einem Klick installiert (Auto-Installer, meist ohne FTP). Über FTP werden Dateien bei der Erstinstallation des Programms hochgeladen; bei einem Update ist technischer Support dann hilfreich, wenn der Server der Anwendung nicht erlaubt, ihre Dateien zu überschreiben. Sollte das heruntergeladene Paket keinen Auto-Installer enthalten, zeigt die Anwendung eine Anleitung zum Hochladen per FTP an.

Das Herunterladen von Updates erfordert eine aktive Lizenz (dieselbe, die das Speichern in der Anwendung freischaltet). Die Versionsliste stellt der Server des Herstellers nur für einen Schlüssel bereit, der dieser Installationsdomain zugeordnet ist. Ist die im Schlüssel hinterlegte Update-Berechtigung abgelaufen, hat die Schaltfläche der neuen Version den Status Gesperrt, und der Grund wird unter der Versionsnummer sowie beim Überfahren der Schaltfläche mit dem Mauszeiger angezeigt.

Bei einer Lizenz mit Updates bis zu einem Datum zählt das Veröffentlichungsdatum der Version (sichtbar bei jeder Version in der Liste): Die Lizenz umfasst Versionen, die bis zum Ende der Berechtigung veröffentlicht wurden, neuere nicht. Das Programm funktioniert weiterhin - Sie können lediglich neuere Versionen nicht herunterladen, solange Sie die Berechtigung nicht verlängern (neuer Schlüssel vom Anbieter, siehe Kapitel zur Lizenz). Die letzte Aktualisierung aus dem Berechtigungszeitraum sollten Sie am besten noch vor dessen Ende installieren: Der Server des Herstellers stellt in der Regel nur die neueste Version bereit, sodass er nach diesem Datum die ältere eventuell nicht mehr anzeigt.

Automatische Prüfung und Benachrichtigung

Die Anwendung prüft selbstständig auf verfügbare Updates - Sie müssen nicht mehr jedes Mal die Einstellungen öffnen:

  • nach dem Anmelden (beim Aufruf der Anwendung),
  • von Zeit zu Zeit, während die Anwendung geöffnet bleibt,
  • nach der Rückkehr zum Browser-Tab (wenn seit der letzten Prüfung etwas Zeit vergangen ist).

Sobald eine neue Version erscheint, sieht der Administrator eine kurze Benachrichtigung („Update verfügbar - Version X.Y.Z ist bereit zur Installation“) mit der Schaltfläche Anzeigen, die sofort Einstellungen → Updates öffnet. Die Benachrichtigung wird einmal pro Version angezeigt (sie drängt sich nicht bei jedem Aufruf auf) - bei der nächsten Version erhalten Sie eine neue.

Lässt sich die neue Version nicht installieren (z. B. weil die Update-Berechtigung abgelaufen ist), sagt die Benachrichtigung das unmissverständlich: „Version X.Y.Z ist verfügbar, kann aber nicht installiert werden: …” zusammen mit dem Grund. Sind Updates wegen des Lizenzschlüssels nicht verfügbar (fehlender Schlüssel, nicht erkannter, widerrufener, einer anderen Domain zugeordneter oder dem Server unbekannter Schlüssel), erhält der Administrator eine einzige Warnung Updates nicht verfügbar mit Erklärung - eine weitere erst, wenn das Problem verschwindet und erneut auftritt.

Anzeige für neue Version

Unabhängig von der Benachrichtigung sieht der Administrator, wenn eine neuere Version verfügbar ist, einen roten Punkt auf dem Zahnrad-Symbol (⚙) im oberen Menü sowie nach dem Öffnen der Einstellungen den gleichen Punkt neben dem Reiter Updates. Der Punkt verschwindet automatisch, sobald die neueste Version installiert ist. Den Hinweis (und die Benachrichtigung) sehen ausschließlich Administratoren.

Verfügbare Versionen prüfen

  1. Klicken Sie auf das Zahnrad-Symbol (⚙) → Tab Updates.

Entwicklerversion. Läuft die Anwendung im Entwicklermodus (Code direkt aus dem Repository), ist die Update-Prüfung deaktiviert: es gibt weder einen roten Punkt noch Benachrichtigungen, und der Tab weist ausdrücklich darauf hin, dass Sie mit der Entwicklerversion arbeiten.

  1. Klicken Sie Nach Updates suchen. Sie sehen:
    • Installierte Version - die auf dem Server laufende Version,
    • Code-Version - die Version der Anwendungsdateien,
    • Verfügbare Versionen - eine Liste neuerer Releases mit Änderungsprotokoll (Changelog) zu jedem davon.

Versionen werden der Reihe nach installiert - aktiv ist nur die Schaltfläche für die nächste Version. Weitere werden nach dem Hochladen der vorherigen freigeschaltet.

Task Manager: Registerkarte Updates mit einer Liste von Versionen und einer Schaltfläche zur Installation.
Registerkarte Updates: Version auf dem Server, neuere Versionen und Änderungsliste.

Paket herunterladen

  1. Klicken Sie bei der nächstgelegenen verfügbaren Version auf Herunterladen.
  2. Es erscheint ein Hinweis zur Datensicherung - erstellen Sie vor dem Update ein Backup der Datenbank sowie des Anhangordners (uploads/). Bestätigen Sie, um fortzufahren.
  3. Der Server lädt das Paket herunter und prüft dessen Prüfsumme (SHA-256). Weiter je nach Art des Pakets:
    • Paket mit Auto-Installer - es erscheint die Schaltfläche Installieren (Beschreibung unten). Sie müssen nichts per FTP hochladen.
    • Paket zum manuellen Hochladen - der Browser speichert die Datei .zip auf Ihrer Festplatte (bei Bedarf können Sie sie über die Schaltfläche Paket speichern (.zip) erneut herunterladen) und zeigt eine FTP-Anleitung.

Installation mit einem Klick (Auto-Installer)

Für Versionen mit Unterstützung für die automatische Installation brauchst du kein FTP:

  1. Klicken Sie nach dem Herunterladen auf Installieren.
  2. Ein Fortschrittsbalken („Installation läuft…“) zeigt die einzelnen Schritte: Datenbankmigrationen → Dateien kopieren → Abschluss.
  3. Nach Abschluss ändert sich die Schaltfläche zu Anwendung aktualisieren - klicken Sie darauf, um die neue Version zu laden (Sie können auch die Seite mit Strg/Cmd + Shift + R neu laden).

Der Installer rührt Ihre Daten nicht an - er lässt includes/config.php, uploads/, storage/ und logs/ unberührt und führt eventuelle Datenbankmigrationen selbst durch. Ein Backup lohnt sich trotzdem (Hinweis beim Herunterladen).

Hinweis: Der Fortschrittsbalken zeigt den Fortschritt erst dann vollständig „live“ an, wenn die installierte Version diesen Mechanismus bereits enthält. Bei einer Installation von einer älteren Version kann der Fortschritt sprunghaft angezeigt werden.

Installation per FTP (Pakete ohne Auto-Installer)

Unterstützt das Paket keine Auto-Installation, zeigt die Anwendung eine Anleitung für das manuelle Hochladen:

  1. Erstellen Sie eine Sicherungskopie der Datenbank und des Ordners uploads/ (falls noch nicht geschehen).
  2. Entpacken Sie die heruntergeladene Datei .zip.
  3. Verbinden Sie sich per FTP mit dem Hosting und laden Sie den Inhalt des Pakets hoch in das Anwendungsverzeichnis, wobei Sie die vorhandenen Dateien überschreiben.
  4. NICHT überschreiben (behalten Sie Ihre eigenen):
    • includes/config.php - Konfiguration und geheime Daten,
    • uploads/ - Anhänge und Avatare,
    • storage/ - Arbeitsdaten,
    • logs/ - Logs.
  5. Aktualisieren Sie die Anwendung im Browser (Strg/Cmd + Shift + R) und klicken Sie erneut auf Nach Updates suchen, um die neue Versionsnummer zu bestätigen.

Bringt eine Version Änderungen an der Datenbank mit sich, weist die Anleitung der jeweiligen Version (Changelog / Versionshinweis) auf zusätzliche Schritte hin. Im Zweifelsfall stellen Sie zuerst die Sicherungskopie wieder her und wenden Sie sich an den Anbieter.

Häufig gestellte Fragen

  • „Verbindung zum Update-Server nicht möglich" - prüfen Sie die Internetverbindung sowie ob die Lizenz gültig ist. Die Versionsliste wird nur Installationen mit gültigem Schlüssel bereitgestellt. Die technische Beschreibung des Verbindungsfehlers (z. B. „Could not resolve host…”) fügt das Programm in Klammern hinter dem Wort „Details” an - nützlich für den technischen Support des Hostings.
  • „Sie haben die neueste Version" - es gibt keine neuere Version als die installierte. Diese Meldung erscheint ausschließlich dann, wenn der Server den Schlüssel anerkannt hat - bei einem Schlüsselproblem sehen Sie eine der untenstehenden Meldungen.
  • „Diese Installation hat keinen Lizenzschlüssel…” - geben Sie den Schlüssel unter Einstellungen → Erweitert → Lizenz ein; ohne ihn fragt die Anwendung den Server überhaupt nicht nach Versionen.
  • „Der Update-Server erkennt den Lizenzschlüssel nicht…” - die Signatur des Schlüssels stimmt nicht mit dem Server des Herstellers überein (Schlüssel beschädigt oder aus einer anderen Quelle). Geben Sie den vom Anbieter erhaltenen Schlüssel ein oder wenden Sie sich an ihn.
  • „Der Lizenzschlüssel dieser Installation ist nicht in der Datenbank des Update-Servers vorhanden…” - der Schlüssel ist korrekt, aber der Server des Herstellers kennt ihn nicht. Der Anbieter muss ihn registrieren oder einen neuen ausstellen.
  • „Der Lizenzschlüssel… wurde widerrufen…” - der Anbieter hat diesen Schlüssel widerrufen (meist nach Ausstellung eines neuen). Geben Sie den neuen Schlüssel ein.
  • „Der Lizenzschlüssel ist einer anderen Domain zugeordnet…” - der Schlüssel wurde für eine andere Adresse ausgestellt als die, unter der das Programm läuft. Bitten Sie den Anbieter um einen Schlüssel für diese Domain.
  • „Version X.Y.Z ist verfügbar, kann aber nicht installiert werden: Ihr Update-Anspruch ist am DD.MM.JJJJ abgelaufen…” - diese Version wurde nach Ablauf Ihres Update-Anspruchs veröffentlicht. Das Programm läuft weiter; um sie zu installieren, verlängern Sie den Anspruch (neuer Schlüssel vom Anbieter). Eine ältere Version aus dem Zeitraum Ihres Anspruchs wird in der Liste dann meist nicht mehr angezeigt - der Server des Herstellers stellt in der Regel nur die neueste Version bereit.
  • „Auf dem Server fehlt die PHP-Erweiterung „zip“…“ - ohne diese Erweiterung kann die Anwendung das Paket nicht entpacken. Aktivieren Sie sie im Hosting-Panel (PHP-Einstellungen → Erweiterungen) und versuchen Sie es erneut. Die Anwendung prüft dies vor dem Herunterladen des Pakets.
  • Die Version hat sich nach dem Hochladen nicht geändert - stellen Sie sicher, dass die Dateien im richtigen Verzeichnis gelandet sind, und laden Sie die Seite unter Umgehung des Caches neu (Strg/Cmd + Shift + R).
  • Meldung zu Schreibrechten (z. B. „Die Datei … konnte nicht überschrieben werden (Schreibrechte?)“) - der Server erlaubt der Anwendung nicht, ihre Dateien zu speichern. Korrigiere die Berechtigungen des Anwendungsverzeichnisses im Hosting-Panel oder per FTP und wiederhole das Update. Bereits ausgeführte Migrationen werden nicht wiederholt.
  • „Der Anwendungsserver hat eine unerwartete Antwort zurückgegeben (HTTP …)” - das Programm auf Ihrem Server wurde mit einem Fehler beendet, bevor es antworten konnte (bei der Prüfung oder beim Herunterladen von Updates). Die Ursache wird im PHP-Fehlerprotokoll Ihres Hostings erfasst - leiten Sie es an den Support weiter.
  • Schaltfläche „Gesperrt” - der Grund steht unter der Versionsnummer (und beim Überfahren der Schaltfläche mit der Maus): Entweder muss zuerst eine frühere Version installiert werden, die Lizenz deckt dieses Update nicht mehr ab (z. B. ist der Update-Anspruch abgelaufen) oder die Version besitzt keine gültige Herausgebersignatur.