Integracja LINE Chat: konfiguracja i pomoc

Szybki start

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

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.

Instrukcja konfiguracji

Instalacja i pierwsza konfiguracja

W starszych wersjach PrestaShop użyj odpowiedniej strony instalacji modułów. Otwieraj ten moduł przez "Configure", gdy chcesz wrócić do jego ustawień.

Połączenie LINE

Ustawienie Domyślnie Co robisz
Włącz LINE Chat Tak Wyłącz, aby zatrzymać wyświetlanie w sklepie z zachowaniem zapisanej konfiguracji.
ID LINE Puste Wpisz 2-64 litery, cyfry, kropki, łączniki lub podkreślenia, opcjonalnie z @ na początku.
Wstępnie wypełniona wiadomość Puste Dla identyfikatorów kont oficjalnych zaczynających się od @ wypełnij wstępnie wiadomość na iOS i Androidzie. Użyj {url} dla bieżącego adresu URL sklepu. Osobiste identyfikatory nie obsługują wstępnie wypełnionych wiadomości.

Po zapisaniu identyfikatora strona konfiguracji udostępnia link do konta LINE. Otwórz go, aby sprawdzić cel. Podczas zapisu moduł sprawdza format zmienionych identyfikatorów, bez sprawdzania istnienia konta. Odrzucona zmiana zachowuje poprzednią konfigurację; niezmienione identyfikatory pozostają bez ponownego sprawdzania formatu.

Wygląd przycisku

Ustawienie Domyślnie Co robisz
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 LINE Ustaw etykietę wyświetlaną w trybie paska. Szablon używa jej również jako dostępnej etykiety przycisku z ikoną.
Kolor przycisku #06C755 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 dołu i boku w pikselach.
Pokaż podpowiedź Tak Wyłącz podpowiedź po najechaniu kursorem, jeśli jej nie potrzebujesz.
Tekst podpowiedzi Chat with us on LINE Wpisz wiadomość wyświetlaną po najechaniu kursorem.
Animacja pulse Wybierz pulse, bounce lub none. Wybierz none, aby zatrzymać powtarzającą się animację.

Możesz przetłumaczyć Tekst przycisku i Tekst podpowiedzi, korzystając z kontrolek języka formularza. 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 robisz
Pokaż na urządzeniach mobilnych Tak Zezwól na przycisk dla odwiedzających wykrywanych przez PrestaShop jako użytkownicy mobilni. Wyłącz, aby ukryć go na tych urządzeniach.
Fallback Delay (seconds) 0 Załaduj przy pierwszym przewinięciu, kliknięciu, dotknięciu lub naciśnięciu klawisza. Dodatnia wartość określa maksymalny czas biernego oczekiwania w sekundach. 0 oznacza uruchomienie awaryjne 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 cart, order, order-opc, orderopc i checkout. Inne moduły zamówienia mogą używać innych nazw kontrolerów. Czas oczekiwania na uruchomienie awaryjne zaczyna się na stronie. Nie jest to dodatkowe opóźnienie po interakcji.

Działanie w sklepie i weryfikacja

Motyw musi renderować displayHeader dla arkusza stylów i displayBeforeBodyClosingTag dla widżetu. Przed zwróceniem wyjścia moduł sprawdza przełącznik włączenia, niepusty identyfikator, regułę mobilną i regułę strony.

Po pierwszej interakcji lub uruchomieniu awaryjnym zobaczysz przycisk o stałej pozycji w wybranym rogu. Jego link otwiera się w nowej karcie z noopener noreferrer. Dla konta oficjalnego @myshop bez wiadomości adresem docelowym jest:

https://line.me/R/oaMessage/%40myshop

Użyj osobistego ID LINE lub identyfikatora konta oficjalnego, takiego jak myshop, @myshop, shop.name, shop-name lub shop_name. Osobisty identyfikator myshop prowadzi do https://line.me/ti/p/myshop. Dla konta oficjalnego z zapisaną wiadomością moduł dopisuje /? i wiadomość zakodowaną do użycia w adresie URL do adresu konta oficjalnego, zastępując {url} adresem bieżącej strony. Rozmowy obsługujesz w LINE. Moduł nie generuje kodów QR, nie wysyła powiadomień o zamówieniach ani nie udostępnia skrzynki odbiorczej.

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

Przykłady konfiguracji i dostosowanie motywu

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

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

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

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

Aby nadpisać szablon w motywie, użyj:

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

