PrestaShop Modul installieren aus einer ZIP-Datei: Schritt für Schritt und was tun, wenn es scheitert
Ein Modul in PrestaShop aus einer ZIP-Datei zu installieren, braucht unter Module → Modul-Manager drei Klicks: den Button zum Hochladen, die Wahl der Datei und die Konfiguration. Bei einem Fehler liegt die Ursache meist im Aufbau des Pakets, einem Upload-Limit des Servers oder einer Modulversion, die nicht zu Ihrem Shop passt. Sichern Sie den Shop und prüfen Sie vor der Installation, woher das Paket stammt.
Autor: Das TellMyShop-Team. Ein Ratgeber für Betreiber von PrestaShop-Shops: die Ursache, die Lösung von Hand und dieselbe Arbeit im Gespräch mit dem Chat.
Zuletzt aktualisiert: · 6 Min. Lesezeit
Was Sie vor der Installation eines Moduls prüfen
Ein Modul ist Code, der auf Ihrem Server läuft und Zugriff auf die Datenbank des Shops hat. Fünf Minuten Prüfung vor der Installation sind günstiger als Reparaturen danach.
- Quelle. Laden Sie das Modul beim Autor herunter, bei Addons oder aus dem Release des Autors auf GitHub. Kostenlose Kopien kostenpflichtiger Module von zufälligen Websites sind ein häufiger Weg, auf dem schädlicher Code in einen Shop gelangt.
- Kompatibilität mit Ihrer Shop-Version. Die Modulbeschreibung nennt die PrestaShop- und PHP-Versionen, mit denen es läuft. Die Version Ihres Shops sehen Sie unter Erweiterte Einstellungen → Informationen.
- Ob Sie schon ein Modul haben, das dasselbe tut. Zwei Bewertungsmodule oder zwei Liefermodule sind eine häufige Ursache für Konflikte.
- Sicherung. Eine Sicherung von Dateien und Datenbank bei Ihrem Hoster oder mit einem Sicherungsmodul. Ohne sie wird jeder Fehler teuer.
- Zeitpunkt. Installieren Sie, wenn im Shop wenig los ist. Zahlungs- und Liefermodule probieren Sie zuerst auf einer Testkopie aus.
Wie Sie ein Modul aus einer ZIP-Datei installieren
Das Back-Office von PrestaShop 8 und 9 hat dafür ein Formular im Modul-Manager. Der PrestaShop-Leitfaden zu Modulen beschreibt den Modulbildschirm allgemein.
- Gehen Sie zu Module → Modul-Manager.
- Klicken Sie oben auf der Seite auf den Button zum Hochladen eines Moduls.
- Ziehen Sie die ZIP-Datei in das Feld oder wählen Sie sie auf Ihrem Computer aus. Entpacken Sie sie vorher nicht.
- Warten Sie auf die Meldung zur Installation. Bei größeren Modulen dauert das ein paar Dutzend Sekunden.
- Klicken Sie auf Konfigurieren und richten Sie das Modul nach der Anleitung des Autors ein.
- Öffnen Sie den Shop in einem privaten Fenster. Prüfen Sie Startseite, eine Produktseite und den Warenkorb.
- Sehen Sie unter Erweiterte Einstellungen → Logs nach, ob nach der Installation neue Fehler aufgetaucht sind.
Ein Update aus einer ZIP-Datei funktioniert genauso: Sie laden eine neuere Version desselben Moduls hoch. PrestaShop erkennt, dass das Modul schon da ist, ersetzt die Dateien und führt die Upgrade-Skripte aus.
Worauf Sie beim Update eines Moduls achten
Ein Update ist mehr als ein Austausch von Dateien. Eine neue Version kann Datenbanktabellen ändern, neue Stellen auf der Seite hinzufügen oder Standardeinstellungen ändern.
- Lesen Sie das Änderungsprotokoll des Autors. Achten Sie auf Sätze zur nötigen PHP-Version, zu neuen Einstellungen und zu Änderungen an Templates.
- Prüfen Sie, ob Ihr Theme eine Kopie des Modul-Templates hat. Wenn ja, sieht die neue Modulversion vielleicht anders aus als in der Beschreibung des Autors oder zeigt die neuen Elemente gar nicht.
- Aktualisieren Sie Zahlungs- und Liefermodule außerhalb der Einkaufszeiten. Geben Sie nach dem Update eine Testbestellung auf.
- Springen Sie nicht ohne Sicherung über mehrere Versionen auf einmal. Upgrade-Skripte sind oft mit Blick auf die vorherige Version geschrieben.
Die häufigsten Fehler bei der Installation eines Moduls
| Meldung oder Symptom | Ursache | Was tun |
|---|---|---|
| das Modul ist ungültig, oder die Datei sieht nicht wie ein gültiges Modul-ZIP aus | das ZIP hat keinen Modulordner mit einer gleichnamigen Datei | auf dem Computer entpacken; darin sollte ein Ordner sein, z. B. mymodule/mymodule.php |
| derselbe Fehler bei einem Paket von Addons | das heruntergeladene ZIP enthält Modul, Dokumentation und Lizenz in einem Archiv | entpacken und nur das innere ZIP des Moduls hochladen |
| das Hochladen endet mit einem Fehler ohne Beschreibung | die Datei ist größer als das Upload-Limit des Servers | das Limit beim Hoster erhöhen oder das Modul per FTP hochladen |
| das Modul ist nicht mit Ihrer Shop-Version kompatibel | der Autor hat im Modul einen Bereich von PrestaShop-Versionen festgelegt | die Modulversion für Ihr PrestaShop herunterladen |
| eine leere Seite oder ein Fehler 500 nach der Installation | das Modul braucht eine andere PHP-Version oder kollidiert mit einem anderen Modul | das Modul deaktivieren, das Fehlerprotokoll lesen |
| keine Schreibberechtigung | der Server erlaubt kein Schreiben in den Ordner modules | den Hoster bitten, die richtigen Ordnerrechte zu setzen |
Die PrestaShop-Dokumentation zur Modulstruktur beschreibt, wie ein korrektes Paket aufgebaut ist: Der Modulordner hat denselben Namen wie das Modul, und das Modul muss im ZIP in einem Unterordner liegen. Das Problem zu großer Pakete haben die PrestaShop-Entwickler in der Spezifikation der Meldungen im Modul-Manager beschrieben, zusammen mit den dafür zuständigen PHP-Einstellungen.
Wenn der Shop nach der Installation nicht angezeigt wird, beginnen Sie mit dem Beitrag über den PrestaShop Fehler 500. Wenn das Modul funktioniert, aber etwas kaputt macht, deaktivieren Sie es, statt es zu deinstallieren, wie wir im Beitrag über das Deaktivieren eines Moduls beschreiben.
Wie Sie ein Modul über den Chat installieren oder aktualisieren
Sie geben Ihrem Chat (Claude oder ChatGPT) einen direkten https-Link zur ZIP-Datei, etwa zu einem Release auf GitHub oder zu einer Datei vom Autor. Der Chat lädt das Paket zuerst für eine Vorschau herunter und prüft es, bevor etwas im Shop ankommt: Modulname und Version, Quelle, die Prüfsumme SHA-256 und den Aufbau des Pakets. Eine Datei von Ihrem Computer können Sie auf diesem Weg nicht hochladen; es braucht einen Link.
Sie: Aktualisiere das Zahlungsmodul auf 2.4.1 über diesen Link zum GitHub-Release. Prüf den Shop vorher und nachher.
Ihr Chat: Vorschau des Pakets: Zahlungsmodul, installierte Version 2.3.0, Version im Paket 2.4.1. Quelle: das Release des Autors auf GitHub. Aufbau korrekt, ein Modulordner. Die Prüfsumme SHA-256 steht in der Vorschau, Sie können sie also mit der vom Autor veröffentlichten vergleichen.
Vor dem Update sichere ich die Dateien des Moduls. Änderungen an der Datenbank durch das Upgrade-Skript kann ich nicht über den Verlauf rückgängig machen; dafür ist die heutige Datenbanksicherung da. Im Moment hat das Protokoll keine Fehler von diesem Modul. Aktualisieren?
Sie: Ja.
Ihr Chat: Auf 2.4.1 aktualisiert. Der Warenkorb und die Bestellseite antworten korrekt, und im Protokoll gibt es keine neuen Fehler.
Status der Karte: wartet auf Ihr „Ja“alte Version: Version 2.3.0
neue Version: Version 2.4.1
Die Versionsnummern im Beispiel dienen nur zur Veranschaulichung. Eine Beispielanfrage finden Sie im Anwendungsfall ein Modul aus einem ZIP-Paket installieren oder aktualisieren, und wenn nach der Änderung etwas nicht mehr funktioniert, im Anwendungsfall ein Modul deaktivieren, das den Warenkorb kaputt macht.
TellMyShop Pro installiert und aktualisiert Module, sobald der Schalter Module im Modul-Panel an ist. Der Schalter gilt 24 Stunden und braucht eine Datenbanksicherung vom selben Tag. Der Chat installiert nichts ohne Vorschau und Ihre Zustimmung und rät von einem Modul aus unsicherer Quelle ab. Das Deinstallieren eines Moduls lässt sich nicht rückgängig machen, deshalb schlägt der Chat zuerst das Deaktivieren vor. In der kostenlosen Version TellMyShop Free sehen Sie die Liste der Module mit ihren Versionen und den Stellen, an denen sie angezeigt werden. Einen Vergleich der Versionen finden Sie auf der Seite Preise, und das Aufräumen alter Module behandeln wir im Beitrag über ungenutzte Module.
Fragen und Antworten
Wo installiere ich in PrestaShop ein Modul aus einer ZIP-Datei?
Im Menü Module, im Modul-Manager. Oben auf der Seite gibt es einen Button zum Hochladen eines Moduls, in den Sie die ZIP-Datei ziehen oder sie auf Ihrem Computer auswählen. Nach dem Hochladen installiert PrestaShop das Modul und bietet an, es zu konfigurieren.
Was bedeutet die Meldung, dass das Modul ungültig ist?
Meist hat PrestaShop im Paket keinen Modulordner mit einer gleichnamigen Datei gefunden. Vielleicht haben Sie ein Paket mit Dokumentation statt des Moduls heruntergeladen, ein Archiv mit mehreren Modulen oder eine ZIP-Datei, die in einer anderen ZIP-Datei steckt. Entpacken Sie das Paket auf Ihrem Computer und prüfen Sie, was darin ist.
Entfernt ein Modul-Update aus einer ZIP-Datei seine Einstellungen?
Meist nicht. Wenn Sie eine neuere Version desselben Moduls hochladen, ersetzt PrestaShop die Dateien und führt die Upgrade-Skripte des Moduls aus. Die Einstellungen bleiben, aber die Skripte können die Datenbank ändern. Sichern Sie den Shop deshalb vor dem Update und testen Sie es am besten auf einer Testkopie.
Lässt sich die Installation eines Moduls rückgängig machen?
Ein neues Modul können Sie deaktivieren oder deinstallieren. Deinstallieren löscht meist seine Daten und Einstellungen, das lässt sich also nicht rückgängig machen. Bei einem Update lassen sich die Dateien aus einer Sicherung wiederherstellen, aber Änderungen an der Datenbank durch das Upgrade-Skript machen Sie ohne Datenbanksicherung nicht rückgängig.
Kann TellMyShop Free ein Modul installieren?
Nein. Die kostenlose Version TellMyShop Free liest nur Shop-Berichte, auch die Liste der Module mit ihren Versionen. TellMyShop Pro installiert und aktualisiert Module aus einem ZIP-Paket, sobald der Schalter Module für 24 Stunden an ist.
PrestaShop ist eine eingetragene Marke der PrestaShop SA. Claude ist eine Marke der Anthropic PBC. ChatGPT und OpenAI sind Marken von OpenAI. TellMyShop ist mit diesen Unternehmen nicht verbunden.