Every day I use ColdFusion Builder I like it a bit more. Last night I built out a new extension. Before I describe how it works, let me demonstrate with a video (and once again I apologize for the size - my 30 inch monitor spoils me):
This extension demonstrates how you can hook into the "New Project" action of CFB. In this case I added support for generating a "skeleton" application for Framework One. FW/1 doesn't ship with a skeleton application in the zip. I've logged a request for it - but honestly, with FW/1 having such a small amount of absolutely necessary files, it may not make sense. However - there are some things that I think a typical FW/1 application will need - hence the need for the extension. So what does the code look like? First, here is the XML for my ide_config.xml:
<menucontributions> </menucontributions> <events> <event type="onprojectcreate" handlerid="projectcreate" /> </events> <handlers> <handler id="projectcreate" type="CFM" filename="projectcreate.cfm" /> </handlers> </application><application> <name>FW/1 Assistant</name> <author>Raymond Camden</author> <version>0</version> <email>ray@camdenfamily.com</email> <description>intro.html</description> <license>license.html</license>
As you can see it has one event defined - projectcreate - that then links to my handler. The handler is pretty simple as well:
<cfset xmldoc = XMLParse(ideeventinfo)> <cfset project=xmldoc.event.ide.eventinfo.xmlattributes["projectname"]> <cfset projectloc=xmldoc.event.ide.eventinfo.xmlattributes["projectlocation"]> <!--- Create the following folders /controllers /layouts /services /views /views/main Create the following files: /Application.cfc /index.cfm /views/main/default.cfm ---> <cfdirectory action="create" directory="#projectloc#/controllers"> <cfdirectory action="create" directory="#projectloc#/layouts"> <cfdirectory action="create" directory="#projectloc#/services"> <cfdirectory action="create" directory="#projectloc#/views"> <cfdirectory action="create" directory="#projectloc#/views/main"> <!--- copy my _App.cfc (named so as to not be a real app.cfc) ---> <cffile action="copy" source="#expandPath('./files/_App.cfc')#" destination="#projectloc#/Application.cfc"> <!--- copy my index.cfm ---> <!--- FYI, yes, index.cfm is blank, so why bother using a file at all? Well, if in the future stuff goes in there, this will be a bit more future proof. That's my logic for now. ---> <cffile action="copy" source="#expandPath('./files/index.cfm')#" destination="#projectloc#/index.cfm"> <cffile action="copy" source="#expandPath('./files/default.cfm')#" destination="#projectloc#/views/main/default.cfm"><cfparam name="ideeventinfo">
Basically the extension simply makes a few folders and copies three 'template' files over into the new project.
I'm not sure if I'll release this as a proper RIAForge project. I'd like to hear what other FW/1 users think and see if they have ideas on how to expand it. (And yes, I'm also supposed to be working on the Model-Glue CFB extension - sorry - I get distracted easily by shiny objects.) I've included a zip to this entry. Enjoy.