Notice: Be sure to backup your site and your database before attempting to upgrade.
This guide will help you through the upgrade process of phpFox.
We advise that you read this entire documentation to get a greater idea on how to handle the package and solve any issues should they occur.
You will need an FTP (File Transfer Protocol) client, if you do not have one you can download Filezilla for Windows/Linux or InterArchy for Macintosh. You do not need an in-depth knowledge of PHP programming to install phpFox, but a working knowledge of FTP functions is a plus.
Note that if at any time you run into any problems be sure to check out troubleshooting section here.
This guide assumes that you have successfully downloaded the latest release from phpFox and have the ZIP file "unzipped".
The upgrade script only works with phpfox version 1.6 build 21 and newer so if you are running 1.6 build 20 or older you will need to upgrade to build 21 and then use this guide to get to version 2.
Contents |
At this point you should have the zip archive "unzipped", which should have contents similar to those shown in this structure guide:
Go into the folder "upload/", which should have contents similar to those shown in this structure guide:
Next, upload the files and folders within the "upload/" folder to your site using an FTP client. Be sure to overwrite any old files.
Once that is completed we can move on to the next step.
With the phpFox package there are certain folders and files that need write permission in order to execute certain tasks.
Below you will find the files and folders that must have full write permission and set to 0777 in order for the script to be installed.
You will notice in the list below we have the file:
include/setting/server.sett.php
If this file does not exist you are upgrading from a legacy version and will have to rename the file:
include/setting/server.sett.php.new
to
include/setting/server.sett.php.example
Notice: Do not rename the file above if it already exists and/or you are upgrading from v2.0.0rc1 or higher.
Once you have completed CHMODING all the needed files and folders continue to the next step.
If you are upgrading from version 2.0.0 RC1 or higher you can skip this step. If you are upgrading from anything older then 2.0.0 RC1 you must rename the file:
.htaccess
to
htaccess_backup
This file can be found in your sites root directory.
== How to shorten links in phpFOX 2.0 ==
1. Open you're favorite FTP, and login.
2. Once you have you're FTP running navigate to the following directory'
/include/setting/server.sett.php
3. (Open server.sett.php)
4. Around line 37 you should find'
$_CONF['core.url_rewrite'] = '2';
5. Replace with
$_CONF['core.url_rewrite'] = '1';
6. Save the file - overwrite if needed.
7. Navigate to the root of you're site.
8. Rename "htaccess" with ".htaccess".
9. Reload you're site, It should be working fine.
10. Thats it, you're done!
An installer is provided to assist you in entering the information phpFox2 needs to connect to your SQL database.
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 substituting 'domain.com' for your web address.)
Then follow these steps:
We first check if the domain you are attempting to install the product on currently has a valid product license. There are several ways you can run a licensed product. You can run it on a licensed domain, which you provide the full path to where the software will be installed. You can also run a test site only for development purposes in a folder, sub-domain or localhost. The folder or sub-domain name must be called "phpfoxdev" or "development" and must be access protected. Here are some examples:
http://www.yoursite.com/phpfoxdev/ or http://www.yoursite.com/development/ (Live Development Server) http://phpfoxdev.yoursite.com/ or http://development.yoursite.com/ (Live Development Server) http://localhost/ or http://127.0.0.1 (Local Server) http://209.85.135.104/ (IP to Your Development Server)
Abide to the License Agreement to continue to the next step.
Step 3 will consist of checking your server if it meets the software requirements and the correct file permission layout.
This step is automated and is when all the updates take place. Depending on what version you are upgrading from the time taken to complete the upgrade can differ. The older the version you are upgrading from the longer it will take.
Congratulations your site has been upgraded to the latest version of phpFox.