Integracja LINE Chat: konfiguracja i pomoc
Szybki start
- W Moduły > "Module Manager" wybierz "Upload a module" i zainstaluj plik ZIP
mprlinechatintegration. - Kliknij "Configure".
- W sekcji Połączenie LINE wpisz ID LINE, na przykład
@myshop. - Pozostaw Włącz LINE Chat ustawione na Tak i wybierz róg w Wygląd przycisku > Pozycja.
- W sekcji Zachowanie wyświetlania pozostaw Pokaż na stronach na Wszystkie strony i Fallback Delay (seconds) na
0na potrzeby pierwszego testu. - Kliknij Zapisz. Otwórz dozwoloną stronę sklepu z włączonym JavaScript.
- 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.
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
displayHeaderi ładuje arkusz stylów modułu. - Jeśli szablon nigdy się nie pojawia, sprawdź
displayBeforeBodyClosingTagi 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
Etykiety w panelu administracyjnym pozostawały po angielsku
Stan konfiguracji pozostawał nieaktualny
Panel administracyjny mógł się nie otwierać
Istniejące ustawienia czatu były odczytywane nieprawidłowo
Zgłoszenia funkcji
4
Zaimplementowane
Pływający przycisk czatu LINE
Wstępnie wypełnione wiadomości LINE
Aktualizacje jednym kliknięciem
Teksty czatu według języka
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.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.