Integracja Viber Chat: konfiguracja i pomoc

Szybki start

  1. W Moduły > "Module Manager" wybierz "Upload a module" i zainstaluj ZIP mprviberchatintegration.
  2. Kliknij "Configure".
  3. W Połączenie Viber wpisz Numer telefonu, na przykład +48600123456.
  4. Pozostaw Włącz czat Viber ustawione na Tak i wybierz róg w Wygląd przycisku > Pozycja.
  5. W Zachowanie wyświetlania na potrzeby pierwszego testu pozostaw Pokaż na stronach ustawione na Wszystkie strony, a Fallback Delay (seconds) na 0.
  6. Kliknij Zapisz. Otwórz dozwoloną stronę sklepu z włączonym JavaScript.
  7. Przewiń stronę, kliknij ją lub odczekaj 10 sekund. Sprawdź, czy przycisk się pojawia, i sprawdź jego cel: +48600123456. Kliknij go na urządzeniu, które może otworzyć Viber, i potwierdź właściwy kontakt.

Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.

Instrukcja konfiguracji

Instalacja i pierwsza konfiguracja

W starszych wersjach PrestaShop użyj odpowiedniej strony instalacji modułów. Aby wrócić do ustawień tego modułu, otwórz go przez "Configure".

Połączenie Viber

Ustawienie Domyślnie Co zrobić
Włącz czat Viber Tak Wyłącz, aby zatrzymać wyświetlanie w sklepie i zachować zapisaną konfigurację.
Numer telefonu Puste Wpisz 7-20 cyfr z opcjonalnym + na początku. Uwzględnij numer kierunkowy kraju. Nie używaj spacji, nawiasów, łączników ani adresu URL zaproszenia do społeczności.
Wstępnie wypełniona wiadomość Puste Zapisz opcjonalny tekst; {url} zostanie zastąpione bieżącym adresem URL sklepu. Link zawiera zakodowany tekst w ?draft=. Link do kontaktu wymaga zarejestrowanego konta Viber Business, niezależnie od tego, czy zawiera wstępnie wypełnioną wiadomość.

Po zapisaniu numeru telefonu użyj linku testowego na stronie konfiguracji, aby potwierdzić, że otwiera właściwy kontakt w Viber. Format zmienionych numerów jest sprawdzany podczas zapisu. Odrzucona zmiana zachowuje poprzednią konfigurację. Niezmieniony numer nie jest sprawdzany ponownie.

Wygląd przycisku

Ustawienie Domyślnie Co zrobić
Pozycja bottom-right Wybierz Na dole po prawej lub Na dole po lewej, aby uniknąć kolizji z innymi pływającymi elementami sterującymi.
Styl przycisku icon Wybierz Pływająca ikona dla okrągłego przycisku lub Pasek z tekstem dla przycisku tekstowego.
Tekst przycisku Chat on Viber Ustaw etykietę wyświetlaną w trybie paska. Służy ona również jako etykieta dostępności przycisku z ikoną.
Kolor przycisku #7360F2 Ustaw kolor tła za pomocą selektora kolorów.
Rozmiar przycisku (px) 60 Zmień średnicę okrągłej ikony. Tryb paska używa własnych odstępów wewnętrznych.
Margines od krawędzi (px) 20 Ustaw odległość od dolnej i bocznej krawędzi w pikselach.
Pokaż podpowiedź Tak Wyłącz podpowiedź po najechaniu, jeśli jej nie potrzebujesz.
Tekst podpowiedzi Chat with us on Viber Wpisz wiadomość wyświetlaną po najechaniu.
Animacja pulse Wybierz pulse, bounce lub none. Wybierz none, aby zatrzymać powtarzającą się animację.

Możesz przetłumaczyć Tekst przycisku i Tekst podpowiedzi za pomocą przełączników języka w formularzu. Puste tłumaczenie korzysta z języka domyślnego. Ten sam mechanizm zastępowania języka dotyczy Wstępnie wypełniona wiadomość. Po edycji użyj Zapisz.

Zachowanie wyświetlania

Ustawienie Domyślnie Co zrobić
Pokaż na urządzeniach mobilnych Tak Zezwól na przycisk dla odwiedzających rozpoznanych przez PrestaShop jako użytkownicy urządzeń mobilnych. Wyłącz, aby ukryć go na tych urządzeniach.
Fallback Delay (seconds) 0 Wczytaj przy pierwszym przewinięciu, kliknięciu, dotknięciu lub naciśnięciu klawisza. Wartość dodatnia ustala maksymalny czas biernego oczekiwania w sekundach. 0 oznacza awaryjne wczytanie po 10 sekundach.
Pokaż na stronach all Wybierz Wszystkie strony, Tylko strony produktów, Tylko strony kategorii lub Tylko strony zamówienia.

