Integrazione LINE Chat: configurazione e aiuto

Avvio rapido

  1. In Moduli > "Module Manager", scegli "Upload a module" e installa lo ZIP mprlinechatintegration.
  2. Fai clic su "Configure".
  3. In Connessione LINE, inserisci ID LINE, ad esempio @myshop.
  4. Lascia Attiva LINE Chat su Sì e scegli l’angolo in Aspetto pulsante > Posizione.
  5. In Comportamento visualizzazione, lascia Mostra nelle pagine su Tutte le pagine e Fallback Delay (seconds) a 0 per la prima prova.
  6. Fai clic su Salva. Apri una pagina consentita del negozio con JavaScript attivo.
  7. Scorri o fai clic sulla pagina, oppure attendi 10 secondi. Verifica che compaia il pulsante e controlla la destinazione: @myshop. Fai clic su un dispositivo in grado di aprire LINE e conferma il contatto corretto.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

Manuale di configurazione

Installazione e prima configurazione

Nelle versioni precedenti di PrestaShop, usa la pagina equivalente per l’installazione dei moduli. Apri questo modulo tramite "Configure" ogni volta che vuoi tornare alle impostazioni.

Connessione LINE

Impostazione Valore predefinito Cosa fai
Attiva LINE Chat Sì Disattiva per interrompere la visualizzazione nel negozio mantenendo la configurazione salvata.
ID LINE Vuoto Inserisci 2-64 lettere, numeri, punti, trattini o trattini bassi, con un eventuale @ iniziale.
Messaggio precompilato Vuoto Per gli ID di account ufficiali che iniziano con @, precompila un messaggio su iOS e Android. Usa {url} per l’URL corrente del negozio. Gli ID personali non supportano messaggi precompilati.

Dopo il salvataggio di un identificatore, la pagina di configurazione offre un link all’account LINE. Aprilo per verificare la destinazione. Il modulo controlla il formato degli identificatori modificati al salvataggio, senza verificare se l’account esiste. Una modifica rifiutata mantiene la configurazione precedente; gli identificatori invariati vengono mantenuti senza un nuovo controllo del formato.

Aspetto pulsante

Impostazione Valore predefinito Cosa fai
Posizione bottom-right Scegli In basso a destra o In basso a sinistra per evitare altri controlli flottanti.
Stile pulsante icon Scegli Icona flottante per il pulsante rotondo o Barra con testo per un pulsante di testo.
Testo pulsante Chat on LINE Imposta l’etichetta mostrata in modalità barra. Il template la usa anche come etichetta accessibile per un pulsante a icona.
Colore del pulsante #06C755 Imposta il colore di sfondo con il selettore colori.
Dimensione del pulsante (px) 60 Modifica il diametro dell’icona rotonda. La modalità barra usa una propria spaziatura interna.
Margine dal bordo (px) 20 Imposta la distanza inferiore e laterale in pixel.
Mostra tooltip Sì Disattiva il tooltip al passaggio del mouse se non ti serve.
Testo tooltip Chat with us on LINE Scrivi il messaggio al passaggio del mouse.
Animazione pulse Scegli pulse, bounce o none. Scegli none per interrompere l’animazione ripetuta.

Puoi tradurre Testo pulsante e Testo tooltip usando i controlli della lingua del form. Una traduzione vuota usa la lingua predefinita. Lo stesso fallback linguistico si applica a Messaggio precompilato. Usa Salva dopo le modifiche.

Comportamento visualizzazione

Impostazione Valore predefinito Cosa fai
Mostra su mobile Sì Consenti il pulsante per i visitatori rilevati come mobili da PrestaShop. Disattiva per nasconderlo su quei dispositivi.
Fallback Delay (seconds) 0 Carica al primo scorrimento, clic, tocco o pressione di un tasto. Un valore positivo imposta l’attesa passiva massima in secondi. 0 usa un fallback di 10 secondi.
Mostra nelle pagine all Scegli Tutte le pagine, Solo pagine prodotto, Solo pagine di categoria o Solo pagine di checkout.

Solo pagine di checkout corrisponde a cart, order, order-opc, orderopc e checkout. Altri moduli di checkout possono usare nomi di controller diversi. L’attesa di fallback inizia sulla pagina. Non è un ritardo aggiuntivo dopo un’interazione.

Comportamento nel negozio e verifica

Il tema deve eseguire displayHeader per il foglio di stile e displayBeforeBodyClosingTag per il widget. Il modulo controlla l’interruttore di abilitazione, un identificatore non vuoto e le regole per dispositivi mobili e pagine prima di restituire l’output.

Dopo la prima interazione o il fallback, compare un pulsante fisso nell’angolo scelto. Il link si apre in una nuova scheda con noopener noreferrer. Per l’account ufficiale @myshop senza messaggio, la destinazione è:

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

Usa un ID LINE personale o un ID di account ufficiale, come myshop, @myshop, shop.name, shop-name o shop_name. L’ID personale myshop rimanda a https://line.me/ti/p/myshop. Per un account ufficiale con un messaggio salvato, il modulo aggiunge /? e il messaggio codificato per un URL all’URL dell’account ufficiale, sostituendo {url} con l’URL della pagina corrente. Gestisci le conversazioni in LINE. Il modulo non genera codici QR, non invia notifiche d’ordine e non fornisce una casella di posta.

