LiveChat Integration: setup and help
Quick start
- Upload and install the
mprlivechatintegrationZIP in Modules > Module Manager. - Click Configure.
- Copy only the License ID value from your LiveChat installation script.
- In LiveChat Configuration, set License ID to your account value and leave Enable LiveChat set to Yes.
- Choose Pass Customer Data, leave Show on Pages at All Pages, and keep Fallback Delay (seconds) at
0. - Click Save. Open an allowed storefront page and scroll or click, or wait 10 seconds.
- 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
Translated back-office text
Setup notice shows old settings
Back-office pages failing to open
Feature Requests
5
Implemented
LiveChat setup checks
Multilingual administration
Licence management
One-click module updates
Chat text per language
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.
By downloading, you accept the demo terms and privacy policy.
By opening this demo you accept the demo terms and the privacy policy.