frontend_notifier

FrontendNotifier

Shows cute notifications in frontend. No need to manually create your own html/css/js to show Rails's flash[:notice] or other flashes. This gem handles it nicely + you can customize it.

INSTALLATION

Requirements: Rails 3.1.0, jQuery

• gem install frontend_notifier
• put the following in your .scss file: @import "frontend_notifier";
• put the following in your .js or .coffee file: #= require lib/_frontend_notifier
• put the following in layout: = render :partial => "shared/frontend_notifier"

USAGE

Regular reuqests FrontendNotifier will pick up any flash with the names :error, :alert, :warning, :success or :notice. You can customize this by creating your own views/shared/frontend_notifier template.

Ajax requests Sometimes you may need to display the notification after an ajax request. For that, you may want to use #notify_frontend method now available in your controller and pass it either a model with (or without) errors:

def create
  ...    
  notify_frontend(@user)
end

or a message and an error type:

def create
  ...
  notify_frontend("Email can't be blank", :error)
end

Both will result in rendering the following json:

{ type: "error", message: "Email can't be blank" }

Now you can deal with this in your ajax request callback. Assuming this is a jQuery $.ajax function:

success: function(response) { FrontendNotifier.show(response) }

In this case, FrontendNotifier.show will recognize the type of the notification (either "success" or "error") and display appropriately styled notification (by default, green background for success and red for error).

You can also specify the type of error to the FrontendNotifier class manually and call the .show() function anywhere in your js: FrontendNotifier.show("Testing notifications", "success")

There's also a handy #join_model_errors method added to the ApplicationController, which you might want to look at. It basically takes errors from the model and compiles them into a one line message which may then be handed to the FrontendNotifier. So, you may want to use it like this:

flash[:error] = join_model_errors(@user, include_field_names: true) # :include_field_names is true by default

CUSTOMIZE

For now, the gem lacks generators, so if you want to customize scss styles or haml templates, just copy .scss/.haml files from their gem dirs into your app dirs and change them.