Phire CMS : Open Source Content Management System

Documentation : Installation : Let's Go!

Before we begin, you should know that everything is self-contained with the within the archive folder and is able to run directly from that folder. By default, the system is configured like so:

/phire-cms-1.0                   (BASE_PATH)
/phire-cms-1.0/phire             (SYS_PATH)
/phire-cms-1.0/phire-content     (CONTENT_PATH)

If you wish to place the system in a different location, you simply have to alter the folder settings in the config.php file. Also, you will have to make sure the 'require_once' line is set properly in the system index.php controller file and reflects your new system folder location, for example:

require_once 'YOUR_NEW_SYSTEM_FOLDER/bootstrap.php';

And, if you wish to simply place the system in the document root, so it's accessible via http://www.yourdomain.com/phire/, you simply have to move the system into the document root and set the BASE_PATH to null.

Basic Installation

Phire CMS just requires a few easy steps to install. (This example assumes the original folder structure out of the archive file):

Unpack the archive file and move the contents to your desired location.
Copy the file /phire-cms-1.0/phire/config.orig.php to /phire-cms-1.0/phire/config.php and set your database credentials and folder settings in that file accordingly.
Make sure the content folder (/phire-cms-1.0/phire-content by default) and everything below it is writable.
You're now ready to install Phire CMS. Simply go to the following URL and follow the steps: http://www.yourdomain.com/phire-cms-1.0/phire/install/

Installing an Additional Site

One of the strengths of Phire CMS is the ability to install and manage multiple sites from the same admin interface. To install an additional site, simply unzip the included archive file, newsite-1.0.zip, into the additional site's document root. The folder structure of the new site has to follow the same folder structure as the main site. Please follow the instructions in the included README.TXT file for more information

However, in order for Phire CMS and the multiple site feature to work properly, there must NOT be any directory access restrictions (i.e., PHP's open_basedir flag) between the where Phire CMS is installed and where the additional sites are located.

A Note About URL Rewrites

If you're using Apache, then the .htaccess file should take care of everything for you. However, if your server uses another web server platform, such as Microsoft IIS, make sure you have an appropriate rewrite filter or module installed. For Microsoft IIS, we recommend the Ionics Isapi Rewrite Filter. It is open-source, works really well and Phire CMS has been tested for it in the Windows/IIS server environment. You can download it here:

http://iirf.codeplex.com/

There is an example INI file IsapiRewrite4.ini included in the archive folder that should work with the Ionics Isapi Rewrite Filter.

Whether you choose to use the IIRF rewrite filter for IIS or another rewrite filter for a different web server platform, the end result of the rewrite should be:

index.php?query=/original-url

- OR -

index.php?query=/original-url&other;=123

(Maintaining any additional $_GET queries.)

Using WYSIWYG Content Editors

Support is built-in for the following popular WYSIWYG content editors:

CK Editor (http://ckeditor.com/)
TinyMCE (http://tinymce.moxiecode.com/)

Simply download your preferred editor (or both!) and install them to the following folders, respectively:

/phire/core/scripts/ckeditor
/phire/core/scripts/tinymce

The system will automatically scan for those folders and activate whichever editor (or editors) you have installed. You will then be able to select a default editor under the configuration control panel or "on-the-fly" as you are editing the content of a page.

CKEditor Issue: If you install CKEditor, you may have to alter the main JS file to allow for scrollbars with in the system's file and image browser window.