For anyone who isn't farmilar with Hoth, it is a great Coldfusion Exception Handling tool developed by Aaron Greenlee. After reading a blog post by Matt Quackenbush (fellow mura developer) I realized that this tool that could be easily deployed as mura plugin, so that is exactly what I have done.
In short the plugin hooks into Mura's onGlobalError() event to log all of the exceptions that occur. When installing the plugin you will be asked to supply an e-mail address for all new errors to be sent to. The great thing about Hoth is that it only sends you and e-mail anytime there is a "new" error. This way your inbox doesn't get overloaded when some spider hits the same page 10,000 times.
The plugin also provides a simple reporting UI to allow you to view and mange all of the exceptions that have been logged. Right now I am using some of the built in reports that Aaron provides in the Hoth core, with some minor changes so that it hooks into mura's security which makes it so that only super-admin's can view the exception reports. In the future there are plans to imporove these reporting features both in Hoth, as well as in the Mura Plugin wrapper for it.
You can download the plugin from the Mura Marketplace, or access it directly via the github repository. As always this is a free tool for the community to use and I encourage the any help with the ongoing development, as well as reporting any bugs that you might find. Hopefully you'll find this tool as helpful as I have, I currently have it running on over 12 live installs of Mura and It's working great!
If you use the tool, and like it, please let Aaron know as I really can't take too much credit for this one.
Comments
- Christian Ready Posted: October 24, 2011, 8:42 PM
-
Thanks Greg, I just added it to my site. Will let you know if I run into any issues. Thanks again!
- Seb Duggan Posted: October 25, 2011, 3:13 AM
-
Great stuff, Greg!
One thing I'd suggest (I've added it on GitHub as an issue) is that the plugin should use Mura's mail server defaults rather than the CF Admin default when sending notifications...
- Grant Shepert Posted: October 25, 2011, 8:04 AM
-
Awesome, Greg. Love tools that make development easier, and this will definitely be put to good use.
- Greg Moser Posted: October 25, 2011, 8:21 AM
-
Thanks guys, I'm glad that you will be able to use it... I'm really looking forward to rolling out some more feature rich reporting.
@Seb I think that is a great Idea. I have to look at Hoth, because I don't remember there being a setting to define SMTP server (it's probably there but i missed it)... even if there isn't, it would be an easy thing to contribute back.
- Michael Evangelista Posted: October 27, 2011, 7:41 AM
-
Excellent! I have been using hoth with Mura for months, through a somewhat hackish method. On my list, right here on the desk, "hoth --> Mura Plugin" ... gladly crossing that one off! Will report back here w/ any feedback. Thanks very much!
- Michael Evangelista Posted: October 27, 2011, 7:48 AM
-
One question right off... where's the "download" link?
- Greg Moser Posted: October 27, 2011, 9:02 AM
-
Haha, good point about the download link. I'll follow up with the mura guys to find out. For now, you can download directly from github:
- John Sieber Posted: October 27, 2011, 1:31 PM
-
Sounds like a great plugin, looking forward to trying it out.
- Michael Evangelista Posted: December 4, 2011, 10:18 PM
-
hey Greg, finally got a chance to install this on a local mura instance. The email reporting is great! But when I go to look at the list of exceptions, it is blank - on the plugin details page i just see "select an exception from the list on the left", but there are no exceptions listed. What am i missing? Is there another page to view the exception list for Hoth? thanks again, very cool.
- Greg Moser Posted: December 5, 2011, 11:37 AM
-
Hmmm, that is very strange. Lets open up a ticket for this on the github issue tracker https://github.com/gregmoser/MuraHoth/issues.
The reporting uses AJAX so my guess is that this is an ajax issue. Can you look in firebug to see if you get any javascript errors?
- Michael Evangelista Posted: December 5, 2011, 2:12 PM
-
Apparently something was amiss with my local mapping - I moved it to a live server and everything is fine. Groovy, even ;-)
I'll drop the local path issue on the ticket system. Thanks for this, definitely adds peace of mind once a site is released into the wild.
- Joshua Scott Posted: June 19, 2012, 2:07 PM
-
I installed the plugin for a client install of Mura. It doesn't seem to be working. I am not getting emails and nothing is showing up in the admin interface.
What might I be doing wrong? Where do I start?
Thanks,
Josh
