FAQs

Where can I try a demo?

Here - Note, demo mode is a bit limited, so whilst you can get a feel for the app, the real power is when you're logged in on your own instance and can change the settings.

How do I restart the Application?

Simply Append ?reload=production&password=YOURRELOADPASSWORD as a query string to the URL. Your reload password is whatever you set it to in /config/settings.cfm (defaults to roombooking)

I get 'Sorry, that caused an unexpected error. Please try again later': how do I fix this?

This means that you're in 'production' mode, where errors get sent via email instead of being displayed on screen. This is a standard error message, so to diagnose what's going on, reload the app into design mode via ?reload=design&password=YOURRELOADPASSWORD and errors will be displayed on screen instead. If you're not getting the error emails in production mode, this is usually due to either a) you not setting the error email address in config/production.cfm and/or not setting up an SMTP server in the ACF/Lucee administrator. If you've got a fresh lucee install for instance, you either need to add an external SMTP server like gmail, or use localhost via sendmail/postfix etc; otherwise lucee can't send email.

I made a change to the configuration/permissions but it doesn't work

You need to restart the application after making application level changes so that the new configurations are loaded into memory.

Can I add extra fields to the booking form without changing core files?

Yes! - read up on the Custom Fields and Custom Templates options.

My site insists its in Demo mode

Demo Mode is used for roombooking.oxalto.co.uk; many key functions are disabled, but should be enough to get a feel for the application. If you find your installation in demo mode, you can only revert it directly in the database by changing settings - isDemoMode to 0. If it's still set to 0, and you've restarted the application, but it still insists it's in demo mode, it might be the settings not loading properly: cfdump the application.rbs struct, and check the settings scope is being properly populated.

Will this run on CF9?

Not without a lot of work; there's a lot of cfscript loops etc which would make it a real pain to rewrite. So really, I'm not going to support CF9 - you've got Lucee as an open source option after all!

I have an bug/error I can't figure out - where do I get help?

Best idea is to start an issue on the Issue Tracker - that'll email me to let me know, and will allow others to contribute a solution, or see the solution if they've had a similar issue

How can I load design, development, testing and production modes?

Use ?reload=design&password=YOURRELOADPASSWORD in the URL to switch modes, or set the default environment in /config/settings.cfm - See the cfWheels website for more information about the various configuration options available.

I see The FlashWrapper plugin may be incompatible with this version of Wheels when in design mode - How can I fix this?

You don't actually need to - it's only because the plugin doesn't have the current wheels version number implicitly listed within it. Don't worry about it.

Do you support URL rewriting? SEO Urls?

Technically yes, you can turn it on in /config/settings.cfm and by removing the various # comments in the root .htaccess file - however, I've left it off for a reason - main due to ajax URLs which are more difficult to generate when you have to deal with both modes. It's not wickedly tested with URL rewriting on, so unless you badly need it, stick with it off.

Search engines don't see my site.

That's on purpose - there's a robots.txt file in the root with disallow /; Most of the time the use for this application will (presumably) be for internal use. You can of course remove this.

How do I alter the CSS / Javascript?

Grunt and Bower are used to concatenate JS and CSS files (and compile bootstrap from LESS source), with Bower used for package management. If you're not familiar with grunt, go and read up - it's out of the scope of this FAQ.

What licence is this released under?

Apache 2.0

Who's using it?

Various schools, universities and companies - if you're using it I'd actually quite like to hear from you and learn about your scenario - Drop me a line. i.e, how many locations do you actually use? What type of bookings do you take?

What's with the name change?

I've prepended 'OxAlto' to the name for v 1.2 to help distinguish it a bit from other roombooking systems. You then at least get ORBS as an acronym. Which is nice.

I need paid support getting this installed

Drop me a line - depending on my work load I might be able to assist. Or you can probably find me on the #cfml slack team, or on the cfWheels mailing list.