Documentation Overview

This is the start of the next generation documentation:

• Understanding the XML Files
• The fusebox.xml file
• The circuit.xml file
• The circuit XML grammar
• Extending FuseNG (with Lexicons)
• Extending FuseNG (with Plugins)
• FLiP Methodology

Feel free to edit / add suggestions etc.

Many thanks to Kevin Roche for the first cut of the above documentation, as an update from what was on the previous FuseNG website.

Frequently Asked Questions

I make changes to my fusebox.xml file, but nothing is happening?

A. Changes made to the fusebox.xml file may not be picked up when you refresh your page. This is because only the 'development-full-load' mode will re-parse the xml files on every request. (see the fusebox.xml file). This saves time when using the other modes, but to pick up any changes you have made in your fusebox.xml file (including changing the mode to 'development-full-load'!), you need to over-ride this. Simply append the following fusebox URLs to your request:

I am getting 'Could not get exclusive lock to fusebox xml file'. What does this mean?

A. Make sure the parsed directory is writable by your web server. This directory will be found in your application root. By default this will be where your fusebox.xml file is stored. See also ParsePath.

I am getting an error that says reads, "This is the template 'errortemplates/fusebox.errorWritingParsedFile.cfm' An Error of type "fusebox.errorWritingParsedFile" has occurred An Error during write of Parsed File or Parsing Directory not found."

A. ColdFusion will need permission to create and write certain folders and files. This error is most commonly encountered with a new application when it tries to write files to the YourApplicationRoot/parsed/ directory. This folder needs to be writable by ColdFusion and should also match the 'ParsePath' value defined in the fusebox.xml.[BR] If you are running on Linux, you might also check to see if there are any case-sensitivity issues with regard to file and directory names you defined there. Note that by default the values for ParsePath, as well as PluginsPath, errorTemplatesPath, and LexiconsPath are relative from the application root (where the fusebox.xml file lives).

Can FuseNG do SES (Search Engine Safe) URLs?

A. Yes, FuseNG will handle SES URLs 'out-of-the-box', and solutions are freely available for older versions, including PHP. Here is one for ColdFusion and Another for PHP.

When I run my application, all I get is a white screen.

A. This is most commonly caused by improper syntax in the XML files (fusebox.xml or circuit.xml). Make sure all tags are properly closed and only XML-valid symbols are used. See CircuitXmlGrammarPage.