Copyright © 2002 - 2008 Nick Jones Version: 6.01.15 - Released: April 2008
1. Introduction
PHP-Fusion is a light-weight open-source content management system (CMS) written in PHP. It utilises a mySQL database to store your site content and includes a simple, comprehensive adminstration system. PHP-Fusion includes the most common features you would expect to see in many other CMS packages. PHP-Fusion is released under the terms and conditions of version 2 of the GNU General Public License. For further information please visit www.gnu.org or refer to the gpl.txt file included in the distribution package. You may alter the code in any way you wish and redistribute it either as is or containing your own modifications. We would appreciate it if you retained the "Powered by PHP-Fusion" footer copyright notice. We feel this is fair when you consider the many hundreds of hours of work that continues to go into the development of this project. However, if you do remove the footer copyright notice please consider making a donation via Paypal.
2. Installation
Before installing PHP-Fusion you need to create a mysql database. You can do this via your web-hosting control panel or phpMyAdmin. Make sure you have your mysql access details at hand including the hostname, username, password and database name as you will need to specify these during setup. 1. Before you upload the files, rename the file blank_config.php (located in the folder entitled php-files) to config.php. 2. Upload the contents of the php-files folder to your web-server. 3. Unless you are running PHP-Fusion on a local server, in most cases you will need to CHMOD the following files & folders to 777: administration/db_backups/ images/ images/imagelist.js images/articles/ images/avatars/ images/news/ images/news_cats/ images/photoalbum/ images/photoalbum/submissions/ forum/attachments/ config.php 4. Goto your website, setup.php should start automatically, if it does not appear you should run setup.php manually by entering your full site url followed by /setup.php. Example: http://www.yourdomain.com/setup.php. 5. Complete the setup process by following all on-screen prompts. 6. Immediately after completing the installation of PHP-Fusion you must CHMOD config.php back to 644 AND delete setup.php from your web-server.
3. Upgrade from v6.00.1xx, v6.00.2xx or v6.00.3xx
Before you upgrade we strongly recommend that you backup your files and your database as PHP-Fusion 6.01 is a major update compared to its predecessors. You need to follow these instructions precisely. 1. First you must upload the correct upgrade script from the folder named 'upgrade v6.00.xxx' to the administration folder of your site. 2. Login to your site as the Super Administrator. Under the System Admin tab of the Admin Panel, click on Upgrade then click the button marked Upgrade. MAKE SURE the page reloads stating 'Database upgrade complete', failure to do so may cause problems later on. 3. 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. YOU MUST upload ALL of the files from the php-files folder. Failing to upload all of the files will cause one or more of the following problems: no admin access, lower-center and right side panels mixed up, new gallery not working and more. 4. The photo gallery in v6.01 has been completely rewritten. We have created an infusion called 'Photo Converter' which will import your albums and photos into the new database tables. You should ONLY use the Photo Converter Infusion AFTER completing the above steps. It is designed to run under specific conditions which are created by the upgrade script and therefore will not work prior to upgrading. Be sure to verify the new Photo Settings under System admin before running the Photo Converter. 5. After completing the above steps, you need to chmod the folder images/photoalbums/submissions to 777. You may also want to add a link under System Admin -> Site Links entitled 'Submit Photo' with the url set to 'submit.php?stype=p'. If at all you are any doubt please feel free to ask one of our support sites for help, there are plenty of knowledgeable users in our community who can help or advise you regarding the upgrade process.
4. Security tips
Here are some useful tips to help keep your site secure: Ensure config.php is not writable (should be CHMODed to 644). Never leave setup.php on your server once PHP-Fusion is installed. Always ensure your FTP and MySQL passwords are different. Never allow forum attachments such as php, html, exe, or any type of text file.
5. Support sites
If you have any questions or problems regarding PHP-Fusion, please visit the main development site at www.php-fusion.co.uk and post a message on our forums. Alternatively you can visit our IRC chat support channel at irc.outerweb.org/phpfusion. PHP-Fusion can be expanded by adding Infusions, these are plugins which are extremely easy to install. You can find a variety of useful Infusions on our mod site at www.phpfusion-mods.com. If you are not satisfied with PHP-Fusion's bundled themes you may want to visit our official theme site at www.phpfusion-themes.com where you will find a variety of high quality themes. PHP-Fusion also has a number of official foreign language support sites based in Arabia, Belgium, Bulgaria, Bosnia, Croatia, Denmark, France, Germany, Hungary, Iran, Italy, Lithuania, Netherlands, Poland, Russia, Sweden, Taiwan, and Turkey
6. Acknowledgements
Thanks to the following for their additional work: Shedrock - Additional Themes and administration icons Janmol - Market research & additional design concepts KEFF - For silly ideas that aren't actually silly! Rayxen - Additional code & mods Sheldon - Tech support & additional hosting 3rd Party Scripts: TinyMCE v2.0.6.1 - A HTML WYSIWYG editor by Moxiecode. PHPMailer - A sendmail class with SMTP support by Brent R. Matzelle. HTTPDownload - A download handler class by Nguyen Quoc Bao.