Empathy

1. Setup

Empathy works best when you are using a single location for PHP libraries. This is configured using the include_path directive. (See PHP documentation.) This documentation will assume you are using the default location /usr/share/php.

1.1 Install spyc

# cd /usr/share/php
# wget http://spyc.googlecode.com/files/spyc-0.4.5.zip 
# unzip spyc-0.4.5.zip
# ln -s spyc-0.4.5 spyc

1.2 Install Smarty

# cd /usr/share/php
# wget http://www.smarty.net/do_download.php?download_file=Smarty-2.6.26.zip
# unzip Smarty-2.6.26.zip
# ln -s Smarty-2.6.26/libs Smarty

1.3 Install Empathy

# cd /usr/share/php
# wget http://www.mikejw.co.uk/files/empathy-pr.zip
# unzip empathy-pre.zip
# ln -s empathy-pre/lib Empathy

1.4 Setup 'eaa' (Empathy Application Architype). (Assuming /var/www is document root.)

# cd /var/www
# cp -r /usr/share/php/empathy-pr/eaa ./e_test
# cd e_test
# cp config.yml.sample config.yml
# cd public_html
# cp htaccess .htaccess
# cd ../application
# cp CustomController.php.sample CustomController.php
# cd ../tpl
# chmod 777 templates_c

Try navigating to 'http://localhost/e_test/public_html' at this point. It all depends on how Apache has been set up. It's unlikely you will see anything so try editing the following:

• - DOC_ROOT and WEB_ROOT/PUBLIC_DIR settings in config.yml. DOC_ROOT is the absolute path to the application in the filesystem and WEB_ROOT/PUBLIC_DIR is used to store the location to the root of the application as served by Apache.
• - RewriteBase in the .htaccess file. This should reflect WEB_ROOT/PUBLIC_DIR except that the hostname is not required. Eg. /e_test/public_html/ implies http://localhost/e_test/public_html/.

Is it working now? Try navigating to http://localhost/e_test/public_html where you should see the message, This is an Empathy application. So that's it. Creating new projects is exactly the same process although you obviously might be looking to make heavier customisations.

Note that the NAME of your app within config.yml will determine the name of your main global stylesheet according to the default header template. For example, 'eaa.css'. The default header also attempts to include a stylesheet using the current module name as a prefix. Eg. 'front.css'.