Verifica una pagina consentita e una esclusa se limiti i tipi di pagina. Verifica la visibilità mobile su un dispositivo reale. Se usi più lingue, controlla il testo del pulsante e il tooltip tradotti.

Esempi di configurazione e modifiche al tema

Per un pulsante di testo sulle pagine prodotto, imposta Stile pulsante su Barra con testo, Testo pulsante su Ask us on LINE, Mostra nelle pagine su Solo pagine prodotto e Animazione su none. Puoi scegliere In basso a sinistra quando un altro widget usa l’angolo destro.

Se devi spostare il widget sopra un altro controllo fisso, aggiungi una regola al foglio di stile del tema:

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

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

Per un override del template nel tema, usa:

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

Il template riceve $mprline con chat_url, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation e delay. Il valore preparato chat_url include il messaggio per gli account ufficiali; i campi separati line_id e message non vengono forniti. Mantieni le modifiche nel tema per evitare che un aggiornamento del modulo le sovrascriva.

Le impostazioni usano la tabella condivisa mpr_config con il prefisso del database configurato, il nome del modulo mprlinechatintegration e chiavi brevi come LINE_ID, POSITION, STYLE, CTA_TEXT e COLOR. I nomi dei campi del modulo usano il prefisso MPRLINE_. Modifica le impostazioni tramite il modulo.

Risoluzione dei problemi

  • Se non compare alcun pulsante, controlla l’interruttore di abilitazione, l’identificatore salvato e le regole di pagina e mobile. Avvia un’interazione o attendi il fallback.
  • Se una modifica viene rifiutata, inserisci l’identificatore nel formato indicato sopra. Non incollare un link di contatto completo.
  • Se il widget non ha stile, verifica che il tema richiami displayHeader e carichi il foglio di stile del modulo.
  • Se il template non appare mai, controlla displayBeforeBodyClosingTag e la registrazione dell’hook del modulo nel back office.
  • Se il pulsante si sovrappone a un altro controllo, modifica Posizione o Margine dal bordo (px).
  • Se il pulsante appare ma la destinazione non funziona, verifica il contatto salvato e il gestore delle app esterne del dispositivo.

Se manca il messaggio precompilato, usa un ID di account ufficiale che inizi con @ e prova il pulsante del negozio su iOS o Android. Gli ID personali aprono il contatto senza messaggio. Il link di prova nel back office controlla solo l’account e non include il messaggio salvato.

Usa la pagina "Integrity" del modulo per la diagnostica della configurazione e degli hook. Licenza, Assistenza e Aggiorna sono pagine di manutenzione anziché impostazioni dell’aspetto nel negozio.

Disattivazione o disinstallazione

Disattiva Attiva LINE Chat e salva per mantenere la configurazione. Il form principale richiede comunque un identificatore non vuoto al salvataggio. Puoi anche disattivare il modulo dall’elenco dei moduli.

Usa "Uninstall" nel gestore moduli per rimuovere la configurazione del modulo e le relative voci del menu di amministrazione. Il tuo account di messaggistica esterno non viene eliminato.

Domande

Ancora nessuna domanda su questo modulo

Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.

Problemi noti

5

Il link della chat aveva un nome accessibile errato

RisoltoAggiornato:
Risolto nella versione: 1.1.19
Le tecnologie assistive potevano annunciare un nome errato o non tradotto per il link della chat LINE.

Le etichette di amministrazione restavano in inglese

RisoltoAggiornato:
Risolto nella versione: 1.1.19
Alcune etichette di amministrazione potevano ignorare le traduzioni disponibili.

Lo stato della configurazione restava obsoleto

RisoltoAggiornato:
Risolto nella versione: 1.1.19
Il banner di configurazione poteva continuare a mostrare le impostazioni precedenti dopo il salvataggio.

L'amministrazione poteva non aprirsi

RisoltoAggiornato:
Risolto nella versione: 1.1.14
L'amministrazione del modulo poteva interrompersi con un errore quando mancava un componente di compatibilità richiesto.

Le impostazioni della chat esistenti venivano lette male

RisoltoAggiornato:
Risolto nella versione: 1.1.13
La configurazione LINE esistente poteva essere ignorata dopo la modifica del modo in cui il modulo memorizzava le impostazioni.

Richieste funzionalità

4

Implementato

Pulsante flottante della chat LINE

Implementato
Scegli l'aspetto, la posizione e il ritardo di visualizzazione del pulsante della chat.

Messaggi LINE precompilati

Implementato
Imposta un messaggio iniziale che può includere l'indirizzo della pagina corrente.

Aggiornamenti con un clic

Implementato
Aggiorna il modulo dalla sua pagina di amministrazione.

Testi della chat per lingua

Implementato
Configura i testi della chat visibili ai visitatori separatamente per ogni lingua del negozio.

Registro modifiche

v1.1.132026-09-23

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

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

Prova il modulo completo prima di acquistare

Acquista la licenza in seguito e mantieni le tue impostazioni.

  • La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
  • Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
  • Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su