LiveChat Integration: setup and help

Quick start

  1. Upload and install the mprlivechatintegration ZIP in Modules > Module Manager.
  2. Click Configure.
  3. Copy only the License ID value from your LiveChat installation script.
  4. In LiveChat Configuration, set License ID to your account value and leave Enable LiveChat set to Yes.
  5. Choose Pass Customer Data, leave Show on Pages at All Pages, and keep Fallback Delay (seconds) at 0.
  6. Click Save. Open an allowed storefront page and scroll or click, or wait 10 seconds.
  7. Check that the LiveChat widget loads. Send a test conversation and confirm it arrives in your LiveChat account.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

Setup manual

Installation and first configuration

On older PrestaShop versions, use the equivalent module installation page. Open this module through Configure whenever you need to return to its settings.

LiveChat Configuration

Setting Default What you do
Enable LiveChat Yes Turn off to stop storefront script output while retaining the connection settings.
License ID Empty Enter 3-32 digits from window.__lc.license. Do not paste the script.
Group ID Empty Optionally enter 1-32 digits to set window.__lc.group. Leave empty for the account’s default routing.
Pass Customer Data Yes Send the logged-in customer’s full name and email. Turn off if you do not want this identification.
Show on Mobile Yes Allow the widget for visitors detected as mobile by PrestaShop. Turn off to hide it on those devices.
Fallback Delay (seconds) 0 Load on the first scroll, click, touch, or key press. A positive value sets the maximum passive wait in seconds. 0 uses a 10-second fallback.
Show on Pages all Choose All Pages, Product Pages Only, Category Pages Only, or Checkout Pages Only.

Show on Pages offers All Pages, Product Pages Only, Category Pages Only, and Checkout Pages Only. Checkout matches cart, order, order-opc, orderopc, and checkout. Show on Mobile uses PrestaShop’s device detection. Fallback Delay (seconds) is the passive maximum wait, not a delay added after interaction.

Changed connection values are validated before settings are saved. Invalid changes preserve the previous configuration. The storefront guard requires a non-empty value; it does not repeat format validation for legacy stored values.

Copy the number assigned to window.__lc.license in your LiveChat widget installation code. A checkout-only example uses License ID 12345678, Show on Pages Checkout Pages Only, Show on Mobile No, and Fallback Delay (seconds) 5. A first interaction still starts loading before the five-second fallback. For a specific team, enter Group ID 2.

Storefront behavior and verification

Your theme must call displayBeforeBodyClosingTag. The module renders only when enabled, the connection value is non-empty, and the mobile and page rules allow it. The shared loader holds the widget until scroll, click, touch, key press, or the fallback timer. JavaScript is required.

The widget loads https://cdn.livechatinc.com/tracking.js. It sets window.__lc.license and optionally window.__lc.group. When customer identification is enabled, it sets window.__lc.visitor with name and email. Visitors without JavaScript do not see the fallback chat link.

Test once as a guest and once as a logged-in customer. With Pass Customer Data enabled, verify the logged-in name and email in LiveChat. This option does not send cart contents, order details, or guest identity. Configure widget appearance, agents, availability, greetings, automations, and reports in LiveChat. You need an account with the provider; account billing and service availability are outside the module.

Theme customization and troubleshooting

For a theme-level template change, use:

themes/your-theme/modules/mprlivechatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
  • If no widget appears, check the enable switch, connection value, page rule, mobile rule, and theme hook. Trigger an interaction or wait for the fallback.
  • If saving fails, copy only the identifier and use the format listed in the settings table.
  • If a script request fails, inspect the browser network log for a blocked provider URL and check your content security or script blocking setup.
  • If identification is missing, confirm the customer is logged in and Pass Customer Data is enabled.
  • Configure any required consent gating in your shop’s consent integration. This module does not add a consent screen or privacy text.

Use the module’s Integrity page for required-configuration and hook checks. License, Support, and Update are available as maintenance pages.

Disable or uninstall

Turn off Enable LiveChat and save to retain the connection settings. The main form still requires the connection identifier. You can also disable the module from the module list.

Uninstall through the module manager to remove the module configuration and admin menu entries. This does not cancel your provider account or remove its conversation history.

Questions

No questions about this module yet

Ask anything about installation, compatibility or setup. Answers appear here.

Known Issues

4

Saved chat text gains escaped characters

ResolvedUpdated:
Fixed in: 1.1.18
Saving visitor-facing chat text could add unwanted escaped characters. Text is now saved without double escaping.

Translated back-office text

ResolvedUpdated:
Fixed in: 1.1.18
Some back-office text remained in English even when another language was selected. Labels now use the available translations.

Setup notice shows old settings

ResolvedUpdated:
Fixed in: 1.1.18
The setup notice could continue reporting an issue immediately after valid settings were saved. It now reflects the settings just saved.

Back-office pages failing to open

ResolvedUpdated:
Fixed in: 1.1.14
Opening the module configuration could fail with an error instead of showing the settings. The settings pages now open correctly.

Feature Requests

5

Implemented

LiveChat setup checks

Implemented
See which required connection settings must be completed before the chat widget can appear.

Multilingual administration

Implemented
Use translated LiveChat settings in German, French, Spanish, Italian and Polish.

Licence management

Implemented
View and manage the module licence from a dedicated back-office page.

One-click module updates

Implemented
Check for and install module updates from the back office.

Chat text per language

Implemented
Edit the visitor-facing text offered by the integration separately for each shop language using the language selector.

Changelog

v1.1.132026-10-02

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

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-16

  • Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
  • Addedcart data push to LiveChat agent panel: item list, quantities, and cart total
  • Improvedcustomer data forwarding: order count and lifetime value synced on login
  • Fixedwidget not loading on pages served through Nginx FastCGI cache
  • Addedticketing escalation integration: open a ticket from within the chat without leaving LiveChat

v1.1.02025-06-17

  • Addedrouting rules: route chats to different agent groups by product category or page type
  • Improvedanalytics integration: LiveChat reports synced with Google Analytics 4 via dataLayer
  • Fixedduplicate chat session opened after customer navigated back using browser history
  • Addedconfigurable greeting message per page type for proactive engagement

v1.0.02025-04-16

  • Initialrelease: LiveChat widget integration for PrestaShop
  • InitialLicense ID configuration with automatic widget injection on all front-office pages
  • InitialCustomer identification: passes name and email to agent panel for recognised customers
  • InitialPage exclusion list configurable from the module admin panel

Demo

Test the full module before you buy

Buy a licence later and keep your settings.

  • Your 30-day demo Test it on your own shop for 30 days from the first install.
  • Ready demo shop Explore a ready demo shop in your browser.
  • No registration No account, email or store domain needed.
Launch demo shop

By downloading, you accept the demo terms and privacy policy.

By opening this demo you accept the demo terms and the privacy policy.

Loading...
Back to top