System requirementsReal Estate Script server requirements:
- PHP 5.3+
- MySQL 5+
- GD library for PHP
- Multibyte support for PHP (mbstring)
- cURL library for PHP (optional but highly recommended)
- Apache web server with mod_rewrite support (optional)
- ionCube Loader for PHP 5.3+
- At least 128 MB of RAM on your server (will require more memory for higher-resolution images)
File permissionsFor this script to work properly, some files and folders need to have writing permissions. On Windows-based hosting writing permissions are present by default on most server. 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 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:
|license.txt||File which stores your license information.|
|installed.txt||File which stores your instance version information.|
|images/||Folder which stores images.|
|images/properties/||Folder which stores properties' images.|
|images/captcha/||Folder which stores generated CAPTCHA images.|
|images/misc/||Folder which stores advertisements.|
|assets/||Folder which stores your website pages' assets.|
|application/cache/||Folder which stores cached data.|
Setting up the databaseOur script uses MySQL database to store property data and all other website related information. 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 "res_" (this is the 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.|
Uploading script filesFirst, download and extract real-estate-script-x.y.z.zip to a folder of your choice on your computer. This file can be obtained from our Customer Area (assuming you have purchased the script, or you have free trial active).
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, wwwroot, or something like that. Often it's the root of your FTP connection (you're there as soon as you connect). Once you are there, copy ALL files from folder of your choice (where you have extracted ZIP archive) to the root folder of your web site. It should look like this (files are not shown here, only folder structure):
After all files are uploded, your new Real Estate Script 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/real-estate/), you can freely place it in the subfolder of your choice (even in multiple subfolders) - everything should run smoothly.
Setting up configuration fileBefore 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 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'] = 'res_'; $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: ./application/config/database.php */
InstallationAfter 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 apear.
Installation process should be error free and very easy to finish. It consists of few very short steps, such as:
a) SelfcheckThis 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.
b) DatabaseThis screen will display your MySQL database connection information which you placed into 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.
c) InstallationBy 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.
d) AdministratorThis 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, you can open live support chat directly from script's setup wizard, or just open new ticket and someone will answer all your questions.
Cleaning upOnce 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 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 (but don't! make up your own key):
$config['encryption_key'] = 'ad1SAxsaS24';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.