• Overview
• Downloads (0)
• Source
• Changesets
• Wiki
• Issues (1) »
  • New issues
  • Open issues
  • Closed issues
  • All issues
  • Advanced query
  • Create new issue
• Forks/Queues (0)
• Followers (2)

Flash Helper

This extension provides a simple way to handle flash messages. You can easily display notices, errors and warnings using the convinience method.

Installation

In your Rails app root, use the following command-line :

1
2

$ cd vendor/plugins/
$ hg clone http://bitbucket.org/Bounga/flash-helper/

or install it system-wide :

1

$ sudo gem install flash_helper

and require it in Rails::Initializer (environment.rb) :

1

config.gem 'flash_helper'

Use included CSS

If you want to install the flash_helper CSS file in your stylesheets directory, use :

1

$ rake flash_helper:install

And then in your layout use :

1

stylesheet_link_tag 'flash_helper'

Example

For example, in your layout use :

1

display_flashes

Then in your controllers you can use :

1
2
3
4

flash[:notice] = "Successfully created..."
flash[:errors] = "Creation failed!"
flash[:errors] = @news.errors
flash[:warning] = "The new user has no blog associated..."

If you're using Rails >= 2.2, you can translate plugin internal messages. For example in config/locales/fr.yml you can add :

1
2

flash_helper:
  default_message: "Il y a des problèmes dans le formulaire :"

Tune display_flashes :

Options for flash helpers are optional and get their default values from the Bounga::FlashHelper::ViewHelpers.flash_options hash. You can write to this hash to override default options on the global level:

1

Bounga::FlashHelper::ViewHelpers.flash_options[:notice_class] = 'my_notice'

Available options (and their defaults) are :

1
2
3
4
5

:list_class       => 'errors_list'
:notice_class     => 'notice'
:errors_class     => 'errors'
:warning_class    => 'warning'
:default_message  => 'There are problems in your submission:'

By putting this into "config/initializers/flash_helper.rb" (or simply environment.rb in older versions of Rails) you can easily override any default option.

Other

If you want to contribute you should take a look at:

• Source Style
• Ticket Guidelines
• Contributing

You can take a look at RDoc too.

Problems, comments, and suggestions are welcome on the ticket system.

Copyright (c) 2008 Nicolas Cavigneaux, released under the MIT license