Die Installation eines PrestaShop-Moduls klingt in der Theorie einfach. In der Praxis – zwischen Modulen aus dem Addon-Store, Modulen von Drittanbieter-Marktplätzen, intern entwickelten Modulen und den spezifischen Anforderungen von Multishop-Setups – stößt man schnell auf Sonderfälle. Dieser Leitfaden behandelt die drei gültigen Installationsmethoden in 2026, die häufigsten Fehler und Best Practices, um einen Produktiv-Shop nicht zu gefährden.
Vor dem Start: Shop sichern
Dieser Schritt ist nicht verhandelbar. Bevor Sie ein Modul in einem Produktiv-Shop installieren, müssen Sie ein aktuelles Backup sowohl der Datenbank als auch der Dateien haben. Wenn Sie einen seriösen Hoster (o2switch, OVH, Cloudways, SiteGround) nutzen, ist ein automatisches tägliches Backup bereits eingerichtet – prüfen Sie, ob es aktuell und wiederherstellbar ist.
Ideal ist es, auf einer Vorab-Umgebung zu testen, die identisch mit der Produktivumgebung ist, und die Installation dort durchzuführen. Wenn Sie kein Staging haben, ist ein schneller Datenbankexport über das integrierte PrestaShop-Tool besser als nichts.
Methode 1: Installation über das Back-Office
Dies ist die gängigste und sicherste Methode. Sie funktioniert für jedes Modul, das als ZIP-Datei geliefert wird – ob aus dem offiziellen Addon-Store, einem Drittanbieter-Marktplatz oder von einem unabhängigen Entwickler.
- Im PrestaShop-Back-Office anmelden
- Zu Module → Modulverwaltung navigieren
- Oben rechts auf Ein Modul hochladen klicken
- Die ZIP-Datei in die Dropzone ziehen oder per Klick auswählen
- Auf die Bestätigungsmeldung warten
- Auf Konfigurieren klicken, um zu den Moduleinstellungen zu gelangen
Schlägt der Upload mit einem Größenfehler fehl, sind Ihre PHP-Direktiven zu restriktiv. Sie müssen upload_max_filesize, post_max_size und memory_limit in Ihrer php.ini oder über eine .htaccess im PrestaShop-Stammverzeichnis erhöhen. Sinnvolle Werte: 64M für die ersten beiden, 256M für den Arbeitsspeicher.
Sonderfall: von PrestaShop Marketplace gesperrte Module
Wenn Sie Ihr Modul auf addons.prestashop.com gekauft haben, ist das ZIP manchmal signaturgeschützt und erfordert ein eingeloggtes PrestaShop-Konto. In diesem Fall muss die Installation über Module → Auswahl und den mit Ihrem Kauf verknüpften Installationsbutton erfolgen. Das ist so gewollt – PrestaShop sperrt damit unbefugte Weitergabe.
Methode 2: Installation per FTP
Diese Methode ist in zwei Fällen nützlich: Ihre ZIP-Datei ist zu groß für die PHP-Limits Ihres Hosters, oder Sie installieren mehrere Module gleichzeitig und möchten schneller vorgehen.
- Das Modul lokal entpacken
- Sie erhalten einen Ordner mit dem Namen des Moduls (z. B.
meinmodul/) - Diesen Ordner per FTP oder SFTP in
/modules/im PrestaShop-Stammverzeichnis hochladen - Zurück zu Module → Modulverwaltung
- Das Modul in der Liste finden und auf Installieren klicken
Achtung: Entpacken Sie kein ZIP, das bereits /modules/meinmodul/ im PrestaShop-Stammverzeichnis enthält – Sie riskieren, bestehende Dateien zu überschreiben. Prüfen Sie immer die ZIP-Struktur vor dem Entpacken.
Methode 3: Installation per Composer (PrestaShop 9)
Diese Methode gilt nur für moderne Module, die nach Symfony-Standards entwickelt wurden – derzeit hauptsächlich offizielle Module und einige Entwicklermodule. Composer lädt das Modul und seine PHP-Abhängigkeiten automatisch herunter.
cd /pfad/zu/prestashop
composer require prestashop/modul-nameDanach aktivieren Sie es wie ein normales Modul über das Back-Office. Die offizielle PrestaShop-Dokumentation listet Composer-kompatible Module auf. Für Drittanbieter-Module bleibt Methode 1 die Norm.
Ein Modul nach der Installation konfigurieren
Nach der Installation bleibt ein Modul inaktiv, bis Sie es konfiguriert haben. Klicken Sie auf Konfigurieren neben dem Modulnamen, um zu den Einstellungen zu gelangen.
Seriöse Module liefern eine übersichtliche Konfigurationsseite mit den wesentlichen Parametern. Weniger professionelle Module lassen Sie mit einer manuell zu bearbeitenden config.xml-Datei allein – das ist ein Warnsignal.
Viele Module benötigen außerdem einen oder mehrere aktivierte Hooks. Ein Hook ist ein Einhängepunkt auf der Seite, an dem das Modul seinen Inhalt einbettet. Ein Slider-Modul muss beispielsweise am displayHome-Hook hängen, um auf der Startseite angezeigt zu werden. Prüfen Sie unter Module → Positionen, ob die erwarteten Hooks aktiviert sind.
In einer Staging-Umgebung testen
Bei einem stark frequentierten Shop niemals direkt in der Produktion installieren. Die empfohlene Vorgehensweise:
- Den Shop in einer Staging-Umgebung duplizieren (gleiche PrestaShop-, PHP- und MySQL-Versionen)
- Das Modul auf Staging installieren
- Kritische Pfade 24 bis 48 Stunden testen: Warenkorb, Checkout, Zahlung, Multishop falls zutreffend
- Logs prüfen (Symfony, Apache, PHP) – ein Modul kann funktionieren, aber im Hintergrund still Fehler werfen
- Wenn alles grün ist, die Installation in der Produktion außerhalb der Stoßzeiten replizieren
Häufigste Fehler und Lösungen
„Das Modul erscheint nicht in der Liste“
Drei mögliche Ursachen: Das ZIP wurde im falschen Ordner entpackt (prüfen Sie, ob es unter /modules/modulname/ liegt), die Dateiberechtigungen stimmen nicht (PHP-Dateien sollten 644 haben, Ordner 755), oder der Back-Office-Cache ist veraltet. Um den Cache zu leeren, gehen Sie zu Erweiterte Einstellungen → Performance und klicken auf Cache leeren.
„500-Fehler nach der Aktivierung“
Das Modul ist wahrscheinlich inkompatibel mit Ihrer PrestaShop- oder PHP-Version. Deaktivieren Sie es, indem Sie den Modulordner per FTP löschen, und prüfen Sie dann die Versionsangaben auf der Produktseite. PrestaShop 1.7 vs. 8 Kompatibilität ist die häufigste Fehlerquelle.
„Das Modul funktioniert, wird aber nicht angezeigt“
Hook nicht aktiviert. Gehen Sie zu Module → Positionen, suchen Sie Ihr Modul in der Liste und prüfen Sie die verknüpften Hooks. Wenn nichts angehakt ist, hängen Sie es an die in der Dokumentation empfohlenen Hooks.
„Konflikt mit einem anderen Modul“
Typisches Symptom: Ein Modul funktioniert alleine, bricht aber zusammen, wenn ein zweites aktiviert wird. Die Lösung führt über Symfony-Logs (in var/logs/) und selektives Deaktivieren, um den Verursacher zu identifizieren. Häufigste Konflikte betreffen Module, die dieselben Hooks oder Templates beeinflussen.
Best Practices nach der Installation
Sobald Ihr Modul installiert und konfiguriert ist, zwei gute Gewohnheiten:
- Dokumentieren – führen Sie eine Liste installierter Module, Versionen und Lizenzen. Bei Migrationen oder Support-Tickets sparen Sie damit Stunden.
- Regelmäßig aktualisieren – die meisten dokumentierten PrestaShop-Sicherheitslücken entstehen durch veraltete Drittanbieter-Module. Aktivieren Sie Update-Benachrichtigungen unter Module → Benachrichtigungen.
Nächste Schritte
Entdecken Sie unseren Katalog an PrestaShop-8-Modulen nach Kategorie: SEO, Checkout, Marketing und mehr. Jedes DataFirefly-Modul wird mit einer detaillierten Installationsdokumentation und deutschsprachigem technischen Support geliefert.