PHP-Fusion Readme











Copyright © 2002 - 2006 Nick Jones
Version: 6.01.12 - Released: 16/10/2007



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.