Tylko strony zamówienia obejmuje koszyk i strony składania zamówienia. Jeśli używasz innego modułu zamówienia, sprawdź, czy jego strony są uwzględniane. Oczekiwanie awaryjne rozpoczyna się po otwarciu strony. Nie jest to dodatkowe opóźnienie po interakcji.

Działanie w sklepie i weryfikacja

Przycisk pojawia się tylko wtedy, gdy czat Viber jest włączony, numer telefonu jest zapisany, a ustawienia stron i urządzeń mobilnych pozwalają go wyświetlić. Format numeru jest sprawdzany podczas zapisu zmienionego numeru. Motyw musi renderować displayHeader dla arkusza stylów oraz displayFooter w PrestaShop 1.6 lub displayBeforeBodyClosingTag w wersji 1.7 i nowszych dla widgetu.

Po pierwszej interakcji lub upływie czasu awaryjnego w wybranym rogu pojawia się przycisk o stałej pozycji. Jego link otwiera się w nowej karcie i używa tego celu:

https://viber.me/48600123456

Konfigurujesz jeden kontakt telefoniczny. Wartości takie jak 48600123456 i 0048600123456 również przechodzą sprawdzenie formatu, ale musisz przetestować, czy dokładnie wpisana wartość jest poprawnie rozpoznawana w Viber. Urządzenie musi obsługiwać otwieranie linków Viber. Moduł nie zapewnia historii czatu, analityki, botów, rozsyłania wiadomości ani automatyzacji Business API.

Jeśli ograniczasz typy stron, przetestuj jedną stronę dozwoloną i jedną wykluczoną. Sprawdź widoczność mobilną na rzeczywistym urządzeniu. Jeśli używasz wielu języków, sprawdź przetłumaczony tekst przycisku i podpowiedzi.

Przykłady konfiguracji i dostosowania motywu

Aby uzyskać przycisk tekstowy na stronach produktów, ustaw Styl przycisku na Pasek z tekstem, Tekst przycisku na Ask us on Viber, Pokaż na stronach na Tylko strony produktów, a Animacja na none. Możesz wybrać Na dole po lewej, gdy inny widget zajmuje prawy róg.

Jeśli musisz przesunąć widget ponad inny element o stałej pozycji, dodaj regułę do arkusza stylów motywu:

#mprviber-widget.mprviber-bottom-right {
  bottom: 90px;
  right: 24px;
}

#mprviber-widget.mprviber-bar a span {
  font-size: 15px;
}

Aby nadpisać szablon w motywie, użyj:

themes/your-theme/modules/mprviberchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl

Szablon otrzymuje $mprviber z position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation i delay oraz przygotowany adres chat_url. Adres zawiera numer telefonu bez początkowego + i ewentualną zakodowaną treść wiadomości. Zachowaj zmiany w motywie, aby aktualizacja modułu ich nie nadpisała.

Rozwiązywanie problemów

  • Jeśli nie widzisz przycisku, sprawdź przełącznik włączenia, zapisany identyfikator oraz reguły stron i urządzeń mobilnych. Wywołaj interakcję lub poczekaj na wczytanie awaryjne.
  • Jeśli zmiana zostanie odrzucona, wpisz identyfikator w formacie podanym powyżej. Nie wklejaj pełnego linku do kontaktu.
  • Jeśli widget nie ma stylów, sprawdź, czy motyw wywołuje displayHeader i wczytuje arkusz stylów modułu.
  • Jeśli szablon nigdy się nie pojawia, sprawdź displayFooter w PrestaShop 1.6 lub displayBeforeBodyClosingTag w wersji 1.7 i nowszych oraz rejestrację hooków modułu w panelu administracyjnym.
  • Jeśli przycisk nachodzi na inny element sterujący, zmień Pozycja lub Margines od krawędzi (px).
  • Jeśli przycisk się pojawia, ale cel nie działa, przetestuj zapisany kontakt i mechanizm obsługi aplikacji zewnętrznych na urządzeniu.

