Installing

If at anytime during your install you ran into trouble, please click on the "Help!" link in the top menu bar for the most commun issues that might help fix your issue. Most install issues we have come across in the past we have complied in a list to help you debug and fix your issue right away.

Installing: Step 1 - Uploading

At this point you should have the zip archive "unzipped", which should have contents similar to those shown in this structure guide:
upload/
Readme.html

Go into the folder "upload/", which should have contents similar to those shown in this structure guide:
design/
file/
include/
install/
plugins/
site/
index.php
robots.txt
Upload the files and folders to your site using an FTP client. Be sure to overwrite any old files.

Once that is completed and all files have been uploaded to your server we can move on to the next step.


Installing: Step 2 - CHMOD & File Permissions

With the Konsort package there are certain folders and files that need write permission in order to execute certain tasks from the admin control panel.

Below you will find the folders and files that must have full write permission and set to 0777 in order for the script to be installed. Notice we have marked certain files with the (YES) which signify the folders that must have write permission even after install. These folders would mainly be folders used to cache templates or storage to keep all images being uploaded by your members.

Konsort Files:
file/ (YES)
install/file/
file/content/en/email_comment.html
file/content/en/email_crush.html
file/content/en/email_forum.html
file/content/en/email_invite.html
file/content/en/email_layout.html
file/content/en/email_lost_password.html
file/content/en/email_newbuddy.html
file/content/en/email_newmail.html
file/content/en/email_quote.html
file/content/en/news.html
file/content/en/subscribe.html
file/content/en/welcome_intro.html
file/language/en/about_us.html
file/language/en/get_involved.html
file/language/en/help.html
file/language/en/terms.html
file/pic/forum/ (YES)
file/pic/gallery/ (YES)
file/pic/gallery/thumb/ (YES)
file/pic/groups/gallery/ (YES)
file/pic/groups/gallery/thumb/ (YES)
file/pic/user/ (YES)
file/pic/user_bg/ (YES)
file/smile/ (YES)
file/smile/emo/ (YES)
file/style/konsort/logo.jpg
file/style/konsort/style.css
file/templates_c/ (YES)
file/txt/country.txt
file/txt/event_items.txt
file/txt/jmood.txt
file/txt/ban_username.txt
file/txt/ban_words.txt
file/txt/ban_email.txt
Once you have completed CHMODING all the needed files and folders please continue to the next step.

Installing: Step 3 -Using the Web-Installer

An installer is provided to assist you in entering the information phpFoX Konsort needs to connect to your mySQL database and to create your new administrators account.

Run the installer file through your web browser by entering the URL into your browser address bar (if you have followed our example, type in http://www.domain.com/install/index.php, naturally subsituting 'domain.com' for your web address.)

You will be presented with a short information screen, if you receive the following error "Please grant write permissions to `install/file/` directory...", CHMOD the folder "install/file/" to 0777 via your FTP client.

Once you pass that check you will be able to view your Konsort setup script. This setup will consist of 5 steps.
Please follow each step:

Step 1 - License

First step you will need to complete is the agreement to the phpFoX license. Once agreed upon continue to the next step.

Step 2 - System Check

Step 2 will consist of checking your server settings and if all files/folders have the permission they need for the script to be installed.
The following will be checked on your server:
  • PHP 4.3.1 and more
  • GD extension - If exists
Apart from the server checkup it will also check if the files/folders that we listed in "CHMOD & File Permissions" have the correct permissions.

Once you have passed the system checkup continue to the next step.


Step 3 - Installation info

This step is where you will need to know your SQL username and password at this point. If you do not know it, please ask your web host - in most cases it is different from the FTP log in information.

The form is very straightforward, with only the following points needing closer examination. If you do not know what your mySQL "host" is, try "localhost" (without the quotes). if the SQL server is on the same server as your website (and in most cases it is) this will suffice. If you have created a new database for phpFoX Konsort, or wish to use an existing database, enter the name of the database in the appropriate field.

Under the SQL setup table you will have the Server Configuration table. There you will find where it says "Rewrite engine supported?", this setting is for those who have a server that supports Apache's Rewrite Module. If you are not sure what this is please ask your host or view this guide. In short phpFoX uses this module to allow URL's to be shorter then the default method.


Examples:
Rewrite ON: www.yoursite.com/gallery/
Rewrite OFF: www.yoursite.com/index.php/public/gallery/ or www.yoursite.com/index.php?do=/public/gallery/

Both methods are fine, though we would advisee turning ON the rewrite engine if you have support for it since search bots seem to like it.

Once you have selected if you want to use the Rewrite engine you will have to fill out basic details for your site. First enter a admin user name you would like, note that you wont be able to change this once your site is up and running. As for the password you can change that at anytime. Last but not least enter your sites title, name and the main contact email for your site. These last settings can be changed at anytime from the admin control panel.

After submitting the form, you will be informed of any errors - if you do get an error similar to "permission denied for user@localhost using password YES" - the chances are you have either your mySQL username, mySQL password or mySQL database name wrong. Consult with your webhost for the correct information and resubmit the form.


Step 4 - Installation

Step 4 will list if any errors are found and it will explain what needs to be done to fix the issue.

If no errors come up you will see a button to "START INSTALLATION". Click on that and you should be on your way to install Konsort.


Step 5.1 - Finishing Installation

Step 5 is your final step to install your package. This step actually already has phpFoX Konsort completed installed, but we use this area to install any plug-ins that you might want.

First thing first you will see "Config Setup". This small step is where you will have to move your main config file for the phpFoX Konsort package. You will find a file called server.sett.php in the folder install/file/. You will have to move that file to the folder: include/settings/

The file we have just moved will have content similar to the code below.
PHP Code:
<?php
global $_CONF;

$_CONF = array();
$_CONF['db']['host'] = 'localhost';
$_CONF['db']['user'] = '%username%';
$_CONF['db']['pass'] = '%password%';
$_CONF['db']['name'] = '%database%';

$_CONF['path'] = dirname(dirname(dirname(__FILE__))).'/';
$_CONF['domain'] = '%domain%';
$_CONF['host'] = $_CONF['domain'].'/';
$_CONF['http'] = 'http://';
$_CONF['https'] = 'http://';

$_CONF['rewrite_engine'] = false;
$_CONF['path_translated'] = false;
?>

This stores your database, domain and rewrite engine settings. If you ever need to move your site or change these settings this is the file to do that.

Next if you installed your system with the rewrite engine you will also have to move a file called "htaccess" (without the quotes) and move that to your sites root directory and then you will have to rename that file to ".htaccess" (without the quotes). Note if your site does not have the Rewrite engine mod installed then you can skip this step.

This step can easily be done via your FTP client by dragging and dropping each file into the specified directory.

After you have completed the steps above your installation of the phpFoX Konsort package and plug-ins are now complete. Click on the "Finish" button you have at the bottom of that page for your final "congrats" page.

Step 5.2 - Finishing Installation

The first thing you will need to do is remove the /install/ folder from your server.

Congratulations! phpFox 1.5 installation has succesfully been completed!

If you ran into trouble, please click on the "Help!" link in the top menu bar for the most common issues that might help fix your issue.

We also created a small "Crash Course" guide with some FAQ and tutorials on how to start up your phpFoX Konsort package.

For a full list of methods we offer our clients support click on the "Support" link in the top menu.



>> Read up on the Crash Course guide and learn how to start up your site!