Instant Update CMS - Installation
Before we install Instant Update, make sure your server meets minimum system requirements.
0. System Requirements
Instant Update requires following web server system configuration:
multibyte support within PHP
GD library for PHP
At least 128 MB of RAM on your server (higher resolution images = higher RAM)
cURL library for PHP (optional but highly recommended)
Apache web server with mod_rewrite and mod_env support (optional)
For this script to work properly, some files and folders need to have writing permissions. On Windows-based hosting writing permissions are present by default (localhost installations). However, on Linux/Unix-based hosting in most cases you will have to set these permissions manually. File access permissions on Linux-based operating systems are better known as CHMOD, which is represented by set of three numbers from 0 to 7. Because of the complex configuration options each server's writable permissions can be represented with different number representation, but in most cases you should set your file/folder permissions to 755 or 777 (although the 777 can be forbidden in some environments).
Most FTP clients support changing permissions (CHMOD) on remote files/folders, but if you don't know how to do it you should ask your web hosting provider to set the permissions for you.
Here's the list of all files and folders which need to be writable for the script to work:
installed.txt File which stores your instance version information.
iu-resources/images/ Folder which stores thumbs.
iu-resources/images/thumbs/ Folder which stores thumbs.
iu-resources/uploads/ Folder which stores uploads images.
iu-resources/uploads/thumbs/ Folder which stores frontend uploads thumbs.
iu-assets/ Folder which stores your website pages' assets.
All these files and folders need to be writable for Instant Update to work properly.
Our script uses MySQL database to store property data and all other website related information. Your data in HTML div will be stored in database when you edit div id contents for the first time
You need to provide one MySQL database for our script to work. You can create new, empty database or you can use existing one, we don't care, as long as your database does not contains tables starting with "iu4_" (this is a default table prefix and can be changed).
This is the following data you will need to continue installation:
hostname MySQL server host name. In most cases this will be "localhost".
username MySQL user username.
password MySQL user password.
database MySQL database name.
If you don't know how to create a database or you don't have enough permissions to do that, please ask your web hosting provider to do this for you and ask them to give you above listed data.
First, download and extract Instant Update to a folder of your choice on your computer.
When you've extracted the script, connect via FTP to your web site and locate your web site root folder. It is usually named public_html or wwwroot. Once you are there, copy ALL files from folder of your choice (where you extracted ZIP archive) to the root folder of your web site.
After all files are uploaded, your new Instant Update installation will be accessible on the root of your web site (e.g. http://www.yourwebsite.com/). If you want your script instance to run in a subfolder (e.g. http://www.yourwebsite.com/subfolder/), you can freely place it in the subfolder of your choice (even in multiple subfolders) - everything should run smoothly. However, you won't be able to use IU to manage pages outside of that subfolder!
4. Setting up configuration file
Before starting installation you should set up MySQL database access data explained in previous section in our script's database config file. This file is located in iu-application/config/database.php (the path is relative to the root folder of your web site)
This is example database.php configuration file:
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
/* SET UP YOUR MYSQL ACCESS DATA HERE */
$db['default']['hostname'] = 'localhost';
$db['default']['username'] = 'mysql-user';
$db['default']['password'] = 'mysql-password';
$db['default']['database'] = 'mysql-database';
/* DO NOT CHANGE LINES BELOW UNLESS YOU KNOW WHAT ARE YOU DOING */
$db['default']['dbdriver'] = 'mysql';
$db['default']['dbprefix'] = 'iu4_';
$db['default']['pconnect'] = TRUE;
$db['default']['db_debug'] = FALSE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = '';
$db['default']['char_set'] = 'utf8';
$db['default']['dbcollat'] = 'utf8_unicode_ci';
$db['default']['swap_pre'] = '';
$db['default']['autoinit'] = TRUE;
$db['default']['stricton'] = FALSE;
$active_group = 'default';
$active_record = TRUE;
/* End of file database.php */
/* Location: ./iu-application/config/database.php */
After database connection data is stored in database config file, you may run your script installation. It's very easy, just point your web browser to your web site and add "install/" to the path (e.g. http://www.yourwebsite.com/install/) and setup wizard will appear.
Installation process should be error free and very easy to finish. It consists of few very short steps, such as:
This is the first screen you will see when you visit your web site. It will check if your web server meets system requirements and let you know of the results. If something is not right it will tell you, so you can fix it on your own, or contact your web hosting support to do that for you. If everything is okay, at the bottom of this page you will see a message stating: "Everything seems to be fine. You may proceed with installation." - click the "Proceed" button.
This screen will display your MySQL database connection information which you placed into iu-application/config/database.php. Check it for any typing errors and once you're sure everything is okay. Once you're sure everything is okay press "Proceed" button.
By the time this is page loaded the MySQL database tables are already successfully installed. If not, an error message will be shown. Click "Proceed" to go to the final page.
This is the final stage of the script setup routine. Fill out your name, (valid) e-mail address, and desired password (twice!) and press "Proceed". This will finish installation process and next time you open your web site you should see the script working.
If you need any help with installation just open new forum topic and someone should answer all your questions.
6. Cleaning up
Once the installation is finished there are two things you should do:
Make file installed.txt read-only again. - Since there is no need for system to write to this file once the script is installed (at least until the next upgrade) we should forbid any script to mess up contents of this file. If there's an upgrade, you'll easily make it writable again.
Open iu-application/config/config.php and around line #40 change this:
$config['encryption_key'] = 'change this';
to any random string. For example, you can place something like this (make up your own key, do not use this sample key):
$config['encryption_key'] = '3r2rDSFdGh35';
This will make script's encryption algorithm unique for your website, so it'll be more secure.
These steps are not required but they will additionally secure your web site.
7. Log in
Installation is now finished. You can log in by navigating to http://www.yourwebsite.com/index.php/administration
Now you can upload any HTML file or folder. Once you visit this file through your browser Instant Update will automatically parse the HTML and your website will be ready for editing. You can check some free templates that we already prepared for you.
If you setup everything properly and still not being able to load pages with Instant Update. Most common problem is that your already have index.htm(l) page and you should follow this article to learn more about it: