Read Me

          Installation Notes for easy-CMS 
              released under GNU/GPL 
          Cedric Francoys, september 2008
===================================================


CONFIGURATION
-------------

Minimum requirements
MySQL >= 3.23 
Apache >= 1.3.27
PHP >= 4.3.3

easy-CMS has been successfully tested with the following configurations:

Apache 1.3.27, 1.3.33, 1.3.37
Mysql 3.23.58, 4.0.24
PHP 4.3.3, 4.3.9, 4.3.10

Firefox 1.0, 1.5, 2.0, 3.0
Internet Explorer 6.0, 7.0


Notice : 
easy-CMS uses the sablotron and gd2 libraries, so you will have to check the following: 

PHP must have been compiled with xslt :
	* PHP 4 
	PHP must have been compiled with the options '--enable-xslt', '--with-xslt-sablot'
	php-xslt extension must have been enabled :
		under Linux :
		     install the php4-xslt package
		     install the php4-gd2 package

		under Windows :
		     1) copy sablot.dll, expat.dll and iconv.dll from the DLL folder of PHP/Win32 into the SYSTEM32 windows directory.
		     2) edit php.ini, and remove the ";" at the begining of the lines "extension=php_xslt.dll" and "extension=php_gd2.dll"

	* PHP 5 
	PHP must have been compiled with the options '--enable-xslt', '--with-dom',  '--with-dom-exslt', '--with-dom-xslt

In addition, the following options could also be needed :
'--with-gd', '--enable-gd-native-ttf' and '--enable-gd-imgstrttf'


For more details, see http://pl2.php.net/manual/en/ref.xslt.php 


PRE-INSTALLATION
----------------

1. extract files from the tarball into a web directory 
(example : /home/www/yoursite)

2. ensure that the apache process have write permission on that directory 
(example : chmod 777 /home/www/yoursite)

3. optional : configure the apache httpd.conf file in order to add the new web site and restart apache (*)

4. browse to the newly created website : you'll be redirected to the installation script



INSTALLATION
------------

Before installing this software, you must read and agree with the terms and conditions mentioned in the license.txt file.

A. Using the UI

Browse to the root of you new website. Then the install script should start automatically. 
At the end of the installation process, simply click the 'finish' button to go to the homepage.

If something doesn't work or if you get error messages your are unable to solve, you may try to install the CMS manually.


B. Manual installation
Create a new database.
Populate that database using the easycms_new.sql file.
Copy the file install/config.inc.php to /config.inc.php, edit that file and change the vars to the required values (DB access information).



POST-INSTALLATION
-----------------

Upload capabilities notes

You may want allow biger size for file upload.
Then you can modify the allowed size for uploaded files in the php.ini file:

; Maximum allowed size for uploaded files.
upload_max_filesize = 250M

; Maximum size of POST data that PHP will accept.
post_max_size = 250M




Visit http://www.easy-cms.be for more information.


easy-CMS integrates third-party open-source components : 
- FCKeditor (GPL - Frederico Caldeira Knabben - http://sourceforge.net/projects/fckeditor/)
- JUpload (GPL - Etienne Gauthier - http://sourceforge.net/projects/jupload/)
- easy-GUI (GPL - Cedric Francoys - http://sourceforge.net/projects/easy-gui/)
- silk icon set (CC - Mark James - http://www.famfamfam.com/lab/icons/silk/)
- md5.js (BSD - Paul Johnston - http://pajhome.org.uk/crypt/md5/)
- prototype.js, effects.js, slider.js (MIT - Thomas Fuchs - http://script.aculo.us)