INSTALL

===============================
phundament - website components
===============================


R E Q U I R E M E N T S
-----------------------
- any PHP compatible Webserver (as long as Prado runs on it)
- PHP 5 (CLI Version required for Installer)
- Extensions: DOM, SPL, CType, PCRE
- ImageMagick (recommended)
- GDlib (recommended)
- SQLite (recommended)
- APC, XSL (recommended)
- MySQL (optional)
- PDFlib (optional) *see lithron
- an SVN client (optional)



I N S T A L L A T I O N
-----------------------

** CHECK http://phundament.com for the latest information **


UNIX / Linux / Mac OS X
-----------------------

Download
--------

+---+
| 1 | Download from http://sourceforge.net/project/showfiles.php?group_id=116928
+---+

+---+
| 2 | Extract with presevere permissions (e.g. tar -xzpf phundament.tar.gz)
+---+

+---+
| 3 | Open index.php in your browser (check path permissions if you see an exception)
+---+


Checkout SVN
------------

Get lithron, by checking out our project template from svn:
$ svn co https://diemeisterei.homeunix.net/projekte/_phundament_ WEBSITE_ROOT
or get a full lithron package from sourceforge and extract it, recommended:

+---+
| 1 | svn co https://lithron.svn.sourceforge.net/svnroot/lithron/template myProject
+---+

Bootstrap lithron with phing. This action will create the needed directories
and permissions.
And will also create a SQLite database per default with demo data 
(Note: you may use some demo data. cd website_root/var; ln -s dataxml.demo dataxml;)
Simply open index.php in your browser to obtain the full command (copy & paste).

+---+
| 2 | $ WEBSITE_ROOT/lib/installer/build -q bootstrap
+---+

If the installation has completed,

+---+
| 3 | open lithron/index.php in your browser
+---+



Windows (untested)
------------------

Prerequisities:
- I had to download MSVCR71.dll from http://dll-files.com
- Install ImageMagick from http://imagemagick.org
- Add ImageMagick path to application.xml

+---+
| 1 | Download & extract from http://sourceforge.net/project/showfiles.php?group_id=116928
+---+

Bootstrap lithron with phing. This action will create the needed directories
and permissions.
And will also create a SQLite database per default with demo data.
Simply open index.php in your browser to obtain the full command.

+---+
| 2 | $ cd WEBSITE_ROOT/lithron/developer/installer/
+---+ $ build.bat -q bootstrap


If the installation has completed,

+---+
| 3 | open lithron/index.php in your browser
+---+




T R O U B L E S H O O T I N G
-----------------------------

If this quick-install fails, make sure you get a valid PHP 5 CLI response, when
doing a 'php -v' on the shell (workaround: export PHP_COMMAND=/usr/bin/php5.0)

After executing the quick-install script, the following directories should be
writable for the webserver process:
- config/runtime
- var/[subfolders]
- public/[subfolders]
And the LPE files & folders should be linked into lithron/application/application.xml
and so on.

If your webserver uses a dual PHP4/5 Setup, remember to rename Lithrons index.php to
whatever extension will get executed by your PHP5 (most probably .php5).

If you want to use Image-Magick, make sure that identify and convert are either in
path or configured in config/application.xml. To make use of Image-Magick's PDF
capabilities, a working Ghostscript-Interpreter (gs) must be in PHP's executable path.




L I C E N S E
-------------
http://opensource.org/licenses/mozilla1.1.php Mozilla Public License



C O N T A C T
-------------
dev@lithron.de
http://www.phundament.com