Skip to content

Installation process

Jump to bottom
ClicShopping AI - e-commerce Solution B2B B2C edited this page Dec 23, 2023 · 13 revisions

Table of Contents

This process has been tested on :

  • Maria-Db and Mysql
  • Panel Admin : IspConfig V3 - Cpanel
  • Ubuntu
  • Debian
  • Windows 10 and 11 with easyphp, wampserv .... (see below for local machine)

#1. Checkist before to start

  • read this README document
  • Check the server requirement
  • Download ClicShopping
  • Install Ftp Client as Filezilla
  • Upload ClicShopping via Filezilla
  • perform installation
  • Check security page in administrative area;
    Tools > Security
  • join the community
  • install your Apps, modules;
    Configuration > My administration > Dasboard
    Configuration > shipping
    Configuration > payment
  • Choose your own Apps, modules;
    Tools > Extension
  • Create your catalog
  • Perform a test checkout

#2. Download ClicShopping :

To begin, you should download the compressed files containing all necessary files and archive. Download ClicShopping and unzip the file.

3. #Setting up your FTP software

You will also need an FTP software to upload files to your server. One of the most used (which we recommend) is Filezilla. You can download the filezilla.org website and install it.

From elements that you were given by your host, configure filezilla so that it can connect to your hosting.

1 - How to Use Filezilla.

  • Click File and Site Manager. You will get the following items below.
  • Fill the host box, which is usually your website
  • Select the appropriate file transfer protocol: FTP generally
  • Choose the type of authentication: usually: normal
  • Enter your username: give your host
  • Indicate voting password: give your password
  • Click on Connection

2 - Upload files You must connect to the server and download the files in the target directory of your instance (This directory typically contains an index.php or index.html). Given the variety of settings of the servers, it may be in a directory, groups, for example web.

3 - Permission on files There are two important files in ClicShopping solution in order to begin the installation correctly. These files require a temporary change permissions during the installation process

The following files are located in the directory

  • /includes/ClicShopping/Sites/Shop/site_conf.php : store configuration file (catalog)
  • /includes/ClicShopping/Sites/ClicShoppingAdmin/site_conf.php : store configuration file (administration)
  • /includes/ClicShopping/Conf : 2 files
  • /includes/ClicShopping/Work : All the directories including the sub-directories
  • /sources/images/ : All the directories including the sub-directories

In Filezilla, go to the directory and right mouse button,

  • Click Change file attributes
  • In numerical value: Specify the 777 value (allowing the writing to file)
  • Click Ok

Note : In function of your hosting, you must have to make some other 777 directories to make. In this case, you will have an alert inside your administration

#4. Installing ClicShopping

You can now start installing ClicShiopping.

Indicate in your browser following url: https://www.mydomain.com/shop/install (change mydomainame.com par your domain)

Step 1 :Server check

The second step is to set write permissions on folders and files on your server.

You need for this step of your FTP and assign the correct rights (see Step 3 for explanation) based on directories and files listed in step installation Once this is done, you can refresh your browser by pressing the F5 key to see if the parameters you changed are correct.

If all the lights are green, then you can proceed to the next step

Step 2 : Configure the database

This step is to make a connection to your database.

For safety reasons, it may be that you can not create the database from the installation file. Your host has provided you with a password, a login (username), web address to connect to the administration of PhpMyadmin or from your hosting manager to create a database .

Depending on the case, you will have 4 parameters at your disposal

Server database: usually localhost The login user name: provided by your host or one that you created Password: given by your host or one that you created The name of the database: given by your host or one that you created

From these elements, fill the form

Then click Next and wait for the download process to happen. Once this is finished, you will automatically to the next step. Please do not interrupt the process. You have an option to install the demo to test ClicShopping

Important note : If you have an error : Unknown storage engine 'innodb': please follow the instruction via this post : https://www.clicshopping.org/forum/topic/448-error-db-unknown-storage-engine-innodb/

Step 4 : Setup files conf.php

This step allows you to retrieve various parameters to set the configure.php files correctly. There is no specific operation to be performed on this stage, click Next

