Module: Responders::FlashResponder
- Defined in:
- lib/responders/flash_responder.rb
Overview
Responder to automatically set flash messages based on I18n API. It checks for message based on the current action, but also allows defaults to be set, using the following order:
flash.controller_name.action_name.status
flash.actions.action_name.status
So, if you have a CarsController, create action, it will check for:
flash.cars.create.status
flash.actions.create.status
The statuses by default are :notice (when the object can be created, updated or destroyed with success) and :alert (when the objecy cannot be created or updated).
On I18n, the resource_name given is available as interpolation option, this means you can set:
flash:
actions:
create:
notice: "Hooray! {{resource_name}} was successfully created!"
But sometimes, flash messages are not that simple. Going back to cars example, you might want to say the brand of the car when it’s updated. Well, that’s easy also:
flash:
cars:
update:
notice: "Hooray! You just tuned your {{car_brand}}!"
Since :car_name is not available for interpolation by default, you have to overwrite interpolation_options in your controller.
def
{ :car_brand => @car.brand }
end
Then you will finally have:
'Hooray! You just tuned your Aston Martin!'
If your controller is namespaced, for example Admin::CarsController, the messages will be checked in the following order:
flash.admin.cars.create.status
flash.admin.actions.create.status
flash.cars.create.status
flash.actions.create.status
Options
FlashResponder also accepts some options through respond_with API.
-
:flash - When set to false, no flash message is set.
respond_with(@user, :flash => true)
-
:notice - Supply the message to be set if the record has no errors.
-
:alert - Supply the message to be set if the record has errors.
respond_with(@user, :notice => "Hooray! Welcome!", :alert => "Woot! You failed.")
Configure status keys
As said previously, FlashResponder by default use :notice and :alert keys. You can change that by setting the status_keys:
Responders::FlashResponder.flash_keys = [ :success, :failure ]
However, the options :notice and :alert to respond_with are kept :notice and :alert.
Constant Summary collapse
- @@flash_keys =
[ :notice, :alert ]
Instance Method Summary collapse
Instance Method Details
#initialize(controller, resources, options = {}) ⇒ Object
81 82 83 84 85 86 |
# File 'lib/responders/flash_responder.rb', line 81 def initialize(controller, resources, ={}) super @flash = .delete(:flash) @notice = .delete(:notice) @alert = .delete(:alert) end |
#to_html ⇒ Object
88 89 90 91 |
# File 'lib/responders/flash_responder.rb', line 88 def to_html super if end |