Instalacja i aktualizacja modułu

Moduł PrestaOne łączy Twoją instalację PrestaShop z aplikacją mobilną. Najpierw zainstaluj go w sklepie, a potem połącz każdy telefon na stronie modułu Połączenia i dostęp.

Potrzebujesz konta administratora PrestaShop z uprawnieniami do instalowania i konfigurowania modułów. Konto w aplikacji PrestaOne to osobne konto: hasła do panelu administracyjnego nie używasz do logowania w aplikacji.

Przed instalacją

• Sprawdź, czy sklep działa na obsługiwanej wersji PrestaShop: 1.7.8 lub nowszej z serii 1.7, 8 albo 9. Serwer musi spełniać wymagania PHP danej wersji PrestaShop oraz minimum modułu, czyli PHP 7.4, z wymaganymi rozszerzeniami, w tym cURL, JSON, Mbstring i OpenSSL.
• Otwórz publiczną witrynę sklepu przez HTTPS. W aplikacji wpisujesz publiczny adres sklepu, a nie prywatny adres logowania do panelu administracyjnego.
• Przed zmianą zainstalowanych modułów zrób kopię zapasową plików sklepu i bazy danych. Zachowaj ją, dopóki nie sprawdzisz instalacji.
• Pracuj w kontekście jednego sklepu. PrestaOne oficjalnie nie obsługuje multisklepu PrestaShop. Łączenie kilku niezależnych sklepów w aplikacji to inna funkcja; w każdym z tych sklepów zainstaluj moduł osobno.

Zainstaluj plik ZIP w PrestaShop

1. Na komputerze otwórz stronę Pobieranie PrestaOne i pobierz plik ZIP modułu. Jeśli masz moduł z marketplace'u, użyj paczki dostarczonej z zakupem. Nie rozpakowuj ani nie zmieniaj pliku ZIP.
2. W panelu administracyjnym sklepu otwórz Moduły → Menedżer modułów i wybierz Załaduj moduł. Nazwy w menu mogą się nieco różnić między wersjami PrestaShop.
3. Wybierz pobrany plik ZIP i poczekaj, aż PrestaShop go załaduje i zainstaluje. Samo zakończenie ładowania to jeszcze nie koniec: PrestaShop musi potwierdzić, że instalacja się powiodła.
4. Znajdź PrestaOne Mobile Bridge w Menedżerze modułów i wybierz Konfiguruj. Sprawdź, czy moduł jest włączony.
5. W module otwórz Zaawansowane i rozwiń Server diagnostics. Sprawdź wymagania serwera. Jeśli któregoś brakuje, przekaż dokładnie to wymaganie firmie hostingowej, zanim spróbujesz sparować telefon.

Moduł ma w PrestaShop własne zakładki. Kieruj się tymi nazwami w dalszej części dokumentacji. Powiększ ↗

Na tym etapie status Niepołączony jest prawidłowy: instalacja tworzy część po stronie sklepu, ale żaden telefon nie został jeszcze sparowany. Przejdź do artykułu Połącz sklep z aplikacją.

Sprawdź instalację przed połączeniem

Ponownie otwórz konfigurację modułu z Menedżera modułów. Strona powinna wczytać zakładki i pokazać opcję połączenia aplikacji mobilnej. Aby przyciski parowania działały, przeglądarka musi mieć włączony JavaScript.

Otwórz też zwykłą stronę sklepu. Instalacja modułu nie powinna utrudniać klientom przeglądania sklepu ani składania zamówień. To, że sklep się otwiera, nie dowodzi jeszcze, że działa parowanie lub czat na żywo; obie funkcje mają własne kroki weryfikacji.

Jeśli instalacja się nie powiedzie, zachowaj dokładną treść błędu. Limit wielkości przesyłanego pliku, brak rozszerzenia PHP i błąd konfiguracji modułu wymagają różnych rozwiązań. Sprawdź Zaawansowane → Server diagnostics, jeśli jest dostępne; w przeciwnym razie wyślij treść błędu firmie hostingowej lub wsparciu PrestaOne.

Zaktualizuj istniejącą instalację

Aktualizacja zachowuje istniejącą instalację i uruchamia kroki aktualizacji modułu. Nie odinstalowuj modułu, żeby go zaktualizować. Odinstalowanie usuwa dane modułu, w tym rozmowy z czatu, dane odzyskiwania koszyków, statystyki i ustawienia połączeń.

1. Zanotuj zainstalowaną wersję widoczną w Menedżerze modułów i zrób kopię zapasową plików sklepu oraz bazy danych.
2. Pobierz nowszy oficjalny plik ZIP. Użyj w PrestaShop opcji aktualizacji lub załadowania modułu dla istniejącej instalacji PrestaOne.
3. Poczekaj na wynik aktualizacji, a potem ponownie otwórz Konfiguruj. Sprawdź, czy istniejące połączenia i ustawienia usług nadal są na miejscu.
4. W aplikacji odśwież połączony sklep i otwórz zamówienie lub produkt, aby potwierdzić, że dane sklepu się wczytują.
5. Jeśli korzystasz z czatu na żywo, sprawdź widżet czatu w sklepie. Jeśli korzystasz z odzyskiwania koszyków, sprawdź zapisaną kampanię i status usługi. Samo połączenie z aplikacją nie potwierdza działania tych usług.

Jeśli PrestaShop zgłosi nieudaną aktualizację, zachowaj kopię zapasową i szczegóły błędu. Nie odinstalowuj i nie instaluj modułu w kółko. Jeśli aplikacja wyraźnie informuje, że wersja modułu nie jest już obsługiwana, zaktualizuj moduł, zanim ponowisz próbę połączenia.

Gdy moduł jest zainstalowany, ale nie chce się połączyć

Pełną procedurę parowania znajdziesz w artykule Połącz sklep z aplikacją. Konkretne błędy opisuje artykuł Problemy z połączeniem i usługą.

Za CDN-em lub reverse proxy publiczna witryna sklepu może działać przez HTTPS, podczas gdy PHP widzi wewnętrzne połączenie HTTP. W takim przypadku skorzystaj z przewodnika po reverse proxy. Nie zgaduj adresów proxy i nie wyłączaj zabezpieczeń HTTPS tylko po to, żeby błąd zniknął.