Installation and configuration of the Jfusion Kayako plugin

How to install
Installing the Kayako plugin
1. Unzip the file kayako_plugin_unzip_me_first_x.x.x-xxx.zip. After unzipping you have two files: kayako_plugin x.x.x-xxx.zip (the jfusion kayako plugin) and kayako_jfusion_loginshare.zip (additional files, see below. 2. After installation of Jfusion (www.jfusion.org) login to the Joomla backend and go to Components>Jfusion> plugin manager. 3. Scroll down, choose a method to install and install the plugin kayako_plugin x.x.x-xxx.zip (do not unzip before installing!) 4. You may get some error messages in the plugin display screen. Temporarily set the directory <Joomla root>/administrator/components/com_jfusion/plugins/kayako to 777. Now access the file unlock_kayako_plugin.php with your browser. You should get message that the plugin is unlocked. You now have a 14 day test version. To install the paid license see Unlocking the paid license later in this document. The test version has no limitations except for the time limit. Make sure you either update to a paid license within this 14 day limit or delete the plugin, other wise access to Joomla will be impossible!

Setting up the Kayako plugin

1. After installation of the Kayako plugin login to the backend if you have not done already and go to Components>Jfusion> configuration. 2. Click on the wizard icon in front of kayako.

3. You must now enter the root path to your Kayako site on your server. For your convenience the Joomla root path is displayed. Change it to the Kayako root path and click on next. 4. If all is well you get a message that a valid configuration file is found

5. If this is not the case the root path you entered in step 2 is incorrect. Go back and try again. 6. A pretty large configuration form is now presented to you. Dont worry, most defaults will be correct!

7. Carefully check the full URL to Integrated Software field and change it when the URL is not correct. This is crucial for a flawless performance of the plugin. 8. You have already set the full path to the integrated software (Kayako) so leave this entry alone.

9. Check the database settings in this set of six fields. Unless we have a software error or a wrong configuration of Kayako these settings should be correct.

10. You can leave most of these fields to their defaults. 11. Set Cookie Path to the path of your software (like /support if Kayako is installed in a subdirectory support of your web. 12. The following settings should be left alone. If the dual login feature does not work, refer to the document How to set up the cURL options in Jfusion. It can be downloaded from our site http://www.mijnbreincoach.nl/software 13. Save the settings and return to this screen. Now set the default user group that is going to be used when Jfusion creates a user in Kayako. The reason for this extra step is that we can not access Kayakos database before you confirmed the database settings. From version 1.1.2 Jfusion (and the Kayako plugin) can sync user groups between different software. Leave the Usergroup mode at simple for now.

14.

The advanced mode gives you more options, but you can easily lock yourself out.

15. Save the settings again. The setup of the Jfusion Kayako plugin is now completed. 16. We need to configure a few parameters in Kayako.

Special configuration issues

1. In the file <kayako root>/config/config.php change the line:
$_SWIFT["disablesessionipcheck"] = false;

to
$_SWIFT["disablesessionipcheck"] = true;

2. In Kayakos admin: panel/settings/security a. Set the default session inactivity expiration to the desired value (These are seconds, 216000, the default, this is 60 minutes) b. Set Cookie domain to .yourdomain.xxx (note the dot in front of the domain) c. Set cookiepath to the path of your software (like /support if Kayako is installed in a subdirectory support of your website. 3. Make sure that these security values are exactly the same as the ones you have set in the Kayako plugin configuration panel. Note that Kayako uses seconds for inactivity and Jfusion uses minutes. 4. To disable Kayakos user registration unpack the files in kayako_jfusion_loginshare.zip into the loginshare directory (<kayako root>/includes/LoginShare) . Note that we do not use Kayakos loginshare system to login. The way Jfusion handles this is much more elegant. We only use loginshare to remove the registration and lost password links in Kayako if Kayako is used as a Jfuion slave. After you have unzipped the file in the LoginShare directory enter Kayako as administrator. Go to templates/manage groups.

Choose your default group and click edit. Find the row LoginShare and set this parameter to jfusion_slave:

Note: Kayakos template system should be setup correctly. Especially the settings for the default client template in Kayakos configuration file (<kayako root/config/config.php should be correct:
/** * DEFAULT CLIENT AREA THEME */ $_SWIFT["clienttheme"] = "default";

Unlocking a paid license

Unzip the received license file to a writable directory on your server that can be accessed with a browse. Now access the file unlock_kayako_plugin.php with your browser. You should get message that the plugin is unlocked. Copy the file kayako_plugin.php to the JFusion kayako plugin directory:

Support
JFusion An installation video, documentation and web based support for Jfusion is available on the Jfusion website. Kayako plugin Support is available via email: admin@mijnbreincoach.nl or in the support forums on our website: www.mijnbreincoach.nl/main/breinboard