PHP-Fusion Readme

Copyright © PHP-Fusion Inc
Version: 8.00.50 - Released: 2020/06/20

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.gnu.org.

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

The footer are expected to look like the following example with the link to us intact,

Powered by PHP-Fusion Copyright © 2020 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.

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

Custom Themes Engine
Both for admin area and front.

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

Multilingual Core Capabilities
Instanced format with exclusion,inclusion options.

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

User Fields
Custom User Fields are easy with 8.

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.

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.

Requirements for this version

Software	Version
PHP	5.6.40 or higher
MySQL	5.6 or higher
Apache	2.2 or higher
Nginx	1.0 or higher
mod_rewrite or equivalent for SEO

If you have any addons or locales you need to convert all your locales and addon files to UTF-8 without BOM.

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/
images/
images/imagelist.js
images/avatars/
robots.txt

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

images/blog/images/
images/blog/images/thumbs/
images/blog/blog_cats/
downloads/
downloads/images/
downloads/submissions/
downloads/submissions/images/
forum/attachments/
images/news/images/
images/news/images/thumbs/
images/news/news_cats/
images/photoalbum/
images/photoalbum/submissions/

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 /setup.php Example: http://www.yourdomain.com/setup.php.

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

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

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

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

This upgrade procedure can be very demanding depending on how much content your have.
If this procedure timeout or crash you need to manually disable the UTF-8 conversion script or if you can, raise the time of allowed PHP and SQL execution.
You disable the UTF-8 char conversion function by opening /administration/upgrade.php, line 176 change disabled = FALSE to disabled = TRUE.

PHP-Fusion 8.0 is compatible with version 7.02.07,
There have been a massive amount of alterations and additions to the Core systems, meaning that some Addons Mods, Infusions, Panels and Themes may need some alterations to work as intended with the system.

The upgrade will be in a few steps

You need to follow these instructions precisely.

Step 1

1 · You must first upload all PHP-Fusion 8 files in the Upgrade_7.02.07_8.xx. Replace all files when requested.
2 · If your site is in English, navigate to your site's www.site.com and enter your Administration panel
Go to System Admin > Upgrade and follow the instructions.
If you upgrade from another language, make sure that you first translate the files in Upgrade_7.02.07_8.xx/locale and replace the news ones in your v7 installation folders.
When that is completed, Go to System Admin > Upgrade and follow the instructions.

Step 3
Once the database have been upgraded, copy all files and replace existing.

Step 4
Convert all your locales and addon files to UTF-8 without BOM.
Make sure that you also update your locales global.php and change charset from iso to utf8 ( $locale['charset'] = "utf8" ).
Notepad++ Can convert files if you do not find a good batch tool for this.

Step 5
If you do not run the site in English.
Synchronize you languages locale with the English set of locales before you start using the site to void errors.
You can simply open the English locale folder and compare to yours for missing files and changes.
We can recommend Notepad++ that have a compare files tool for example.
Open 1 English file and then your matching locale in window 2 press CTRL+ALT+C,repeat for each file.
We also have a compare tool available in the PHP-Fusion locales forums > Compare Tool.

Your site should now be fully upgraded and ready to run PHP-Fusion 8.

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

Before anything we strongly recommend that you backup your files and your database.

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

The upgrade will be in a few steps

You need to follow these instructions precisely.

Step 1

1 · You must first upload all PHP-Fusion 8 files in the Upgrade_8.00.00_8.XX.XX.
Replace all files when requested.
2 · Navigate to your site's www.site.com and enter your Administration panel
When the file copy is completed, Go to System Admin > Upgrade and click upgrade.

Step 3
Once the database have been upgraded, copy all files and replace existing files.

Your site should now be fully upgraded and ready to run the next version of PHP-Fusion 8.

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

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 from our Marketplace.
Update your PHP-Fusion version when a new is released.

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 unique 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.

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

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

Project Manager - CEO
Joakim Falk {Falk}
falk@php-fusion.co.uk

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

A special thank you goes in no particular order to,

RobiNN - Development Manager.
karrak - Solid Core Senior Developer.
Ankur - Initial design SEO Engine.
Robert Gaudyn {Wooya} - Inspired Multilingal features, Initial Panels Admin handler design, RSS Panel, Panel positioning ideas, info panel base layout.
Marcus G - Initial design email template system.
janmol {Jan.M} - Beta testing and error reporting. (RiP)
helmuth - Beta testing and error reporting.
Kvido - Beta testing and error reporting.
Alex L - Beta testing and error reporting.
Wanabo - Multiple fixes provided.
SuNflOw - Multiple fixes provided.
Dennis Vorpahl {Webmeteor} - Multiple fixes provided.
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.
JoiNNN - Multiple fixes provided.
MiChAeLoKGB - BBCode Fixes provided.
Keddy - Multiple fixes provided.
ctokepa - Multiple spelling issues adjusted.
ferdi - Logo.

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 initial locale author.