This guide describes the installation of KoolSuite. The procedure is the same for both versions: Open Source and Professional.
Requirements
KoolSuite is a theme and a set of addons for SuiteCRM. To install and use koolSuite you need to have SuiteCRM installed.
There are no requirements other than those necessary for the correct functioning of SuiteCRM.
To install SuiteCRM you can follow the SuiteCRM installation guide https://docs.suitecrm.com/admin/installation-guide/downloading-installing/
KoolSuite is available for SuiteCRM versions 7.15 or higher.
How to upgrade SuiteCRM
If you have a previous version of SuiteCRM you can upgrade by following the instructions on the SuiteCRM website.
If you have problems installing SuiteCRM or ugrade, please contact us.
We will be happy to assist you in this procedure.
KoolSuite Download
Download KoolSuite from www.koolsuite.it/downloads. If you have signed up for the Professional license, log in to your reserved area.
To activate the Professional license you need to specify the domain of your crm. Enter the domain in the appropriate field and confirm. The domain must be entered without the http: // or htpps: // protocol.
In both KoolSuite licenses, download the package containing the theme and the package containing the addons.
Boostrap 4 and JQuery 3.5
KoolSuite uses the BootStrap 4 engine and JQuery 3.5.
The installation of KoolSuite replaces the bootstrap and jquery files of SuiteCRm with those of Bootstrap 4 and JQuery 3.5. The original files are not overwritten and by uninstalling KoolSuite they will be put back into use.
If you have made customizations by writing code that uses Boostrap 3 standards your customizations should also work with Bootstrap 4. We are available for any rendering problems of your customizations.
Files overwritten during the installation of KoolSuite
KoolSuite is a theme for SuiteCRM, follows the guidelines for creating SuiteCRM themes and is installed in the kooltheme folder under the suitecrm themes folder. Most of the installed files are placed in this folder.
KoolSuite does not overwrite any SuiteCRM files except the following files:
Folder: / modules / Calendar
Four files are overwritten in this folder to introduce additional KoolSuite calendar features:
- Calendar.php
- CalendarActivity.php
- CalendarUtils.php
- Controller.php
Folder: / jssource
- JSGroupings.php is overwritten to make Bootstrap 4 and Jquery available
There are no other files that are overwritten
Disable ajax loading
KoolSuite does not use ajax mode for loading pages. The ajax functionality is therefore disabled during installation.
Installation
Step 1
Log in as an administrator in SuiteCRM.
In the administrative section of SuiteCRM select the Module Loader section.
The modules already installed are shown. At the bottom select Upload File to upload the package containing the theme.
Step 2 Upload the theme
Upload the Theme as the first package to install.
The theme package is approximately 6 Mb in size. If you have problems uploading you probably need to increase the maximum file upload size to your server.
Follow the procedure for loading the Theme package.
At the end the theme will not be listed among the loaded modules. This is a SuiteCRM feature that shows only the modules not the loaded themes in the list.
Step 3 upload the Addons Package
Continue by uploading the package containing the KoolSUite Addons
At the end you will see the Addons package among the loaded modules.
Return to the SuiteCRM administrative panel
Step 4 activate KoolSuite theme
Select the Themes item
You will be shown the list of installed themes. Typically you will find the standard SuiteCRM theme called Suite P and the KoolSuite theme.
Activate the KoolSuite theme (checkbox next to KoolSuite) and select it as the Default theme.
Deselect the Suite P theme checkbox by disabling it.
Save with the Save button
It is advisable to carry out the QuickRepair procedure under Rapair in the SuiteCRM administrative panel.
The installation is complete and the theme is active you can browse the crm and start discovering the features of KoolSuite.