Perfex - Powerful Open Source CRM

Introduction

Documentation Info

• Created: 02/27/2016
• Last Updated: 05/12/2016
• Created by: MSTdev
• Version 1.6.1
• email: info@perfexcrm.com

Knowledge Base & Support

Website: www.perfexcrm.com

Full Documentation

Support Desk

• PHP 5.4+
• MYSQL 5.1+
• mod_rewrite Apache
• Mcrypt Extension
• MBString Extension
• GD Extension
• MYSQLi Extension
• PDO Extension
• OpenSSL Extension
• IMAP Extension
• Zip Extension
• CURL Extension

In most hosting accounts these extensions are enabled by default. But you should consult with your hosting provider.

Configure database connection

You need to have previously setup database from the cPanel.

Here is a good tutorial how to setup MySQL database in cPanel if you are not familiar with this.

1. Login to cPanel by accessing www.yourdomain.com/cpanel and navigate go MySQL Databases.
2. Create database.
3. Create user and setup your password.
4. Add the user to database by selecting the database and the username.

Make sure you have checked All privileges when adding the user to database.

Upload Files & Install

Upload the files to your hosting folder and navigate to the location where you will install Perfex CRM http://www.domain.com/crm/install

You will need to pass the requirements to install Perfex CRM.

Click Go to files/folders permissions to validate the permissions for files and folders. In case some of them are filled with red color make sure that they are with permission 755.

After you validate the files/folders permission click on Setup Database to validate database credentials.

If any erros found while connecting you will be notified otherwise you should see the credentials screen

Configure credentials and options

• Base URL - Read More
• Email - Admin Login
• Password
• Set system timezone

If you need help installing dont hesitate to open support ticket

Troubleshooting

404 Not Found After Installation

WAMP

Even if you are trying to install Perfex on WAMP you must meet all the requirements.
WAMP by default comes with mod_rewrite disabled.

To Enable .htaccess in WAMP Server use the following steps
STEP  1:  click on Wampserver and select apache->httpd.conf

STEP  2: Find and replace the following text
Find      #LoadModule rewrite_module modules/mod_rewrite.so
Replace    LoadModule rewrite_module modules/mod_rewrite.so

STEP  3: Restart Wamp Server

XAMP

Perfex CRM is not using any online resources except the business news which is located on the top header menu on the right side, but you can install it on XAMPP server without any problems. Everything will work good except if no internet connection you wont be able to send emails.

Few changes we need to do in XAMPP default installation.

1. Change the .htaccess 

RewriteRule ^(.*)$ index.php?/$1 [L,QSA]

RewriteRule ^(.*)$ /yourfolder/index.php?/$1 [L,QSA]

Try to install.

Cron Job

You will need to setup the cron job controller for Perfex

Cron job will be used for sending survey emails, auto update invoice statuse eq. if the invoice is overdue etc.

How to setup Cron Job?

Login to your cPanel and navigate to Cron jobs

Add the following settings :

wget -q -O- wget -q -O- http://yourdomain.com/crm/cron/index

Change the url according to your base url where Perfex CRM is located. You can check your cron url in Setup->Settings->Cron Job

Example if its on root domain you need to type only http://yourdomain.com/cron/index 
If its on subfolder /crm you will need to type http://yourdomain.com/crm/cron/index

Cron is required to be setup for Perfex CRM

Common CRON Job setup issues

My server does not support wget command?

If your server does not support wget command you try one of the following commands:

php /home/username/public_html/installation_folder/index.php cron/index >> /dev/null

php /home/username/public_html/installation_folder/index.php cron/index

If that doesn’t work, it probably means you don’t have the package php5-cli installed. On debian / ubuntu you can install this package as follows:

sudo apt-get install php5-cli

If you are not able to install packages, you can specify your path to php try the following command:

/usr/local/bin/php -f /home/username/public_html/installation_folder/index.php cron index

Date Format

Setup your desired date format, will be using all over the application. This option is located in Setup->Settings-> Localization

General Email

Navigate to Setup -> Settings -> Email and setup your SMTP email, this will be your base email. You need to setup previously email account from your cPanel account.

Email Templates

Check all the email templates, setup signature also in Setup -> Settings -> Email this signature will be using on all email representing your company

404 Not Found After Installation

If you are getting 404 not found after you install Perfex CRM this means that you need to adjust the main .htaccess for Perfex CRM.

First make sure that the .htaccess file exists in the main folder where you installed Perfex CRM. If you are using any OS make sure you have enabled hidden files on your MAC.

Make sure that you have mod_rewrite enabled in your server.

NOTE: Only apply the following suggestions if you are getting 404 error not found, the default Perfex CRM .htaccess file should work good on most servers.

Installation on subfolder.

This .htaccess may apply if you installed Perfex CRM next to WordPress installation and you are auto redirected to WordPress default 404 Page.

RewriteEngine on
RewriteBase /foldername/
RewriteCond $1 !^(index\.php|resources|robots\.txt)
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?/$1 [L,QSA]
AddDefaultCharset utf-8
                                             

Installation on subdomain

RewriteEngine on
RewriteBase /
RewriteCond $1 !^(index\.php|resources|robots\.txt)
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?/$1 [L,QSA]
AddDefaultCharset utf-8

Getting a error 500 and you are using cPanel

RewriteEngine on
RewriteCond $1 !^(index\.php|resources|robots\.txt)
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ subfolder/index.php?/$1 [L,QSA]
AddDefaultCharset utf-8
                                                

1&1 Installation

RewriteEngine on
RewriteBase /
RewriteCond $1 !^(index\.php|resources|robots\.txt|static) [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/?$1 [L,QSA]

Windows Installation

NGINX Installation

Other solutions:

Cant login to admin area

Perfex CRM admin area is separated from the customers area. Often happen Perfex CRM buyers to get confused and trying to login as admin in the customers area.

Admins needs to login at yourdomain.com/crm/admin
Customers login at yourdomain.com/crm/clients

Hope this will help you.

Steps to perform before upgrading:

1. Backup files and database (including language files if you are not using custom_lang.php file to overwrite translation text)
2. Check the changelog - if you are using your own theme for the customers area. To make sure that there is no changes in the original theme. If any changes there will be mentioned in the first list item from the changelog.

Upgrading from version below 1.2.7 to latest version

1. Download files from Envato.
2. Extract downloaded file
3. In the extracted file, perform steps 4-5
4. Delete application/config/database.php (from the newest downloaded files)
5. Delete application/config/config.php  (from the newest downloaded files)
6. Overwrite the following folders (copy folders from new version update files to your current files):
   1. application
   2. assets
   3. system

Upgrading from version above 1.2.7 (or equal to 1.2.7) to latest version

1. Download files from Envato.
2. Overwrite the following folders (copy folders from new version update files to your current files):
   1. application
   2. assets
   3. system

Troubleshooting

• To check what version you are using visit click here.
• If any css/js errors outputed on developers console or tables are not loading make sure you cleared your browser cache.
• If you are using your own themes/view files eq my_home.php make sure to re-check them in case you are getting blank pages bacause may happen some function changes and an error occur in your view file. Try switching to the original files to check if everything will work.
• Getting 500 error - open support ticket and we will be happy to assist you.