The section on installation in the Cliqon documentation has two subsections. The first describes the automated process of installing a Cliqon production system using the installation Wizard. The second subsection describes the process of installing Cliqon manually.

Common steps

Both subsections assume that the Zip file has been downloaded and uncompressed or unzipped to a suitable location on a web server that supports PHP and preferably Version 7.0 or above. Cliqon has also been tested on PHP 5.6 but is not designed to work on versions of PHP prior to 5.6.


The location to which the Zip file is uncompressed should be the Root as configured in your Virtual Host file.


# Cliq.Dev

<VirtualHost *:80>

   

       DocumentRoot "D:/Wwwroot/cliq_dev"

       ServerName cliq.dev

       ErrorLog "D:/Wwwroot/cliq_dev/log/error.log"

       CustomLog "D:/Wwwroot/cliq_dev/log/access.log" common


       <Directory "D:/Wwwroot/cliq_dev">

               Options +FollowSymLinks -Indexes

               AllowOverride All

               Order Allow,Deny

               Allow from all

       </Directory>


</VirtualHost>

A note on web server configuration files

Cliqon requires that all access to the system are channeled through index.php at the root of the system. This is normally achieved by creating a .htaccess file on an Apache webserver, a web.config file on Internet Information Server (IIS) and on NGINX, you will create entries in the main Nginx configuration file.


These files are collectively known and defined as web server configuration files that contains commands known by the server that tell the server how to behave in certain instances.


Shown below are the standard files supplied with Cliqon for Apache and IIS. Then we offer a proposal for Nginx


Sample .htaccess


RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond $1 !^(index\.php)

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


FallbackResource /index.php


Sample web.config


<?xml version="1.0" encoding="UTF-8"?>

<configuration>

   <system.webServer>

       <rewrite>

           <rules>

               <rule name="Imported Rule 1" stopProcessing="true">

                   <match url="^(.*)$" ignoreCase="false" />

                   <conditions logicalGrouping="MatchAll">

                       <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false"

                                negate="true" />

                       <add input="{REQUEST_FILENAME}" matchType="IsDirectory"

                                ignoreCase="false" negate="true" />

                       <add input="{R:1}" pattern="^(index\.php)" ignoreCase="false"

                                negate="true" />

                   </conditions>

                   <action type="Rewrite" url="/index.php/{R:1}" />

               </rule>

           </rules>

       </rewrite>

   </system.webServer>

</configuration>


Recommended nginx configuration


location / {

       if (!-e $request_filename){

               rewrite ^(.*)$ /index.php break;

       }

}

Installation files

There are three specific files and one subdirectory of files that are used by the installation process and maybe safely removed or archived after the installation process is complete.


At the root of the Cliqon system is a blocking file entitled “notinstalled”. The existence of this file causes the installation template to be displayed from within the install subdirectory. When this file is removed, Index.Php will load and process “startup.php” instead of “install.php”.


As explained previously, the installation process uses “Install.Php” in the \includes directory and this maybe removed. Similarly, the installation process has its own Controller called InstallController.Php in the \controllers subdirectory, which may be removed.


Finally, the majority of the Install files are located in the \install subdirectory and this may be removed in its entirety.


Created with the Personal Edition of HelpNDoc: Free PDF documentation generator