No commit activity in last 3 years
No release in over 3 years
Ruby on Rails Polls extension for Refinery CMS
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

RefineryCMS-Polls extension Build Status

Simple polls extension for RefineryCMS engine.

IMPORTANT:

This extension requires Ruby 1.9.x. It's time to upgrade our current ruby base systems.

Gem Installation using Bundler (The very best way)

Include the latest gem into your Refinery CMS application's Gemfile:

gem 'refinerycms-polls', '~> 0.0.4.dev'

Then type the following at command line inside your Refinery CMS application's root directory:

bundle install

Installation on Refinery 2.0.0 or above.

To install the migrations, run:

rails generate refinery:polls
rake db:migrate

Add pages to the database and you're done:

rake db:seed

Set vote interval by ip:

After install "generate refinery:polls" you will have an initializer called refinery/poll.rb, you can modify vote interval there.

Refinery::Polls.configure do |config|
  # Configure how long is going to be valid a vote for a guest
  config.vote_duration = 1.week
end

Render a Poll

You can get all actives polls with:

Refinery::Polls::Question.actives

all questions will be orderer by default with position value in admin reorder functionality.

And pick up one question to render a poll with the partial "poll":

render '/refinery/polls/questions/poll', :question => question

Override default view for partial _poll

You can override the default partial view for a poll replacing this partial:

/refinery/polls/questions/_poll.html.erb

You only need to create that path and file in your app tree.

About

Add polls to your Refinery site.

In summary you can:

  • Create Polls.
  • Set anwsers for your polls.
  • Set when starts and ends your polls.
  • Show results for your polls.
  • Set votes for anonymous users by IP addres
  • Set duration period to vote. (if a guest vote it will need to wait X time to vote again)

Docs:

Todo

  • Vote tracking by cookies.
  • Documentation
  • Tests
  • Wiki

License

RefineryCMS Polls extension is released under the MIT license and is copyright (c) 2012 Agustin ViƱao