PHP-Fusion Readme

INTRODUCTION - PHP-Fusion 9

PHP-Fusion is an all in one integrated and scalable platform that will fit any purpose when it comes to website productions, whether you are creating Business sites, Community portals or Personal sites.
Founded as an open source project under the GNU AGPL v3, PHP-Fusion is licensed to be open and free to use.

Derivative codes must be shared unless we grant you a license to waive the AGPL agreement.
This is what we believe gives the best possible protection for both PHP-Fusion and all the Developers that creates Addons for PHP-Fusion.

Feel free to post any questions or report any problems in our forums over at PHP-Fusion Main.
For License questions you can visit our License section.

This software package is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License (AGPL) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This software package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this software package. If not, see www.fsf.org.

Warning
You are breaking international law if you remove our footer copyright notice without a valid license:

Powered by PHP-Fusion copyright © 2015 PHP-Fusion Inc.
Released as free software without warranties under GNU Affero GPL v3.

For copyright removal options please refer to our license information page at www.php-fusion.co.uk.

Some Key Features

PHP-Fusion Defender
Automatic form sanitation system for your fields with form token support.

PHP-Fusion Dynamics
Automatic form API & database handler system.

Dynamic User Fields
Arrange, connect to 3d party and even categorize your Users Profiles with tabs.

Model > View Templating
MVT are enabled for most Core content and Core Infusions. All Themes are able to change individual Core components and Infusions layout with this system.

SEO Engine
Permalinks,SEO URLs & Normalize functions. A Modular system that allows you to change and add to the output of how you want your Permalinks.

DatabaseFactory
Optimized OOP based Database handling that provides support for multiple database connection instances at once with either PDO or MySQL drivers enabled.

Atom Theme Engine
CSS Overrides for any given Theme for it´s default CSS classes.

Notification email templating
Enabled for contact, forum notifications and PM emails.

Responsiveness
Mobile & Pad friendly with native Bootstrap enabled in the system by default.

GeoMap
Country > State selector with 250 Countries and 6832 States.

Multilingual Core Capabilities
Instanced format with exclusion,inclusion options.

UTF-8
UTF-8 are standard for both for databases and charsets.

Portable & Multisite
You can have gathered landing pages with multisite functions.

BBCodes
A BBCode system that is modular and flexible.

Smileys
A Smiley system that is modular and flexible.

The Core Includes

PHP-Fusion includes the most common features you would expect to see in a CMS.

Private Messaging
A complete message system between users.

Photo Gallery
A complete Photogallery system for photo handling.

Custom Pages
A database driven content section for your convenience.

FaQ System
Fast and simple Frequently Asked Questions system.

Vote Polls
A neat little panel with your pools for the users.

Web Links
Web links directory for your collection.

Forums
A complete Forum system with tons of features.

Forum Polls
A Poll system for the Forums.

Forum Ranking
A Rank system for the Forums.

Downloads
A complete Download system.

Articles
A simple system for content publishing.

Welcome Message
A panel with customized welcome messages.

Blog
A complete Blog system with Archive Panels.

News
A complete News system for News publishing.

Shoutbox
Send messages on a front panel.

RSS Feeds Panel
A complete RSS feeds system for Blog, News, Forum, Downloads and Articles.

Latest Comments Panel
A listing of latest comments made to various content on site.

Online Users Panel
Displaying users online.

Features such as User, Administrators, User Groups managing and so forth are all available.
Some key features such as Private Messages and Custom Pages are automatically installed.
The rest of the above are only installed by your choice, we have however made it available with Core.
For more detailed Documentation please visit PHP-Fusion Main

GENERAL INSTALLATION AND GUIDELINES FOR MANUAL INSTALLATION

Requirements for this version

- PHP 5.3 or higher
- MySQL 4.1 or higher

You have 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, user name, password and database name as you will need to specify these during setup.

1. Upload the contents of the files folder to your web server.

2. Unless you run PHP-Fusion on a local server, in most cases you will need to CHMOD the following files and folders to 777:

administration/db_backups/
ftp_upload/
images/
images/imagelist.js
images/avatars/
robots.txt
config.php

Infusions shipped with the Core requires the following folders to be CHMODed to 777

/infusions/blog/images/
/infusions/blog/images/thumbs/
/infusions/blog/blog_cats/
/infusions/downloads/files/
/infusions/downloads/images/
/infusions/downloads/submissions/
/infusions/downloads/submissions/images/
/infusions/forum/attachments/
/infusions/news/images/
/infusions/news/images/thumbs/
/infusions/news/news_cats/
/infusions/gallery/photos/
/infusions/gallery/photos/thumbs/
/infusions/gallery/submissions/
/infusions/gallery/submissions/images/

Note:
Some hosts does not allow CHMOD 777, in that case you can use CHMOD 755 if CHMOD 777 fails.

3. Go to your website where install should start automatically. If not, you should run the installer manually by entering your full site url followed by /install/index.php Example: http://www.yourdomain.com/install/index.php.

4. Complete the setup process by following all on-screen prompts.

5. After completing the installation of PHP-Fusion you must CHMOD config.php back to 644.

LOCAL INSTALLATION

To install and work with a local copy of PHP-Fusion you can download a copy of XAMPP for your given environment ( Windows, Linux or Mac ).

UPGRADE FROM V7.02.07

Before anything we strongly recommend that you backup your files and your database.
PHP-Fusion 9 is a major update from PHP-Fusion 7.02.07.

Make sure that your hosting environment meets the requirements for this version:
- PHP 5.3 or higher
- MySQL 4.1 or higher

