Integracja Viber Chat: konfiguracja i pomoc
Szybki start
- W Moduły > "Module Manager" wybierz "Upload a module" i zainstaluj ZIP
mprviberchatintegration. - Kliknij "Configure".
- W Połączenie Viber wpisz Numer telefonu, na przykład
+48600123456. - Pozostaw Włącz czat Viber ustawione na Tak i wybierz róg w Wygląd przycisku > Pozycja.
- W Zachowanie wyświetlania na potrzeby pierwszego testu pozostaw Pokaż na stronach ustawione na Wszystkie strony, a Fallback Delay (seconds) na
0. - Kliknij Zapisz. Otwórz dozwoloną stronę sklepu z włączonym JavaScript.
- 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.
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
displayHeaderi wczytuje arkusz stylów modułu. - Jeśli szablon nigdy się nie pojawia, sprawdź
displayFooterw PrestaShop 1.6 lubdisplayBeforeBodyClosingTagw 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
Stan instalacji pozostawał nieaktualny po zapisie
Komunikaty panelu administracyjnego pozostawały po angielsku
Nie można było otworzyć panelu administracyjnego modułu
Łączenie zasobów mogło zakłócać przycisk kontaktu
Starsze ustawienia czatu nie były migrowane
Zgłoszenia funkcji
5
Zaimplementowane
Przycisk kontaktu Viber
Kontrola konfiguracji czatu
Aktualizacje modułu w panelu administracyjnym
Dodatkowe języki panelu administracyjnego
Wielojęzyczne teksty dla odwiedzających
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.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.