Step 5 : Setup ClicShopping

This step is done so that you can access your administration and shop

Notes:

In the username, please enter your email address In the password, please use the symbol * / - eG

This will give you greater security.

Step 6 : Secure files

This step will show you how to perform a security tool files.

From FTP

  • Reassign the configure.php files in read-only mode (444) (step 3 procedure) or verify

  • /includes/ClicShopping/Sites/Shop/site_conf.php : store configuration file (catalog)

  • /includes/ClicShopping/Sites/ClicShoppingAdmin/site_conf.php : store configuration file (administration)

  • /includes/ClicShopping/Conf : database access

  • Remove the installation directory : Shop/Install

  • Any other operation will be indicated by the installation procedure.

Once this is done, you can access your administration and start the setup according to your needs.

#5. Installing Dedicated server or on the cloud

Installing ClicShopping on a dedicated server or on the cloud is easy. Please follow this step if you need to set a new server. After the installation, you can follow the instruction above in section 1

1. Install PHP 8.1 and Apache 2.4

Install PHP 8.1, Apache 2.4 and other software packages.

apt install php8.1 php8.1-fpm php8.1-curl php8.1-gd php8.1-intl php8.1-mbstring php8.1-mysql php8.1-soap php8.1-xml php8.1-xmlrpc php8.1-xsl php8.1-zip apache2 libapache2-mod-fcgid zip python3-certbot-apache

2. Configure Apache 2.4

  1. Enable Apache modules and default SSL VirtualHost.

a2enmod expires fcgid headers http2 proxy_fcgi rewrite ssl a2enconf php8.1-fpm a2ensite default-ssl

  1. Add the following code to VirtualHosts configuration files, into “VirtualHost” block.

vi /etc/apache2/sites-enabled/000-default.conf vi /etc/apache2/sites-enabled/default-ssl.conf <Directory "/var/www/html"> Options FollowSymLinks AllowOverride All Require all granted </Directory>

3. Restart PHP-FPM and Apache Services

systemctl restart php7.4-fpm.service systemctl restart apache2.service

4. Install MariaDB

  1. Install mariadb-server and mariadb-client:

apt install mariadb-server mariadb-client

  1. Create database and database user:

mysql -e "create database domain_db; GRANT ALL PRIVILEGES ON domain_db.* TO domain_user@'localhost' IDENTIFIED BY 'toto@toto';" -uroot

5. Install Postfix To send notifications, contact emails and orders from the website we will install Postfix.

apt install postfix

Choose “Internet Site” on the Postfix configuration step.

  1. Install ClicShopping
  1. Change to default Web root directory:

cd /var/www/html rm index.html

  1. Create file .user.ini in the Web root folder to adjust PHP options required by ClicShopping. It's an option but it's recommended. The default settings are enough.

vi /var/www/html/.user.ini expose_php = Off max_execution_time = 600 max_input_time = 600 max_input_vars = 10000 memory_limit = 256M post_max_size = 64M upload_max_filesize = 64M max_file_uploads = 50 session.gc_probability = 1 session.gc_maxlifetime = 14400

  1. Change owner for Web root directory to “www-data” recursively:

chown www-data: /var/www/html -R

  1. Request Free Let's Encrypt Certificate for your domain using certbot utility or install the valid SSL certificate. If you use Cpanel or other website administration, you must have this feature. It's important to activate it before to install ClicShopping

#6. Windows installation

To install ClicShopping on windows machine, you must define for mysql configuration the password.

  • Go to PhpMyAdmin admin panel
  • ClicK on Privilège or User account
  • Add password on this line : user : root and host : localhost
  • Install ClicShopping : htpp://localhost/ClicShopping/install/index.php and follow the step.

Note : Some option could be required but you have the possibilities to not use else you must your php.ini

We recommenend you to use wampserver : https://www.wampserver.com/

If you have a problem do not hesitate to create a post on the forum.

More Informations :

Enjoy :)

Alt text

Copyright ClicSHopping

Clone this wiki locally