This upgrade procedure can be very demanding depending on how much content your have.
User Fields will not be upgraded. A New set of standard fields will be installed instead.( This can change )

PHP-Fusion 9.0 is for most parts compatible with version 7.02.07,
however be ready for issues and re-populate your site with older Addon content slowly.
There have been a massive amount of changes to all Core systems, meaning that some Addons Mods, Infusions, Panels or Themes may not work properly.

The upgrade will be in two steps

You need to follow these instructions precisely.

Step 1

1 · You must first upload the upgrade script from the folder named upgrade 7.02.07 to 9.0
The content in administration folder goes to the content in your sites administration folder.
The content of locale folder goes to the root of your site´s locale folder.
Replace all files when requested.

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. YOU MUST perform the upgrade first of all.
The upgrade process will automatically complete.
When you see your maintain mode screen, the site is ready for stage 2.

Step 2

1 · Since we drop user fields the folder images/avatars can be truncated

2 · Delete all files in your Infusions folder ( remember to save what need to be saved )

3 · Upload the PHP-Fusion 9s infusions folder content to your now empty infusions folder

4 · Images in the images folder from articles can remain if you want. But if you move it to the new infusions/articles/images folder you also need to edit your articles using them.

5 · Images in the images folder from news can remain if you want. But if you move it to the new infusions/news/images folder you also need to edit your news items using them.

6 · News category images are more tricky if you have your own customized categories. We recommend that you move images/news_cats to infusions/news/news_cats and manually edit each news cat your have from the administration to attach your images to these with it´s new paths.

7 · Images/ranks have been moved to infusions/forum/ranks any customized ranks need to be manually moved to here and then edit each rank to match the new paths.

8 · Assuming that you followed the above procedure you can now remove all old PHP-Fusion files except forum/attachments, images, infusions folders, config.php and the new .htaccess file.

9 · Upload the complete PHP-Fusion 9 pack to your server.

10 · When the upload is complete,
Go back to your Administration > System Administration > Upgrade
You can now click Migrate Albums to 9 folder and Migrate forum attachments to 9 folder.
Click on them in any order but wait for the scripts to finnish.
Depending on content each proccess can take quite a while.

CHMOD the following files and folders to 777:

/infusions/blog/images/
/infusions/blog/images/thumbs/
/infusions/blog/blog_cats/
/infusions/downloads/files/
/infusions/downloads/images/
/infusions/downloads/submissions/
/infusions/downloads/submissions/images/
/infusions/forum/attachments/
/infusions/news/images/
/infusions/news/images/thumbs/
/infusions/news/news_cats/
/infusions/gallery/photos/
/infusions/gallery/photos/thumbs/
/infusions/gallery/submissions/
/infusions/gallery/submissions/images/

Your site should now be fully upgraded and ready to run PHP-Fusion 9, do not forget to lift the Maintenance mode. (Admin Dashboard > Settings > Security Settings).

In order to further optimize your site you can enter the System Administration > Infusions and defuse the Infusions that are of no use to you.

If you have any questions please feel free to ask for help in our Support Forums.

SECURITY TIPS

Set Allow PHP Execution set to No and store your custom codes in files instead of database.
Ensure config.php is not writable (should be CHMODed to 644).
Always ensure your FTP and MySQL passwords are different.
Never allow forum,download attachments such as php, html, exe, or any type of text file.
Only use Addons that have been tested and approved as safe.

SUPPORT

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 support forums. We have a helpful community.

Addons: PHP-Fusion's features can be expanded by adding Infusions, these are plugins which are extremely easy to install. You can find a variety of useful Infusions in our AddonDB.

If you are not satisfied with PHP-Fusion's bundled themes or if you simply want a more uniqe look to your site you can find a large variety of high quality themes also in our Themes category.

PHP-Fusion also have a number of official translations.
You can find our translations at PHP-Fusion Main in the Language Packs section.

Vulnerabilities

If you find any security issues please mail these to management@php-fusion.co.uk.

Additional Documentation

For more documentation please visit PHP-Fusion Main and click on the various Documentation sections from the documentation menu that suit your needs.

ACKNOWLEDGEMENTS

Project Manager
Joakim Falk {Domi}
domi@php-fusion.co.uk

Lead Developer
Frederick MC Chan {hien}
hien@php-fusion.co.uk

A special thank you goes in no particular order to ,

Robert Gaudyn {Wooya} - Inspired Multilingal features, Initial Panels Admin handler design, RSS Panel, Panel positioning ideas, New user info panel base layout.
Ankur - Initial design SEO Engine.
Rizado - Locale, User Fields, Date/Time system, Translate system.
Rimelek - Database Factory, Improvements on Defender, Dynamics.
Tyler Hurlbut - Initial design for Fusion Dynamics, and jQuery output handler.
JoiNNN - Initial design Token framework, Improvements on Defender and Dynamics.
Craig - Initial design for Septenary Theme.
Marcus G - Initial design email template system.
dialektika - Multiple fixes provided.
Jugolo - Multiple fixes provided.
Dahlgren - Multiple fixes provided.
WuChEn - Multiple fixes provided.
Talocha - Multiple fixes provided.
Brendan Scarvell - XSS issues with live examples provided.
Dennis Vorpahl - Multiple fixes provided.
janmol {Jan.M} - Beta testing and error reporting.
Kvido - Beta testing and error reporting.
Alex L - Beta testing and error reporting.
karrak - Beta testing and error reporting.

A special thank you to all who have helped with locale translations.
It is very hard to list everyone that contributes to locales.
Some do full translations while others do some minor adjustments either by forums or directly by github.
Remember to give your self credits in the global.php as the inital locale author.