LiveHelp App Installation
profitCode Software  -  Scripting the future of e-commerce!

profitCode Software
Leading PayPal IPN
enabled shopping cart
solution provider

 
 
 
    : Home | Documentation | LiveHelp App  [ Customer Service Chat ] | Installation
 

 

Live Help App  Installation

 - (*) Requirements:
The web portion (/help folder) of LiveHelp App runs on any web-server that has at least PHP 4.1.x and MySQL 3.23.49 or higher installed.

In order to run LiveHelp App on your computer, you must have Java installed.
LiveHelp App will work with both the Microsoft Java Version and Suns java version.
You can test if you have java installed or find download links here.

 - Install:
Note: The LiveHelp application will not work properly until you have created the mysql table and uploaded the /help folder to your website. If you are using our shop, then the table is already included. You can skip step 1.
Listing of files and folders:
LiveHelpApp/   (main software folder)
LiveHelpApp/help   (Website folder - Ex: http://www.blabla.com/help/login.php)
LiveHelpApp/LiveHelp.exe   (LiveHelp.exe - will only work with Windows).
LiveHelpApp/liveHelpApp.jar   (executable Jar file - will work with Suns Java).
 
1. Upload the table to your database using the mysql.txt  found in your help folder. If you do not have a database, you need to create one.
2. Upload the /help folder to you website. This is the only folder you need to upload.
Change the following variables in helpheader.php:
$host="localhost"; //----this is the name of your host. Usually, leave as is. 
$dbase="shop"; //----this is the name of your database
$dbuser="myDBusername"; // database username
$dbpass="myDBpassword"; // database access password
$shophelpnick = "HelpNick"; // Your Help Nick. No blank spaces
$adminuser = "AdminUsername"; // LiveHelp admin username. 
$adminpass = "AdminPassword"; // LiveHelp admin password.
$timeoutseconds = 300; // Timeout value in seconds.
$timestamp = time();
$timeout = $timestamp - $timeoutseconds;
$refrate = "10"; // Time in seconds to refresh the chat box (index.php)
$emailinfo = "help@profitcode.net"; // Where the support email is sent
$helpemailsubject = "profitCode LiveHelp Support"; // Subject of email
$welcomemessg = "Please wait. Someone will be right with you"; // Log-in Welcome.
3. Launch the LiveHelp App on your computer:
LiveHelp.exe   -   MS Java Virtual Machine - Just Double Click:
liveHelpApp.jar   -   sunRun.bat  -  Suns Java Version
Click the Prefs Button on the LiveHelp App and the above preferneces window should pop up. Edit:
Help Folder Url:
  (Url to the help folder with ending / .)
Help Nick: (Same as in your helpheader.php - no white spaces - case sensative.)
Admin Username:   (This must be the same as the helpheader.php) 
Admin Password: ( This must be the same as the helpheader.php) 
4. Open web-page http://www.myserver.com/help/adminlogin.php
username: AdminUsername
password: AdminPassword
It should set your LiveHelp admin cookie and redirect you to the demo.php.
5. Click Login button in your LiveHelp App. You will see the Ping Delay label go green.
The Ping Delay label will turn green every time LiveHelp pings your helpping.php and return to normal when finished. 
 
 - Testing the LiveHelp:
Click the Check button in LiveHelp App before you open up the web help pop-up window (as found in the Demo Link in your web page demo.php). Actually, you should only be using that pop-up window for testing purposes.
Now you can go back to the demo.php page and click the LiveHelp pop-up link (view sample javascript). This demo.php is just to give you an idea of how to include the javascript pop up on your site.  Log in as any user with a test question.
After the ping delay in the LiveHelp App program, it should warn you that someone is looking for help. It will play the "Yahooooo!" sound, and pop up an alert window. You can now test chat between the pop-up and the window opened up with the check button.
To answer the test user, just type in your answer and click the A link next to his name.
 
 - NOTES:
LiveHelp App parses myserver.com/help/helpping.php
DO NOT ALTER helpping.php or the php script in any of the files or LiveHelp will not function.
You can modify the delay time (seconds),  LiveHelp  pings using the PingDelay dropdown menu in LiveHelp App.

We HIGHLY suggest that you do not set the Delay Ping for 15 seconds. You will be wasting bandwith and cpu. Besides slowing down your internet connection. We suggest a setting of 45-90 seconds. The LiveHelp App will automatically change and use the Ping Delay selected.

The help/thankyou.php pops-up and deletes the user from the database when the user leaves the chat.

*We have found that Suns latest JVM works about 50% smoother with sockets than Microsofts JVM.