Install Guide

Tutorial how to setup Live Helper Chat. You can also use available snapshot on DigitalOcean


If you are running wordpress site it's 99.9% chance Live Helper Chat will work just fine.

  • Minimum PHP 5.4
  • Mysql/MariaDB
  • Apache/Nginx

Folders permissions

  • After you gave permission to write to cache folder. You should see the following window. If you see strange error instead of install make sure that
    • Your browser is pointing to index.php/site_admin/install/install URL
    • You gave recursive write permission to cache folder.
chmod -R 777 cache/

After that you should see something like his

Now just give permission to write to required folders/files

chmod 777 settings/
chmod -R 777 var/storage
chmod -R 777 var/userphoto
chmod -R 777 var/storageform
chmod -R 777 var/storageadmintheme
chmod -R 777 var/botphoto
chmod -R 777 var/bottrphoto
chmod -R 777 var/storageinvitation
chmod -R 777 var/storagedocshare
chmod -R 777 var/storagetheme
chmod -R 777 var/tmpfiles

After that all items should be green.

Database settings

On next screen you should see similar window. Database has to be precreated.

Application initial settings

These settings you can fill up according to your needs.

Install completed

Logging to application

After clicking Login here you should be presented with login window.

Install url is always index.php/site_admin/user/login

Dashboard page

This is the main application window.

Generating embed code

Now click on Settings icon ​ on top menu. You should see this window.

Navigate to

Embed code -> Widget embed code (new)

You should see window like this

To have proactive enabled check Check for operator invitation messages

Embed code should be similar to this. If you copy this code change to your install path.

<script>var LHC_API = LHC_API||{};
LHC_API.args = {mode:'widget',lhc_base_url:'//',wheight:450,wwidth:350,pheight:520,pwidth:500,leaveamessage:true,proactive:true};
(function() {
var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;
var date = new Date();po.src = '//'+(""+date.getFullYear() + date.getMonth() + date.getDate());
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);

For more information and trouble shooting see integration article.

Proactive invitation setup

Navigate to

System configuration -> Live help configuration -> Pro active chat invitations

Here is demo configuration which we have on Some things it does:

  • Message to user is send after he spends 20 seconds on page or have more than 2 pageviews.
  • We show random profile from online operators
  • Also we have to delayed messages there. Delayed messages can be also configured in autor responder sections.
  • Also we have there long auto delayed message 40 seconds. If during that period no one accepts a chat message is shown that all operators are busy.

You can see proactive invitation setup on our demo installation.

And here is instant auto response message.

Here goes automatic auto response message.

Further reading

My widget does not load?

Try to add this in your .htaccess file in root folder lhc_web. If this folder does not exists just place .htaccess in the same folder where index.php file exists. It has to be placed in Live Helper Chat folder not a website.

AddType application/wasm .wasm
<Files ~ "\.(gif|jpe?g?|png|bmp|swf|css|js|svg|otf|eot|ttf|woff|woff2|swf|mp3|ogg|wasm|wav|pdf|ico|txt)$">
Header always Set Access-Control-Allow-Origin "*"
Header always Set Access-Control-Allow-Methods: "GET, POST, OPTIONS, PUT, DELETE"
Header always Set Access-Control-Allow-Headers: "Origin, X-Requested-With, Content-Type, Accept, API-Key, Authorization"

Install from command line

It's also possible to install from command line.

Copy install-cli.php script to root folder (lhc_web if you pulled from github)

cp cli/install-cli.php install-cli.php

Copy default example.settings.ini to settings.ini. Don't forget to modify them.

cp cli/example.settings.ini cli/settings.ini

Install Live Helper Chat

php install-cli.php cli/settings.ini

Installation under sub-folder

If you are running wordpress site and have nice URL, you might need to allow access to Live Helper Chat subfolder. .htacess could look like.

RewriteEngine On
# Previous rules
RewriteRule ^lhc_web/.*$ - [L]
# Afterward rules

How to login?

In order to login point your browser to directory where application is installed. URL address should look like http://<your_domain>/index.php/site_admin/

Last updated on by Remigijus Kiminas