Important! This Guide is only if you have version 1.1 installed. If you do not have version 1.1 installed please view this guide first.
Version 1.5 is the stepping stone to phpFoX Konsort Version 2. As you may or may not know Konsort is our new engine. Since everything has been built from the ground up to create a new system and enviroment we have taken time into creating a rather large update system to make sure upgrading to this new engine wont be as complicated as one would think. In this guide you will find everything you need to now to fully upgrade your site. Simply follow the guide step by step and you should be on your way using Konsort in no time.
Would also like to add none of your members data will be lost. Plus your themes will also be imported to the new system.
If at anytime during your upgrade 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 upgrade issues we have come across in the past we have complied in a list to help you debug and fix your issue right away.
upload/
Readme.html
design/
file/
include/
plugins/
site/
update/
index.php
robots.txt
file/ (YES)
update/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
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/update/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 `update/file/` directory...", CHMOD the folder "update/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:
Once you have passed the system checkup continue to the next step.
This step will get your mySQL details. In most cases you wont have to fill them out since it will get your sql settings from your old config file.
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.
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.
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 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 UPDATING". Click on that and you should be on your way to upgrade Konsort.
Note: Update process can take a rather long time depending on how many members you have.
Step 5 is your final step to upgrade your package. This step actually already has phpFoX Konsort upgraded to the latest build, but we use this area to install any plug-ins that you might want or import certain data.
<?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;
?>
Next if you installed your system with the rewrite engine you will also have to move a file called "htaccess" (without the quotes) which is located in the folder update/file/ and move that to your sites root directory and then you will have to rename that file to ".htaccess" (without the quotes).
This step can easily be done via your FTP client by dragging and dropping each file into the specified directory.
Next step we have is to import any old themes you have. To do this you first need to move all your old CSS and Image files
into your new style folder.
To do this first download both "inc/img/" and "inc/css/" folders to your computer.
Then upload all the folders you find inside the folder "inc/css/" to
the folder "file/style/" on your server.
Next upload all the folders you find inside the folder "inc/img/" to
the folder "file/style/"on your server. Make sure to overwrite any files and or folders.
Now that all the themes are in place make sure each of the folders have write permission (CHMOD 0777).
Example: /file/style/phpfox/
Now that you have done that you should be able to import your themes. Go
back to the upgrade script on your web browser and click on "Refresh" at the bottom of the "Import Themes" frame.
Once the frame refreshes you should find an "Import Themes" button. Click on that button and it should import
all your themes.
If for some reason you skip the CSS import step you can do this step after the upgrade is complete as well. Just go to: www.yoursite.com/plugins/css_import/index.php
Once that is completed move on to the next step.
IMPORTANT: You must now either delete or move all your phpFoX Version 1.1 files. You should already have a backup of these files saved, if not please do so now. To explain in short why you need to remove your old v1.1 files, is the new Konsort engine uses a special Rewrite engine and any files that are not part of the system could cause issues. If you are not to big on deleting files simply create a folder called "BACKUP" and then move all the v1.1 files in that folder via your FTP client. It should not take more then a few minutes.
Do NOT however move these files and/or folders into the "BACKUP" folder or delete them: design/
file/
include/
plugins/
site/
index.php
robots.txt
If you have not already deleted or moved the /update/ folder from your server be sure to do that now.
Congratulations! phpFox 1.5.1 has successfully been upgraded!
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.