Installation Manual

Table of Contents

• Introduction
• Overview
• Requirements
• Download
• Database Setup
• Script Upload
• Permission Adjustments
• Setup Wizard

Introduction

Thank you for purchasing CMS pro - the unique content management system that incorporates modular design. You can build your site without the need for any third party products. CMS pro has reliable functionality and easy to use interface.

CMS pro is easy to install and simple to manage. Use it as a stand-alone application or in conjunction with other applications to create entry level sites, mid-sized or large sites. You can be confident that you will be able to invest in this system and continue to grow it to any possible level.

Good Luck with CMS pro!

Overview

This installation manual was created to help you install CMS pro on your site. The whole installation process can be divided into the following steps:

• Server/Client requirements
• Download the script
• Setup a MySQL database
• Upload the script to your server
• Make some pre-installation adjustments
• Run installation script

Server Requirements

CMS pro requires your web server to meet the following minimum system requirements:

• Linux/FreeBSD/Windows OS server platform
• Apache 2.0 or above (mod_rewrite module installed)
• MySQL 5.1 or above
• PHP 5.3 or above (GD lib, XML lib, FreeType installed)

LAMP is a recommended server configuration.

Client Requirements

CMS pro has user-friendly web interface so software requirement is pretty simple - you just need a modern browser.

Download

You can download previously purchased script from your codecanyon dashboard.

Database Setup

If you already have an empty database and you don't want to setup the software into new database you can skip this step and proceed to script upload. Otherwise, keep up reading to learn how to create a new database on your server.

Basically, there is one of three ways to create a new database on your server:

• via cPanel
• via phpMyAdmin
• via SSH

If you are not sure what cPanel, phpMyAdmin, or SSH is, please contact your hosting company. They will give you at least one of those accounts. Below is the detailed description of each method described.

Method #1: cPanel

Creating new database using cPanel (you hosting account control panel) is the easiest and the fastest way and is considered the default way. If you are not experienced in installing scripts, please stick to this method.

• Go to MySQL Databases section.
• Enter database name and click Add Db button. This will create new database.
• Enter username and password and click Add User button. This will create new user. Please remember these credentials since you will need them later when running installation script.
• Add newly created user to the newly created database with ALL privileges.

Method #2: phpMyAdmin

phpMyAdmin is another way to create new database. But you must have enough correct permission to do that in phpMyAdmin.

• Open phpMyAdmin in your browser. If you're not sure what the URL is, please contact your hosting company.
• Enter database name into Create new database field and click Create button. This will create new database.
• Select newly created database and go to SQL section.
• In the query text field enter this query:

  GRANT ALL PRIVILEGES ON database_name.* TO database_username@localhost IDENTIFIED BY 'password' WITH GRANT OPTION;

  IMPORTANT! Don't forget to replace database_name, database_username, and password with actual database name, username, and password when running this query.
• Go to SQL section again and run this query:

  FLUSH PRIVILEGES;

Method #3: SSH

The last alternative method is via your SSH account. This is the most sophisticated method.

• Connect to your server via SSH.
• Run the command below to enter MySQL environment:

  mysql -u username -p

  Replace username with actual database username. You will be prompted to enter password.
• Run the command below to create new database:

  CREATE DATABASE database_name;

  Replace database_name with actual database name.
• Run the command below to grant privileges to the user:

  GRANT ALL PRIVILEGES ON database_name.* TO database_username@localhost IDENTIFIED BY 'password' WITH GRANT OPTION;

  IMPORTANT! Don't forget to replace database_name, database_username, and password with actual database name, username, and password when running this query.
• Run the command below:

  FLUSH PRIVILEGES;

By following the instructions of one of the methods above you should now have a new database created on your server.

Script Upload

To upload the script to your server you need an FTP client program. FTP stands for File Transfer Protocol, and FTP client is a program that allows transferring remote files via this protocol. If you want to learn more about FTP, please search Google for it.

Connect to your server via FTP and upload the script.

Permission Adjustments

For the installation script to run successfully you need to set some file permissions. By setting permissions you actually tell the server to allow the script make some actions with some files.

To start changing permissions do the following:

• Connect to the server with either FTP or SSH client program.
• Go to the directory where you uploaded the script.
• Run the command below to make backup directory writable:

  chmod 777 backup/

• Run the command below to make lib directory writable:

  chmod 777 lib/

• Run the command below to make uploads directory writable:

  chmod 777 uploads/

Setup Wizard

To install CMS pro you have to run installation file. In the example below we will use mysite.com as an example domain name. Whenever you see this name you have to substitute it with your actual domain name. We will also use wojocms/ as the script root directory. If your directory differs from this one you also have to change it to your actual directory.

To start installation, run the installation script by typing the following URL in your browser: http://www.mysite.com/wojocms/ (remember to substitute mysite.com with your actual domain name and wojocms/ with your directory name).

CMS pro installation process is divided into three simple steps. They are: Pre-installation check, License, Configuration. Let's review these steps in details.

a. Pre-installation check

This step checks your server configuration and explains if your server suits all the requirements for running the software. Besides, you can download Server Requirements Checker. Just unzip and point your browser to checker.php file and you will understand if you can go on using the CMS pro software.

Pre-installation check is divided into several groups:

• Server Configuration
• Recommended Settings
• Directory & File Permissions

Let's review all these groups in details.

Server Configuration

Recommended Settings

We highly recommend setting correct values for all settings here. Anyhow, the script will still operate in case you have some of them configured in a different way. Safe Mode, Register Globals, and others must match required configuration.

Directory & File Permissions

Set correct permissions for all your directories and configuration file. Installation process can not be completed until you set writable permissions for lib/directory.

b. CMS pro License

Please read CMS pro License Agreement. By clicking Next button you confirm you agree with the terms of use mentioned in the license agreement.

c. Configuration

This step configures your script. It's divided into several groups: Database configuration, Common Configuration, Administrator configuration.

Database Configuration

Here you should input correct database details.

Common Configuration

No need to change any values here. They are generated automatically.

Administrator Configuration

Please set your admin panel username and password. Later you can change all these values in admin panel. Also set your email. It will be assigned to default admin account that is created during installation.

After you fill in the forms click Next button. Your script should be successfully installed.

IMPORTANT! You must remove /setup/ directory after installation!