ActsAsPollable

This plugin allows polls, integrated with your user model, within your application.

Install plugin

• Run the generator command:

  ./script/generate acts_as_pollable

• Update the database, running migration:

  rake db:migrate

Create poll

• To create a poll use the following command:

  ./script/runner vendor/plugins/acts_as_pollable/create_poll.rb

  The script will ask you which are the answers, which is the questions displayed, among other configurations (allows multiple selection, who is allowed to vote: registered users, anonymous, etc.) for the poll.

Show poll in views

• Insert the poll helper in your view:

  someview.rhtml (where you want to show the poll)

  .. <%= poll ( poll_name, { :in_place => true, :redirect_to => some_url, :view_dir => view_directory } ) %> ..

  Where:

    * poll_name. This is the name that identifies the poll to display. This is the only required parameter.
    * :in_place. Enables AJAX functionality to the poll if it is set to true, otherwise the hole page would be reload while submitting a vote.
    * :redirect_to. This is an url to redirect after the vote.
    * :view_dir. If present, it loads the poll views (show_poll, already_vote, user_not_logged, etc) from the directory set by this parameter. Otherwise, all views will be taken from RAILS_APP/vendor/plugins/acts_as_pollable/views.

• Insert act_as_vote_handler statement in the controller of the view (where the poll helper is used):

  class SomeController

   acts_as_vote_handler
  
  ..

  end

More Information, improvment & comments

For more information you can visit the following page: http://railshotspot.blogspot.com

Copyright (c) 2009 [name of plugin creator], released under the MIT license