Version 4.0 introduces an automated installer which takes care of making changes to the OpenCart database, appending the primary .htaccess file, and
verifying that required permissions are set correctly. Though there is still a step or two that is a manual process, and other tweaks one might want to go
through to ensure their website is performing at it's best.
INITIAL INSTALLATION
VQMOD
Many of you will already have vQmod installed, those who don't it can be downloaded here:
VQMod downloads page. If you haven't upgraded to the vqmod 2.2.x series of vQmod I highly recommend
that you do so now as it offers performance benefits over previous generations, especially if your shop is running a large number of mods. If you are fairly
new to OpenCart & vQmod an installation tutorial video can be viewed here.
UPLOAD IT
Located in this this package is a series of folders ('admin', 'catalog', 'image', 'min', 'system', and 'vqmod'), these folders should be uploaded via FTP to
your store root (matching existing folders). If you do not currently have a FTP client, I highly recommend FlashFXP.
You will need to know your websites FTP connection settings and username and password, these are provided by your web hosting company.
RUN THE INSTALLATION APPLICATION
If you are not currently logged into your OpenCart admin panel, please login now (or if you are already logged in, please visit your dashboard page). This will trigger
the Increase Page Speed installer to run. In most cases, everything should report okay, in the event that you experience any error notifications, please skip forward to
the installation errors section, it contains details on how to deal with any encountered errors.
USER GROUP PERMISSIONS
Increase Page Speed adds several cache clearing mechanisms which require user group permissions to access. As such you must go into system > users > user groups
and add appropriate permissions to be able to clear cache via the menu.
If you do not use another group other than 'Top Administrator' and are not concerned with different user level permissions simply click the 'select all' for both boxes. Otherwise the new feature can be individually sought out with the id of: 'tool/clearcache'
CRON JOB
Login to cPanel (or DirectAdmin, or whatever control panel you web host is providing) and goto 'Cron Jobs', create a new entry to run every 15 minutes.
The command line should look something like this :
php -q /home/yourwebhostusername/public_html/admin/ips_cron.php
If you experience problems running the above command you can alternatively use:
wget -q http://www.yourdomain.com/admin/ips_cron.php
If you are uncertain of the base path, just open your config.php in your open cart admin directory.
Once added, login to your admin panel, goto System > Settings > edit store. Click on the 'Increase Page Speed 4.0' tab and note the 'DB Cache' Status.
Wait about 15 minutes, refresh the page ~ ensure that it is updating. Once you are satisfied that it is indeed running go back into cPanel and change the job to run daily.
If you web host does not offer Cron Jobs you can setup an account with this free server and use the wget method above. https://www.setcronjob.com/
INSTALLATION COMPLETE
You may now reference the feature guide to learn about the features of this extension, how to configure them and the ways in which they can benefit your shop.
INSTALLATION ERRORS
PERMISSION VERFICATION FAILURES
There are 3 sets of permissions which may need to be set on your server depending on how the web server is configured. This can be done by applying a CHMOD
755 command (on occassion some servers require 777).
Write permissions are required for the following files and folders:
file ./min/min.config
folder ./system/cache/min
folder ./system/cache/seo
UNABLE TO MODIFY OR LOCATE .HTACCESS FILE
If you have not already renamed the .htaccess.txt to .htaccess please do so now, it is located in the root directory of OpenCart. If you are just now
enabling this for the first time and your store is in a sub-directory such as 'shop' or 'store', then you will need to make a change (roughly around line
20) to state the directory it is located in.
If you received an error that the installation program was unable to modify the .htaccess file please add the following to the end of the file:
## INCREASE PAGE SPEED HTACCESS MODIFICATION ##
<ifModule mod_headers.c>
Header set Connection keep-alive
</ifModule>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/x-javascript
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
<ifModule mod_headers.c>
Header append Vary User-Agent
</ifModule>
## END INCREASE PAGE SPEED HTACCESS MODIFICATION ##
UNABLE TO REMOVE INSTALLER APPLICATION
If you receive this error, it simply means that the installation application was unable to remove itself from the vQmod xml directory. Please manually remove this file
from your OpenCart website: ./vqmod/xml/install_increase_page_speed.xml.