PureMVC Standard for ColdFusion

Prerequisites

• Adobe ColdFusion 8
• CFUnit v2.0 Beta 4 (only required if running unit tests)

STEP 1 Install the Source Code

• Download the latest source code archive.

[SCENARIO 1]

The quickest and easiest way to install the framework is to extract the contents of the PureMVC_CF.zip into the root of your website. So, if your site root is located at 'C:\ColdFusion?8\wwwroot\' then extract the contents of the zip under wwwroot. You should see the folder "PureMVC_CF_X_Y" listed under site root. Move the contents of the "PureMVC_CF_X_Y" into your site root. You should now see the folders listed below under your site root. Delete the "PureMVC_CF_X_Y" folder since it is no longer required.

• cfcdoc - API Documentation
• org - Framework classes.
• test - Framework Unit Test classes.

[SCENARIO 2]

You can configure ColdFusion mappings to access the framework using the ColdFusion Administrator.

• Extract the contents of the PureMVC_CF.zip into any preferred location outside your site root.
• Login to the ColdFusion Admin and create a mapping named "org", which points to the location of the "org" folder you extracted from the PureMVC_CF.zip archive. Do the same for "test" if you plan on running the unit tests.

To run the unit tests or if you will be contributing to the code base you must configure your development environment to use CFUnit for unit testing. Proceed to STEP 2. if not, then you can simple delete the "test" folder.

STEP 2 - Install CFUnit

• Download CFUnit v2.0 Beta 4 at ( http://cfunit.sourceforge.net/)

[SCENARIO 1]

The quickest and easiest way to install CFUnit is to extract the contents of the CFUnit archive into the root of your website. So, if your site root is located at (C:\ColdFusion8\wwwroot\) then extract the contents of the CFUnit archive under wwwroot. As long as it is accessible when accessing your website all things should work as expected. You should have a folder named "net" under your site root (C:\ColdFusion8\wwwroot\net).

[SCENARIO 2]

You can configure ColdFusion mappings to access CFUnit using the ColdFusion Administrator.

• Extract the contents of the CFUnit archive into any preferred location outside your site root.
• Login to the ColdFusion Admin and create a mapping named "net", which points to the location of the "net" folder you extracted from the CFUnit archive you downloaded above.