Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config/locales
lib
spec
.gitignore
.travis.yml
Gemfile
MIT-LICENSE
README.rdoc
Rakefile
config.ru
err_merchant.gemspec

README.rdoc

err_merchant

This is a very simple Rails Engine for replacing the standard (ugly) Rails exception pages with pages which are rendered in your layout. This solution works seamlessly with Airbrake.

Installation

Add the gem to your Gemfile, run `bundle install` and restart your server:

gem 'err_merchant'

This is it. If you want to check the error pages in development mode, make sure to set config.consider_all_requests_local to false and restart your development server.

Should I keep the standard Rails error pages around?

Yes, these files are used as a fallback if err_merchant itself raises an exception. This can happen if there is an error in your application layout.

Configuration

  • ErrMerchant.layout: Can be used to set the layout for the error pages. By default the application-layout is used.

I18n

You can translate the error messages, by default they are the same as the standard Rails errors:

err_merchant:
  '404':
    title: "The page you were looking for doesn't exist."
    description: "You may have mistyped the address or the page may have moved."
  '422':
    title: "The change you wanted was rejected."
    description: "Maybe you tried to change something you didn't have access to."
  '500':
    title: "We're sorry, but something went wrong."
    description: "We've been notified about this issue and we'll take a look at it shortly."

Please note that there are translations missing in development mode if you don't supply translations for your locale. In production however, config.i18n.fallbacks is usually set to true, so the error messages for the default locale will be shown if the lookup is not successful.

Changelog

0.3.1 (2014-11-08)

  • works with `pundit` now

  • show error messages raw

0.3.0 (2014-10-24)

  • compatible with rails 4

0.2.0 (2012-01-30)

  • only supports rails 3.2 (code cleanup)

0.1.2 (2012-01-12)

  • added configuration option for layout

0.1.1 (2012-01-12)

  • fix gemspec

  • add test for fallback to standard rails error pages

  • fix issue with CanCan

0.1.0 (2012-01-11)

  • Initial release

License

This project rocks and uses MIT-LICENSE.

Something went wrong with that request. Please try again.