Zmiana Wstępnie wypełniona wiadomość dodaje lub aktualizuje część ?draft= linku w sklepie. Przed kodowaniem {url} jest zastępowane adresem bieżącej strony. Przy pustej wiadomości ?draft= jest pomijane. Link do kontaktu wymaga zarejestrowanego konta Viber Business, niezależnie od tego, czy zawiera wstępnie wypełnioną wiadomość; testuj przycisk w sklepie, ponieważ link testowy na stronie konfiguracji zawiera tylko numer telefonu.

Użyj strony "Integrity" modułu do diagnostyki konfiguracji i hooków. Licencja, Wsparcie i Aktualizuj to strony konserwacji, a nie ustawienia wyglądu sklepu.

Wyłączenie lub odinstalowanie

Wyłącz Włącz czat Viber i zapisz, aby zachować konfigurację. Główny formularz nadal wymaga niepustego identyfikatora podczas zapisu. Możesz też wyłączyć moduł z listy modułów.

Użyj "Uninstall" w menedżerze modułów, aby usunąć konfigurację modułu i jego pozycje menu administracyjnego. Twoje zewnętrzne konto komunikatora nie zostanie usunięte.

Pytania

Brak pytań o ten moduł

Zapytaj o instalację, zgodność lub konfigurację. Odpowiedzi pojawią się tutaj.

Znane problemy

6

Link czatu miał błędną etykietę dostępności

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.18
Czytniki ekranu mogły odczytywać nazwę linku czatu niezgodną z widocznym tekstem lub językiem sklepu.

Stan instalacji pozostawał nieaktualny po zapisie

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.18
Baner stanu instalacji mógł nadal odzwierciedlać ustawienia sprzed ostatniego zapisu.

Komunikaty panelu administracyjnego pozostawały po angielsku

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.18
Niektóre komunikaty panelu administracyjnego nie korzystały z zainstalowanych tłumaczeń.

Nie można było otworzyć panelu administracyjnego modułu

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.14
Brak dołączonej zależności zgodności mógł powodować błąd krytyczny podczas otwierania panelu administracyjnego modułu.

Łączenie zasobów mogło zakłócać przycisk kontaktu

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.14
Zasoby przycisku kontaktu nie były rejestrowane w formacie wymaganym do łączenia zasobów PrestaShop.

Starsze ustawienia czatu nie były migrowane

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.12
Aktualizacja mogła pozostawiać ustawienia czatu w starym magazynie, sprawiając wrażenie utraty konfiguracji modułu.

Zgłoszenia funkcji

5

Zaimplementowane

Przycisk kontaktu Viber

Zaimplementowane
Umożliwiaj odwiedzającym kontakt ze sklepem przez Viber, z konfigurowalnym numerem telefonu i wstępnie wypełnioną wiadomością.

Kontrola konfiguracji czatu

Zaimplementowane
Sprawdzaj wymagane ustawienia Viber i stan instalacji modułu.

Aktualizacje modułu w panelu administracyjnym

Zaimplementowane
Sprawdzaj i instaluj aktualizacje modułu z panelu administracyjnego.

Dodatkowe języki panelu administracyjnego

Zaimplementowane
Korzystaj z tekstów modułu przetłumaczonych na język francuski, niemiecki, hiszpański, włoski i polski.

Wielojęzyczne teksty dla odwiedzających

Zaimplementowane
Konfiguruj teksty czatu widoczne dla odwiedzających oddzielnie dla każdego języka sklepu.

Dziennik zmian

v1.1.132026-09-28

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate chat config from ps_configuration to ConfigTable
Starsze wersje

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-01

  • AddedPS 9 / Hummingbird theme compatibility
  • Addedpre-filled message option for common customer queries
  • Improvedbutton rendering in Eastern European multilingual stores
  • Fixeddeep-link not opening Viber app on Android 12+ due to URI scheme changes

v1.1.02025-06-20

  • Addedavailability schedule — button hidden outside configured hours
  • Addeddesktop hide option — target mobile-heavy CIS/SEA audiences

v1.0.02025-05-19

  • Initialrelease: Viber messenger chat button for PrestaShop
  • InitialFloating Viber button linking to configured phone number
  • InitialBack-office phone number, position, and colour configuration
  • InitialCompatible with PS 1.7.x and PS 8.x

Demo

Przetestuj pełny moduł przed zakupem

Licencję kupisz później, a ustawienia zostaną.

  • Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
  • Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
  • Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Uruchom sklep demo

Pobierając, akceptujesz warunki dema i politykę prywatności.

Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.

Ładowanie...
Do góry