Szablon otrzymuje $mprline z chat_url, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation i delay. Przygotowane chat_url zawiera wiadomość dla kont oficjalnych; osobne pola line_id i message nie są przekazywane. Przechowuj zmiany w motywie, aby aktualizacja modułu ich nie nadpisała.

Ustawienia korzystają ze wspólnej tabeli mpr_config ze skonfigurowanym prefiksem bazy danych, nazwy modułu mprlinechatintegration i krótkich kluczy, takich jak LINE_ID, POSITION, STYLE, CTA_TEXT i COLOR. Nazwy pól formularza używają prefiksu MPRLINE_. Zmieniaj ustawienia przez formularz.

Rozwiązywanie problemów

  • Jeśli nie widzisz przycisku, sprawdź przełącznik włączenia, zapisany identyfikator, regułę strony i regułę mobilną. Wywołaj interakcję lub poczekaj na uruchomienie awaryjne.
  • Jeśli zmiana zostanie odrzucona, wpisz identyfikator w formacie podanym powyżej. Nie wklejaj pełnego linku kontaktowego.
  • Jeśli widżet nie ma stylów, sprawdź, czy motyw wywołuje displayHeader i ładuje arkusz stylów modułu.
  • Jeśli szablon nigdy się nie pojawia, sprawdź displayBeforeBodyClosingTag i rejestrację hooka 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 jest widoczny, ale cel nie działa, przetestuj zapisany kontakt i obsługę aplikacji zewnętrznych na urządzeniu.

Jeśli brakuje wstępnie wypełnionej wiadomości, użyj identyfikatora konta oficjalnego zaczynającego się od @ i przetestuj przycisk w sklepie na iOS lub Androidzie. Osobiste identyfikatory otwierają kontakt bez wiadomości. Link testowy w panelu administracyjnym sprawdza tylko konto i nie zawiera zapisanej wiadomości.

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

Wyłączanie lub odinstalowanie

Wyłącz Włącz LINE Chat 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. 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

5

Link czatu miał nieprawidłową nazwę dla technologii wspomagających

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.19
Technologie wspomagające mogły odczytywać nieprawidłową lub nieprzetłumaczoną nazwę linku do czatu LINE.

Etykiety w panelu administracyjnym pozostawały po angielsku

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.19
Niektóre etykiety w panelu administracyjnym mogły nie korzystać z dostępnych tłumaczeń.

Stan konfiguracji pozostawał nieaktualny

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.19
Baner konfiguracji mógł nadal pokazywać poprzednie ustawienia po zapisaniu.

Panel administracyjny mógł się nie otwierać

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.14
Panel administracyjny modułu mógł przestać działać z błędem, gdy brakowało wymaganego komponentu zgodności.

Istniejące ustawienia czatu były odczytywane nieprawidłowo

RozwiązaneZaktualizowano:
Naprawiono w: 1.1.13
Istniejąca konfiguracja LINE mogła być ignorowana po zmianie sposobu przechowywania ustawień przez moduł.

Zgłoszenia funkcji

4

Zaimplementowane

Pływający przycisk czatu LINE

Zaimplementowane
Wybieraj wygląd, pozycję i opóźnienie wyświetlania przycisku czatu.

Wstępnie wypełnione wiadomości LINE

Zaimplementowane
Ustaw wiadomość początkową, która może zawierać adres bieżącej strony.

Aktualizacje jednym kliknięciem

Zaimplementowane
Aktualizuj moduł na jego stronie administracyjnej.

Teksty czatu według języka

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

Dziennik zmian

v1.1.132026-09-23

  • 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-13

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • AddedLINE Official Account deep link support for one-tap mobile chat initiation
  • Improvedbutton positioning with configurable corner (bottom-left/right) and offset
  • Fixedbutton not rendering when front-office cache was enabled without module asset exclusion
  • Addedcustom pre-message text to pre-fill the LINE chat compose box

v1.1.02025-06-25

  • Addedanimated bounce effect on the LINE chat button to draw visitor attention
  • Improvedmobile UX: button scales appropriately for touch targets
  • FixedLINE button overlapping with other chat widgets when multiple integrations active
  • Addedz-index configuration to control stacking order with other floating elements

v1.0.02025-04-29

  • Initialrelease: LINE Chat floating button integration for PrestaShop
  • InitialLINE ID or LINE Official Account URL configuration
  • InitialConfigurable button label, icon, and background colour
  • InitialPage-level display rules: show only on product pages, or sitewide

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