******************************************************************************************* * * * cfExt v 0.4 * * * ******************************************************************************************* Introduction ------------------------------------------------------------------------------------------- cfExt is a ColdFusion wrapper class to the Ext JavaScript Library. The release of ColdFusion 8 brought many new exciting Ajax features to the language. These features were implementations of the ExtJS 1.1 library. While many of these features are wonderful they are limited to those running ColdFusion 8 and unfortunately we are just not all there yet. This project takes advantage of the new features in the Ext 2.0 library and therefore is not limited to users running previous versions of ColdFusion. I believe that users of 8 and below will find these tags very useful. If you are very good with JavaScript and have a working knowledge of the Ext library you may not find this project useful but I believe the rest of us will! The project was created with a purpose of allowing ColdFusion developers an easy way to leverage the Ext JavaScript framework. While the framework has some amazing features I found that many developers have a tough time getting started with Ext. It was this problem that created the cfExt project and so far it has been a lot of fun working on it. This project still has a lot of work be done before it will see a stable release but it is getting there. Any help with bug reports, docs and code are greatly appreciated. Requirements ------------------------------------------------------------------------------------------- - ExtJS 2.0.2 (http://extjs.com/download) - CFMX7/CF8 (http://www.adobe.com/products/coldfusion/) Whats Included In The download ------------------------------------------------------------------------------------------- /build - This folder contains an ant build file I use to keep the zip file updated. You really should not have to worry about this folder. When this gets closer to a stable release this folder may not even be included. /cfext - This folder contains all of the custom tags. This is the main folder and also considered to be the brains of the operation. /examples - This folder consist of a directories of examples and an Application component. Inside of each folder is a grouping of examples show you how to use all of the tags. /ext - This is the the ExtJS Framework. In the future you will need to download this on your own but for now I have included it. license.txt - The license for the project. readme.txt- Your reading it. Installation ------------------------------------------------------------------------------------------- This project is a set of custom tags that wrap the ExtJS framework. The way I see it is there are 3 ways in which a developer would use this project. 1.) I want to download cfExt to check out the code and view the examples. 2.) I want to use cfExt in a single project. 3.) I want to use cfExt on a server across many projects. 1.) You just downloaded cfExt and you just want to browse the examples. If this is you its pretty easy to get started. Extract the zip to your web root so you have the following setup. /webroot /cfext /buid /cfext /examples /ext license.txt readme.txt Now that you have the project setup under your root you need to let ColdFusion know where all of the custom tags sit. You can do this a couple different ways. If you are running ColdFusion 8 you can just modify the Application component found in the examples folder. ColdFusion 8 allows you to add folders to the custom tag path programatically. If you are using ColdFusion 7 you will need to go into your CF administrator and add the /cfext/cfext folder to your custom tag path. 2.) If you have already played around with the examples and want to use cfExt in your project this tutorial is for you. Here is an example application that I have put together that may or may not look like your application /webroot /HelloWorld /images /css /js /ext /extensions /tags /cfext /another /components /com /helloworld /src Application.cfc index.cfm In this scenario I would only need to copy the customtag folder /cfext/cfext to my tags folder. I would also want to either copy the ext folder to my project root or just download the latest version from http://extjs.com/download. ** I hope this helps clear up some installation problems. If you have any issues using cfExt please let me know as I am trying to make it as easy as possible for you to use this project. API Documentation ------------------------------------------------------------------------------------------- - ExtJS - http://extjs.com/deploy/dev/docs/ Demos and Utils ------------------------------------------------------------------------------------------- /examples - This folder contains examples for you to see how to create components using cfext. All of the examples are broken up into sub folders for easy navigation. The examples folder also contains an Application component that shows how easy it is to add a folder to the custom tag path in ColdFusion 8. cfjson - http://www.epiphantastic.com/cfjson/ Some of the examples make use of this wonderful component. Please visit the link above to learn more about it. Contact ------------------------------------------------------------------------------------------- Thank You for taking the time to check out my project. If you are interested in helping in any way I would love to hear from you. Also I am always looking for comments, thoughts and suggestions so that I can improve on the project.Please contact me with any questions or comments. Email: danvega@gmail.com. Website: http://www.danvega.org/blog/ Project Home: http://cfext.riaforge.org Subversion Repository: http://svn.riaforge.org/cfext