Get started with PHP-Fusion

Version Upgrade Guide

Purpose of this guide

This guide is meant as a help to those, who have doubts about how to upgrade their site to the next version of PHP-Fusion, and also to those, who have missed a couple of upgrades - and therfore need to know, how to upgrade their old-versioned site to the latest release. So here we go...

Upgrade one PHP-Fusion version at the time

The first upgrade rule you need to know is, that you allways upgrade one version at the time. This means, that you can not skip even a minor upgrade version, you have to upgrade the versions one by one*. This is especially important to know for those, who have missed a couple of upgrades and, for example, have to upgrade their site from version 7.01.00 to version 7.01.04 - because then they'll know, that they have to start upgrading from 7.01.00 to 7.01.01 first, and then from 7.01.01 to 7.01.02, and so on...
*Notice, that in some rare cases, there may be an exception to this rule, where several minor upgrades are gathered into one big upgrade package. Be sure to check, if that's the case with the actual download!


Find the right upgrade package

Find, and download, the right upgrade package(s) for you site:
For example: If your site is version 7.01.04, and a new 7.01-version is released, you need to download the 'PHP-Fusion 7.01.05.zip' upgrade package.

Where to find the PHP-Fusion V7 upgrades:

7.00.01 through to 7.00.07 upgrade packages, you'll find here:
Core 7.00.xx Update Packs


To upgrade from 7.00.07 to 7.01.00, you need to download the full 7.01.00 core package, which will contain the instructions to upgrade your site from version 7.00.07 (in the readme.html). Find it here:
Core 7.01.xx Stable


7.01.01 through to 7.01.xx* upgrade packages, you'll find here:
Core 7.01.xx Update Packs

*xx = the minor upgrade version's end number (e. g. 7.01.02, 7.01.03 ect.).


Important - Backup your site, before you start the upgrade


Make a backup copy of your site:
The second upgrade rule you need to know is, that you must always make a backup copy of your site before starting the upgrade itself, so that, if anything unexpected should happen, you can always restore your site, bringing it back to the way it was before the attempt to upgrade it.
(If you've already done this, or, if you already know how to backup your site, you just skip this part and go directly to: "The upgrade itself - step by step")

How to backup your site:

1.0 Log in to the site you want to upgrade, and click on 'Admin Panel', in the user_info_panel (*a).

*a - user_info_panel:


1.1 Then click on 'System Admin' (*b).

*b - System Admin:


1.2 And choose the option: 'Database Backup' (*c).

*c - Database Backup:


1.3 In the 'Backup Options' (*d), select the 'Backup Type' (from the drop-down menu) to choose, whether the .sql file should be compressed or not, type in your administrator password and finally: click on the 'Backup' button, to save the .sql/.sql.gz file somewhere on your PC.

*d - Backup Options:


1.4 Open your FTP program, log in, and find the server on which your site's files and folders are located - the root of your site (*e). Highlight all the files and folders, and download and save them somewhere on your PC (in the same folder where you saved the .sql/.sql.gz file)

*e - site root:



The upgrade itself - step by step

(Notice, that I've use the PHP-Fusion 7-01-04_update.zip package, as an example for the screenshots, and that future updates will have a slightly different look - because of the different content of files and folders of course!)


Step 1 - Translate the new versions additional/changed locals:
Because new locals are offen added or changed (and they are always written in english) in the next improved version of PHP-Fusion, it's very important to do one of two things, before you start the upgrade itself:

Either: Make a translation of the new locals additional/changed file(s), into your sites own language, and place the files in the right location, in the correct local folder(s).

Or: Change the site language into english during the upgrade process - Go into the site administration (*a), and click on 'Settings' (*f), and choose the option: 'Main' (*g). Change the 'Site locale' to english and click on the 'Save Settings' button.

*f - Settings:


*g- Main:


Step 2 - First upload step:
You must first upload the upgrade script /files/administration/upgrade.php (*h) to the /administration folder of your site and upload the folder named /files/locale (*i) to the root of your site. Without the locale files, some names may not be added to the database.

*h - upgrade.php file:


*i - locale folder:


Step 3 - upgrading the database tables:
Login to your site as the Super Administrator. Under the System Admin (*b) tab of the Admin Panel, and choose the option: 'Upgrade' (*j) then click the 'Upgrade' button (*k). YOU MUST perform the upgrade first! The upgrade process will complete only when you see the 'Database upgrade complete' (*l) confirmation*.
*Notice, that on major upgrades, you may have to click on the 'Upgrade' button several times, before the confirmation text appears.

*j - Upgrade:


*k - Upgrade button:


*l - Database upgrade complete - confirmed:


Step 4 - Second, and final, upload step:
VERY IMPORTANT: Since this release contains a number of structural changes, some elements of your site will not work properly until you have updated all of your files and folders. YOU MUST upload, and overwrite, ALL of the files and folders, from inside the upgrade packages /files folder (*m), to the root of your site.

*m - Upload all files and folders:


That's all - you site should now be upgraded to the next version of PHP-Fusion - enjoy!
Posted by Harly on February 14 2011 13:54:17
6 Comments · 68639 Reads · Print
Comments
#1 | jantom on Feb 23 2011 at 21:49:48
Nice article, but bad formated.
Strong tags should be changed to h(x) tags, paragraphs created by p tags etc etc etc Wink
#2 | Harly on Feb 28 2011 at 13:26:52
I don't see your point?
#3 | wildhaggis on Mar 16 2011 at 10:20:48
Easy to understand. Well done Wink
#4 | team2win on Nov 12 2011 at 21:33:16
man, i was leaving out the step 4 everytime I would do an upgrade...
Thanks for this info...
#5 | KaptenKraft on Dec 01 2011 at 22:26:57
Great tutorial! Covers what you need to know in a easy to understand fashion. Grin
#6 | gho5ton3 on Dec 14 2011 at 21:18:08
I really need help Harly, I have followed your steps and have clicked upgrade constantly but still there is no upgrade button. Please help!!! Smile
Post Comment
Please Login to Post a Comment.
Ratings
Rating is available to Members only.

Please login or register to vote.

Awesome! Awesome! 75% [6 Votes]
Very Good Very Good 0% [No Votes]
Good Good 13% [1 Vote]
Average Average 0% [No Votes]
Poor Poor 13% [1 Vote]