Introduction

If you plan on contributing patches, and making modifications to the system it is best to set up a test environment so you can modify code and build test releases.

Details

System requirements:

• Apache
• PHP 5
• PEAR CLI
• MySQL
• SVN

Recommended IDE: Eclipse with PDT

Check out source from SVN repository

See this page for info: http://code.google.com/p/unl-event-publisher/source/checkout

Checkout of each of the three modules in the svn repo -

svn checkout https://unl-event-publisher.googlecode.com/svn/UNL_UCBCN/trunk UNL_UCBCN
svn checkout https://unl-event-publisher.googlecode.com/svn/UNL_UCBCN_Manager/trunk UNL_UCBCN_Manager
svn checkout https://unl-event-publisher.googlecode.com/svn/UNL_UCBCN_Frontend/trunk UNL_UCBCN_Frontend

Install the packages using your local checkout

You should only have to do this step once

pear upgrade pear
pear config-set preferred_state beta
pear channel-discover savant.pearified.com
pear channel-discover pear.unl.edu
pear install MDB2_Driver_mysqli-beta
pear install UNL_UCBCN/package.xml
pear install UNL_UCBCN_Manager/package.xml
pear install UNL_UCBCN_Frontend/package.xml

Once you make changes to the source, upgrade the packages using:

pear upgrade -f UNL_UCBCN/package.xml
pear upgrade -f UNL_UCBCN_Manager/package.xml
pear upgrade -f UNL_UCBCN_Frontend/package.xml

Run the post-install scripts

If you modify the templates for the Manager or Frontend components, you'll need to run their respective post install scripts to copy the template files into the deployed directories.

You should only need to run the post-install script for the 'backend' if you modify the database.xml file to make database modifications.

pear run-scripts unl/UNL_UCBCN
pear run-scripts unl/UNL_UCBCN_Manager
pear run-scripts unl/UNL_UCBCN_Frontend

Oh, and bring down a copy of the /ucomm/templatedependents/ as well.

Scripting the install/upgrade process

The install or upgrade process can be automated by using a simple shell script similar to the following. Modify the run_package_scripts.php file with answers corresponding to your local environment.

rm UNL_UCBCN/package.xml
rm UNL_UCBCN_Frontend/package.xml
rm UNL_UCBCN_Manager/package.xml

svn checkout http://unl-event-publisher.googlecode.com/svn/trunk ./

cd UNL_UCBCN
php makepackage.php make
pear upgrade -f --nodeps package.xml
cd ..

cd UNL_UCBCN_Manager
php makepackage.php make
pear upgrade -f --nodeps package.xml
cd ..

cd UNL_UCBCN_Frontend
php makepackage.php make
pear upgrade -f --nodeps package.xml
cd ..

php run_package_scripts.php

Providing Patches

Please provide patches using svn diff or diff -u originalfile modifiedfile