Integracja Chatra Chat

Tak. Przełącznik widoczności mobilnej pozwala ukryć widżet na ekranach mobilnych, zachowując go na komputerach. Po wyłączeniu moduł całkowicie pomija skrypt Chatry na urządzeniach mobilnych, na telefonach nie pojawia się przycisk czatu ani nie jest ładowany dodatkowy skrypt.

Tak. Załóż konto na chatra.io, następnie otwórz Ustawienia > Ogólne > Kod widżetu i skopiuj Widget ID z fragmentu instalacyjnego. Wklej ten identyfikator w pole Widget ID modułu. Dopóki Widget ID nie zostanie zapisany, moduł pozostaje nieaktywny, a panel administracyjny wyświetla przypomnienie, widżet nigdy nie załaduje się bez prawidłowego identyfikatora.

Tak, moduł może ograniczyć Chatra według typu strony PrestaShop. Jego konfiguracja obsługuje wszystkie strony, strony produktów, strony kategorii i controllery związane z checkout, takie jak cart, order i checkout, więc widget nie musi renderować się na każdej stronie sklepu.

W konfiguracji modułu jest to ustawienie PAGES. Wbudowane opcje to all, product, category i checkout; checkout obejmuje rodzinę controllerów cart/order używaną przez różne wersje PrestaShop, w tym cart, order, order-opc, orderopc i checkout. Widget jest renderowany z displayBeforeBodyClosingTag tylko wtedy, gdy moduł jest włączony, wymagany Widget ID jest obecny, ustawienie mobile pozwala na bieżące urządzenie, a kontrola strony przechodzi.

Jest jedno praktyczne ograniczenie: to targetowanie typu strony, a nie builder reguł per URL. Gdy PAGES jest ustawione na product, category lub checkout, inne nazwy controllerów nie przechodzą jako dozwolone; nie spełniają wybranej kontroli typu strony. Permisywny fallback dotyczy pustego/all ustawienia albo nieoczekiwanej wartości konfiguracji PAGES. Jeśli potrzebujesz uwzględnić lub wykluczyć pojedynczy landing page albo bardzo konkretny controller, wymagałoby to reguły na poziomie kodu albo bardziej zaawansowanej warstwy targetowania w samej Chatra.

Tak, ale w renderowanym snippecie Chatra tego modułu do Chatra przekazywany jest tylko email zalogowanego klienta. Wspólny helper chat może zebrać zarówno email, jak i imię, gdy PASS_USER_DATA jest włączone, a klient jest zalogowany, ale szablon Chatra zapisuje tylko email jako window.ChatraSetup.clientId.

Aby wyłączyć takie przekazywanie danych, wyłącz przełącznik Pass Customer Data w ustawieniach modułu Chatra. Wtedy helper zwraca puste wartości klienta, a szablon nie emituje clientId. Ten szablon Chatra nie drukuje imienia klienta, danych zamówień, danych adresowych ani danych grup.

Triggery czatu, routing czatu, przypisywanie operatorów i projekt widgetu pozostają konfigurowane w samej Chatra. Moduł PrestaShop odpowiada głównie za ładowanie https://call.chatra.io/chatra.js z Widget ID i opcjonalnym opóźnieniem.

Domyślna wartość instalacji dla PASS_USER_DATA jest włączona, ale dane nadal są warunkowe: obiekt klienta musi istnieć, odwiedzający musi być zalogowany, a hook storefront musi mieć pozwolenie na renderowanie. Goście nie otrzymują żadnego identyfikatora klienta z tego modułu. Ustawienie opóźnienia jest też obsługiwane lokalnie: gdy DELAY jest większe od zera, szablon owija loader Chatra w setTimeout; gdy wynosi zero, loader działa natychmiast.

Dla przeglądów prywatności ważne jest rozróżnienie, że helper może zwracać pełne imię i nazwisko, ale ten konkretny szablon Chatra go nie wypisuje. Jedyną wartością pochodzącą od klienta emitowaną przez szablon jest emailowy clientId, i tylko wtedy, gdy PASS_USER_DATA pozostaje włączone.

Tak, skrypt Chatra może być opóźniony o skonfigurowaną liczbę sekund. W PrestaShop szablon owija loader widgetu w setTimeout, gdy wartość opóźnienia jest większa od zera, a następnie ładuje ten sam skrypt Chatra po tym opóźnieniu.

Zapisane ustawienie to DELAY, udostępniane przez wspólny formularz chat jako Fallback Delay (seconds). Moduł przekazuje je do szablonu Smarty jako integer. Gdy DELAY>0, szablon owija zarówno przypisanie window.ChatraID/window.ChatraSetup, jak i blok dołączania skryptu w setTimeout(..., DELAY * 1000).

Gdy DELAY=0, szablon nie owija loadera w setTimeout, więc Chatra jest inicjalizowana natychmiast po sparsowaniu wyjścia hooka. Obecny szablon nie implementuje ładowania po scroll, click, touch ani first-interaction; to prosty timer w sekundach.

DELAY=0  -> load immediately
DELAY=3  -> wait 3 seconds, then load Chatra
DELAY=10 -> wait 10 seconds, then load Chatra

Ustawienie opóźnienia wpływa tylko na timing po tym, jak moduł zdecydował się renderować. Najpierw nadal stosuje się normalny guard: moduł musi być włączony, WIDGET_ID musi być zapisane, ustawienie mobile musi pozwalać na urządzenie odwiedzającego, a reguła targetowania strony musi pasować.

Dodaj swój Chatra Widget ID i włącz moduł. Hook PrestaShop renderuje skrypt Chatra przed zamykającym tagiem body, przypisuje ID do window.ChatraID i asynchronicznie ładuje https://call.chatra.io/chatra.js w sklepie. Dzięki temu konfiguracja pozostaje powiązana z ustawieniami modułu i zachowaniem runtime PrestaShop.

Podczas instalacji moduł Chatra ustawia ENABLED=1, puste WIDGET_ID, SHOW_MOBILE=1, PAGES=all, DELAY=0 i PASS_USER_DATA=1. Moduł może więc zostać zainstalowany i włączony, ale nadal nie wypisze widgetu, dopóki nie zostanie zapisany niepusty Widget ID.

Strona konfiguracji etykietuje pole jako Widget ID, a pomoc źródłowa mówi, aby wkleić je z Chatra z Settings > General > Widget code. Walidator wymaganej konfiguracji sprawdza tylko, że wartość nie jest pusta; nie wymusza formatu UUID, jak robi to moduł Crisp.

Przed renderowaniem wspólny guard chat sprawdza, czy moduł jest włączony, wymagane WIDGET_ID jest obecne, wyświetlanie mobilne jest dozwolone, gdy odwiedzający jest na mobile, oraz czy wybrana reguła targetowania stron pasuje do bieżącego controllera. Gdy te kontrole przejdą, szablon ustawia window.ChatraID, tworzy window.ChatraSetup i asynchronicznie dołącza skrypt loadera Chatra.

Minimum setup:
Enable Chatra Chat = Yes
Widget ID = value copied from Chatra widget code
Show on Pages = all, product, category or checkout

Jeśli PASS_USER_DATA jest włączone, a kupujący jest zalogowany, szablon umieszcza też email klienta w ChatraSetup.clientId. Nie wysyła imienia klienta, adresu, zawartości koszyka ani historii zamówień w tym szablonie.