Modul installieren und aktualisieren

Das PrestaOne-Modul verbindet Ihre PrestaShop-Installation mit der mobilen App. Installieren Sie es zuerst im Shop und verbinden Sie danach jedes Smartphone über die Modulseite Verbindungen & Zugriff.

Sie benötigen ein PrestaShop-Administratorkonto, das Module installieren und konfigurieren darf. Das Konto für die PrestaOne-App ist davon getrennt: Ihr Backoffice-Passwort wird für die Anmeldung in der App nicht verwendet.

Vor der Installation

• Prüfen Sie, ob Ihr Shop eine unterstützte PrestaShop-Version nutzt: 1.7.8 oder neuer innerhalb der Reihe 1.7, 8 oder 9. Ihr Server muss die PHP-Anforderungen der jeweiligen PrestaShop-Version und die Mindestversion des Moduls (PHP 7.4) erfüllen, einschließlich der benötigten Erweiterungen wie cURL, JSON, Mbstring und OpenSSL.
• Ihr Shop muss öffentlich über HTTPS erreichbar sein. In der App geben Sie die öffentliche Shop-Adresse ein, nicht die interne Anmeldeadresse des Backoffice.
• Sichern Sie Shop-Dateien und Datenbank, bevor Sie installierte Module ändern. Bewahren Sie die Sicherung auf, bis die Installation geprüft ist.
• Arbeiten Sie in einem einzigen Shop-Kontext. PrestaOne unterstützt die Multishop-Funktion von PrestaShop offiziell nicht. Mehrere unabhängige Shops in der App zu verbinden ist eine andere Funktion: Installieren Sie das Modul dafür in jedem dieser Shops separat.

ZIP-Datei in PrestaShop installieren

1. Öffnen Sie am Computer die PrestaOne-Downloads und laden Sie die ZIP-Datei des Moduls herunter. Haben Sie das Modul über einen Marketplace erworben, verwenden Sie das Paket, das Sie mit Ihrem Kauf erhalten haben. Entpacken oder verändern Sie die ZIP-Datei nicht.
2. Öffnen Sie im Backoffice Ihres Shops Module → Modul-Verwaltung und wählen Sie Modul hochladen. Die Menübezeichnungen können je nach PrestaShop-Version leicht abweichen.
3. Wählen Sie die heruntergeladene ZIP-Datei aus und warten Sie, bis PrestaShop sie hochgeladen und installiert hat. Der abgeschlossene Upload ist noch nicht die letzte Prüfung: PrestaShop muss melden, dass die Installation erfolgreich war.
4. Suchen Sie PrestaOne Mobile Bridge in der Modul-Verwaltung und wählen Sie Einstellungen. Prüfen Sie, ob das Modul aktiviert ist.
5. Öffnen Sie im Modul Erweitert und klappen Sie Server diagnostics auf. Prüfen Sie die Serveranforderungen. Ist eine davon nicht erfüllt, nennen Sie Ihrem Hosting-Anbieter genau diese Anforderung, bevor Sie versuchen, ein Smartphone zu koppeln.

Das Modul hat eigene Registerkarten in PrestaShop. Mit diesen Namen finden Sie sich im Rest der Dokumentation zurecht. Vergrößern ↗

In diesem Schritt ist Nicht verbunden zu erwarten: Die Installation legt die Komponente im Shop an, gekoppelt ist aber noch kein Smartphone. Weiter geht es mit Shop mit der App verbinden.

Installation vor dem Verbinden prüfen

Öffnen Sie die Konfiguration des Moduls erneut über die Modul-Verwaltung. Die Seite sollte ihre Registerkarten laden und die Option anzeigen, die mobile App zu verbinden. Damit die Kopplungsfunktionen arbeiten, muss JavaScript im Browser aktiviert sein.

Öffnen Sie außerdem eine normale Seite Ihres Shops. Die Installation des Moduls darf Besucher nicht am Stöbern oder Bestellen hindern. Dass der Shop normal lädt, beweist allein aber noch nicht, dass Kopplung oder Live-Chat funktionieren: Dafür gibt es eigene Prüfschritte.

Schlägt die Installation fehl, notieren Sie den genauen Fehlertext. Ein Limit für die Upload-Größe, eine fehlende PHP-Erweiterung und ein Fehler bei der Einrichtung des Moduls erfordern unterschiedliche Lösungen. Prüfen Sie, falls vorhanden, Erweitert → Server diagnostics. Andernfalls senden Sie den Fehler an Ihren Hosting-Anbieter oder an den PrestaOne-Support.

Bestehende Installation aktualisieren

Bei einem Update bleibt die bestehende Installation erhalten und das Modul führt seine Upgrade-Schritte aus. Deinstallieren Sie das Modul nicht, um es zu aktualisieren. Beim Deinstallieren werden Moduldaten gelöscht, darunter Chat-Unterhaltungen, Daten der Warenkorb-Erinnerungen, Analysen und Verbindungseinstellungen.

1. Notieren Sie die installierte Version aus der Modul-Verwaltung und sichern Sie Shop-Dateien und Datenbank.
2. Laden Sie die neuere offizielle ZIP-Datei herunter. Verwenden Sie für die bestehende PrestaOne-Installation die Update- bzw. Upload-Funktion für Module in PrestaShop.
3. Warten Sie auf das Ergebnis des Upgrades und öffnen Sie dann erneut Einstellungen. Prüfen Sie, ob Ihre bestehenden Verbindungen und Diensteinstellungen noch vorhanden sind.
4. Aktualisieren Sie in der App den verbundenen Shop und öffnen Sie eine Bestellung oder einen Artikel, um zu prüfen, ob die Shopdaten laden.
5. Wenn Sie den Live-Chat nutzen, prüfen Sie das Chat-Widget im Shop. Wenn Sie Warenkorb-Erinnerungen nutzen, prüfen Sie die gespeicherte Kampagne und deren Dienststatus. Eine funktionierende App-Verbindung allein bestätigt diese Dienste nicht.

Meldet PrestaShop ein fehlgeschlagenes Upgrade, bewahren Sie die Sicherung und die Fehlerdetails auf. Deinstallieren und installieren Sie das Modul nicht immer wieder neu. Meldet die App ausdrücklich, dass die Modulversion nicht mehr unterstützt wird, aktualisieren Sie das Modul, bevor Sie die Verbindung erneut versuchen.

Modul installiert, aber keine Verbindung

Den vollständigen Ablauf der Kopplung finden Sie unter Shop mit der App verbinden. Bei einem konkreten Fehler hilft Verbindungs- und Dienstprobleme beheben.

Hinter einem CDN oder Reverse-Proxy kann das öffentliche Front-Office HTTPS nutzen, während PHP eine interne HTTP-Verbindung sieht. Folgen Sie in diesem Fall der Anleitung zum Reverse-Proxy. Raten Sie keine Proxy-Adressen und deaktivieren Sie keine HTTPS-Schutzmechanismen, nur damit eine Fehlermeldung verschwindet.