LINE Chat Integration: setup and help
Quick start
- In Modules > Module Manager, choose Upload a module and install the
mprlinechatintegrationZIP. - Click Configure.
- In LINE Connection, enter LINE ID, for example
@myshop. - Leave Enable LINE Chat set to Yes and choose the corner in Button Appearance > Position.
- In Display Behavior, leave Show on Pages at All Pages and Fallback Delay (seconds) at
0for the first test. - Click Save. Open an allowed storefront page with JavaScript enabled.
- Scroll or click the page, or wait 10 seconds. Check that the button appears and inspect its destination:
@myshop. Click it on a device that can open LINE and confirm the correct contact.
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.
LINE Connection
| Setting | Default | What you do |
|---|---|---|
| Enable LINE Chat | Yes | Turn off to stop storefront output while retaining the saved configuration. |
| LINE ID | Empty | Enter 2-64 letters, numbers, dots, dashes, or underscores, with an optional leading @. |
| Pre-filled Message | Empty | For Official Account IDs starting with @, prefill a chat on iOS and Android. Use {url} for the current storefront URL. Personal IDs do not support prefilled messages. |
After you save an identifier, the configuration page provides a link to open the LINE account. Open it to check the destination. The module checks the format of changed identifiers when you save, without checking whether the account exists. A rejected edit keeps the previous configuration; unchanged identifiers are kept without another format check.
Display Behavior
| Setting | Default | What you do |
|---|---|---|
| Show on Mobile | Yes | Allow the button 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. |
Checkout Pages Only matches cart, order, order-opc, orderopc, and checkout. Other checkout modules can use different controller names. The fallback wait starts on the page. It is not an additional delay after an interaction.
Storefront behavior and verification
Your theme must render displayHeader for the stylesheet and displayBeforeBodyClosingTag for the widget. The module checks the enable switch, a non-empty identifier, the mobile rule, and the page rule before returning output.
After the first interaction or fallback, you see a fixed button in the selected corner. Its link opens in a new tab with noopener noreferrer. For Official Account @myshop without a message, the destination is:
https://line.me/R/oaMessage/%40myshop
Use a personal LINE ID or Official Account ID, such as myshop, @myshop, shop.name, shop-name, or shop_name. Personal ID myshop links to https://line.me/ti/p/myshop. For an Official Account with a saved message, the module appends /? and the URL-encoded message to the Official Account URL, replacing {url} with the current page URL. You handle conversations in LINE. The module does not generate QR codes, send order notifications, or provide an inbox.
Test one allowed page and one excluded page if you restrict page types. Test mobile visibility on a real device. If you use multiple languages, check the translated button text and tooltip.
Configuration examples and theme adjustments
For a text button on product pages, set Button Style to Bar with Text, Button Text to Ask us on LINE, Show on Pages to Product Pages Only, and Animation to none. You can choose Bottom Left when another widget uses the right corner.
If you need to move the widget above another fixed control, add a rule to your theme stylesheet:
#mprline-widget.mprline-bottom-right {
bottom: 90px;
right: 24px;
}
#mprline-widget.mprline-bar a span {
font-size: 15px;
}
For a theme template override, use:
themes/your-theme/modules/mprlinechatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
The template receives $mprline with chat_url, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation, and delay. The prepared chat_url includes the message for Official Accounts; separate line_id and message fields are not supplied. Keep changes in your theme so a module update does not overwrite them.
Settings use the shared mpr_config table with the configured database prefix, the module name mprlinechatintegration, and short keys such as LINE_ID, POSITION, STYLE, CTA_TEXT, and COLOR. The form field names use the MPRLINE_ prefix. Change settings through the form.
Troubleshooting
- If you see no button, check the enable switch, saved identifier, page rule, and mobile rule. Trigger an interaction or wait for the fallback.
- If an edit is rejected, enter the identifier format listed above. Do not paste an entire contact link.
- If the widget has no styling, check that your theme calls
displayHeaderand loads the module stylesheet. - If the template never appears, check
displayBeforeBodyClosingTagand the module’s hook registration in the back office. - If the button overlaps another control, change Position or Margin from Edge (px).
- If the button appears but the destination fails, test the saved contact and the device’s external app handler.
If a prefilled message is missing, use an Official Account ID starting with @ and test the storefront button on iOS or Android. Personal IDs open the contact without a message. The back-office test link checks the account only and does not include the saved message.
Use the module’s Integrity page for setup and hook diagnostics. License, Support, and Update are maintenance pages rather than storefront appearance settings.
Disable or uninstall
Turn off Enable LINE Chat and save to retain your configuration. The main form still requires a non-empty identifier when you save. You can also disable the module from the module list.
Use Uninstall in the module manager to remove the module configuration and its admin menu entries. Your external messaging account is not deleted.
Questions
No questions about this module yet
Ask anything about installation, compatibility or setup. Answers appear here.
Known Issues
5
Chat link had the wrong accessible name
Administration labels stayed in English
Setup status stayed out of date
Administration could fail to open
Existing chat settings were not read correctly
Feature Requests
4
Implemented
Floating LINE chat button
Prefilled LINE messages
One-click updates
Chat text by language
Changelog
v1.1.132026-09-23
- 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-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
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.