ColdFusion on Wheels provides fast application development, a great organization system for your code, and is just plain fun to use.
One of our biggest goals is for you to be able to get up and running with Wheels quickly. We want for you to be able to learn it as rapidly as it is to write applications with it.
In this Beginner Tutorial: Hello World, we'll be writing a simple application to make sure we have Wheels installed properly and that everything is working as it should. Along the way, you'll get to know some basics about how applications built on top of Wheels work.
We encourage you to contribute to ColdFusion on Wheels! Please check out the Coding Guidelines for guidelines about how to proceed. Join us!
If you would like to contribute or update doumentation, you can edit the guides located in wheels/docs.
NOTE: When writing or updating documentation for the API themselves, update the documentation
directly in the associated method and NOT in the wheels/docs/Wheels API directory. Afterwards, run
the documentation generator (this will update the wheels/docs/Wheels API directory automatically) and
commit your changes. See the Generating API Documentation section of this README for more information.
Note: CFWheels uses RocketUnit as its testing framework.
Before running tests, make sure that all debugging is turned OFF. This could add a consideral amount of time for the tests to complete and may cause your engine to become unresponsive.
- Create a database on a supported database server name
wheelstestdb. At this time the supported database servers are H2, Microsoft SQL Server, Oracle, PostgreSQL, MySQL. - Create a datasource in your CFML engine's administrator named
wheelstestdbpointing to thewheelstestdbdatabase and make sure to give it CLOB and BLOB support. - Open your browser to the CFWheels Welcome Page.
- In the grey debug area at the bottom of the page, click the
Run Testslink next the version number on theFrameworkline.
Please report any errors that you may encounter on our issue tracker. Please be sure to report the database engine (including version), CFML engine (including version), and HTTP server (including version).
Note: The build script has only been tested against Railo 3.3.0.007 or higher at this time.
- Make sure the URL rewriting is OFF
- Open
wheels/version.cfmfile and edit the version to correspond with the build. - Update
wheels/CHANGELOGto reflect version and build date. - Click the
Generate Releaseon the Framework line in thegrey debug area - The build will create a zip file named
cfwheels.<version>.zipinbuilders/output/releasedirectory of the repo. - Annouce and post the build to the Core Team.
Note: The API generation script has only been tested against Railo 3.3.0.007 or higher at this time.
It is important to repeat again that all documentation pertaining to methods should be done directly
in the source code itself and NOT in the wheels/docs/Wheels API directly as any changes will be
overwritten when the API generator is ran again.
- Make sure the URL rewriting is OFF
- Click the
Generate Documentationon the Framework line in thegrey debug area - The generator will automatically create all the pages for the Wheels API in
wheels/docs/Wheels API - A
cfwheels-api.xmlXML file will be created in thebuilders/output/docsdirectory. This can be used to create a syntax or code hinting library for Wheels for your favorite editor.
You may overload or overwrite any of the outputted API documentation by adding to the
builders/api/overload.cfm. A diagram of the generated API structure is provided in the document.
You will need a Markdown viewer in order to view the documentation locally. If you use Google Chrome, you can install the Markdown Preview extension.
ColdFusion on Wheels is released under the Apache License Version 2.0.