radiant-polls-extension 1.0.0

data/app/models/poll.rb

@@ -0,0 +1,67 @@
+class Poll < ActiveRecord::Base
+  
+  has_many :options
+  after_update :save_options
+  validates_presence_of :title
+  validates_uniqueness_of :title, :allow_nil => true
+  validates_uniqueness_of :start_date, :allow_nil => true
+  validates_associated :options
+  before_create :set_defaults
+
+  def self.marker; "<!-- Polls Extension -->" end
+
+  # Find the current poll. The current poll is defined as the poll that has the
+  # latest start date that is no later than the current date. If no poll has a
+  # defined start date, then there is no current poll.
+  def self.find_current
+    Poll.find(:first, :order => 'start_date DESC',
+              :conditions => [ 'start_date IS NOT NULL AND start_date <= ?', Date.today ])
+  end
+
+  def option_attributes=(option_attributes)
+    option_attributes.each do |attributes|
+      if attributes[:id].blank?
+        attributes[:response_count] = 0
+        options.build(attributes)
+      else
+        option = options.detect { |a| a.id == attributes[:id].to_i }
+        option.attributes = attributes
+      end
+    end
+  end
+
+  # submit a response to the poll and update
+  # the response counts for the poll and the option
+  def submit_response(option)
+    option.update_attribute(:response_count, option.response_count + 1) 
+    self.update_attribute(:response_count, self.response_count + 1)
+
+    return true
+  end
+
+  # clear the number of the responses for the poll
+  # and all of its options
+  def clear_responses
+    self.update_attribute(:response_count, 0)
+    self.options.find(:all, :conditions => ["response_count >= 1"]).each do |option|
+      option.update_attribute(:response_count, 0)
+    end
+  end
+
+  private
+
+  def save_options
+    options.each do |option|
+      if option.should_destroy?
+        option.destroy
+      else
+        option.save(false)
+      end
+    end
+  end
+
+  def set_defaults
+    self.response_count = 0
+  end
+
+end

data/app/views/admin/polls/_form.html.haml

@@ -0,0 +1,67 @@
+- include_javascript 'admin/polls'
+- include_javascript 'admin/lowpro'
+- include_javascript 'admin/date_selector'
+- content_for :page_scripts do
+  Event.addBehavior({ '#poll_start_date': DateSelector });
+
+- first_new_form = @poll.new_record? && params[:poll].nil?
+- form_for [:admin, @poll], :html => {'data-onsubmit_status' => onsubmit_status(@poll)} do |f|
+  .form-area
+    - render_region :form, :locals => {:f => f} do |form|
+      #poll_form_area
+        %p.name
+          = f.label :title, t('polls_form.label.title')
+          = f.text_field :title, :class => 'textbox activate', :style => "width: 50%;"
+        %p.title
+          = f.label :poll_start_date, t('polls_form.label.start_date')
+          = f.text_field :start_date, :size => 15
+        %p.title
+          %label#options-title{:for => "polls_form.label.poll_options"} 
+          = t('polls_form.label.options')
+          #options
+            - if first_new_form
+              %p.option
+                %input{:name => "poll[option_attributes][][title]", :size => "30", :type => "text"}/
+            = render :partial => 'option', :collection => @poll.options
+          %p#add-option= link_to_function(t('polls_form.label.add_option'), "add_option('options');")
+        
+    = javascript_tag "document.observe('dom:loaded',initialize_page_view);"
+    - if first_new_form
+      = javascript_tag "$('poll_title').activate();"
+
+    %p.buttons{:style=>"clear: left"}
+      = save_model_button(@poll)
+      = save_model_and_continue_editing_button(@poll)
+      = t('or')
+      = link_to t('cancel'), admin_polls_url
+
+- content_for :page_css do
+  :sass
+    table.calendar
+      background: white
+      border: 1px solid black
+      th
+        background: #eee
+        text-align: center
+        color: black
+        font-weight: bold
+      td
+        background: white
+        border: 1px solid #eee
+        padding: 0 2px
+        text-align: center
+        &.today a
+          color: red !important
+        &.back, &.forward
+          background: #ddd
+      a
+        color: black
+        text-decoration: none
+      tbody tr
+        &:last-child td
+          border-bottom: 1px solid black
+        td
+          &:first-child
+            border-left: 1px solid black
+          &:last-child
+            border-right: 1px solid black

data/app/views/admin/polls/_option.html.haml

@@ -0,0 +1,9 @@
+- option_id = option.id || option_counter
+- field_base_name = 'poll[option_attributes][]'
+- fields_for field_base_name, option do |f|
+  %p.option{:id => "option_#{option_id}"}
+    = f.hidden_field :id, :index => option_id, :name => "#{field_base_name}[id]"
+    = f.hidden_field :should_destroy, :index => option_id, :name => "#{field_base_name}[should_destroy]", :class => 'should_destroy'
+    - unless object.should_destroy?
+      = link_to_function "Delete", "delete_option(#{option_id}, 'options')", { :class => 'delete' }
+      = f.text_field :title, :index => option_id, :name => "#{field_base_name}[title]", :size => 30

data/app/views/admin/polls/edit.html.haml

@@ -0,0 +1,5 @@
+- render_region :main do |main|
+  - main.edit_header do
+    %h1= t('polls_action.edit')
+  - main.edit_form do
+    = render :partial => 'form'

data/app/views/admin/polls/index.html.haml

@@ -0,0 +1,72 @@
+- @page_title = t('polls_index.title') + ' - ' + default_page_title
+.outset
+  = render_region :top
+  %table.index#polls
+    %thead
+      %tr
+        - render_region :thead do |thead|
+          - thead.name_header do
+            %th.name= t('polls_index.column.title')
+          - thead.date_header do
+            %th.date= t('polls_index.column.start_date')
+          - thead.responses_header do
+            %th.responses= t('polls_index.column.responses')
+          - thead.actions_header do
+            %th.actions{:colspan => 2}= t('modify')
+    %tbody
+      - if @polls.any?
+        - @polls.each do |poll|
+          %tr[poll]
+            - render_region :tbody, :locals => {:poll => poll} do |tbody|
+              - tbody.name_cell do
+                %td.name
+                  = image('poll', :alt => '')
+                  = link_to poll.title, edit_admin_poll_url(poll)
+              - tbody.date_cell do
+                %td.date{:style=>"white-space:nowrap"}
+                  = poll.start_date
+              - tbody.responses_cell do
+                %td.name#responses
+                  - if poll.response_count > 0
+                    %strong= link_to_function number_with_delimiter(poll.response_count), :title => "Show / Hide Results for this Poll" do |page| page.visual_effect :toggle_blind, "poll_#{poll.id}_results" end
+                  - else
+                    %span.none= poll.response_count
+              - tbody.actions_cell do
+                %td.actions
+                  - if poll.response_count > 0
+                    = link_to image('recycle') + ' ' + t('polls_index.reset'), clear_responses_admin_poll_url(poll), :method => :post, :confirm => t('polls_index.reset_confirm', :poll => poll.title), :class => "action"
+                %td.actions
+                  = link_to image('minus') + ' ' + t('remove'), admin_poll_url(poll), :method => :delete, :confirm => t('polls_index.delete_confirm', :poll => poll.title), :class => "action"
+                
+                - if poll.response_count > 0
+                  %tr
+                    %td.blank
+                    %td{:colspan => 4}
+                      .results{:id => "poll_#{poll.id}_results", :style => "align:right;display: none;"}
+                        %strong Results
+                        %table
+                          - poll.options.sort{|a,b| b.response_count <=> a.response_count}.each do |option|
+                            %tr
+                              %td
+                                %strong= option.title
+                              %td= option.response_count
+      - else
+        %td.empty{:colspan => admin.poll.index.tbody.length}= t('polls_index.empty')
+
+- render_region :bottom do |bottom|
+  - bottom.new_button do
+    #actions
+      = pagination_for(@polls)
+      %ul
+        %li= link_to image('plus') + " " + t('polls_action.new'), new_admin_poll_url, :class => 'action_button'
+
+- content_for :page_css do
+  :sass
+    .index#polls
+      th.actions, td.name#responses
+        text-align: center
+      td.responses a
+        font-size: 115%
+        font-weight: bold
+        color: black
+        text-decoration: none

data/app/views/admin/polls/new.html.haml

@@ -0,0 +1,5 @@
+- render_region :main do |main|
+  - main.edit_header do
+    %h1= t('polls_action.new')
+  - main.edit_form do
+    = render :partial => 'form'

data/app/views/admin/polls/remove.html.haml

@@ -0,0 +1,17 @@
+%h1= t('remove_poll')
+
+%p 
+  = t('text.polls.remove_warning')
+
+%table.index#polls
+  %tbody
+    %tr.node.level_1
+      %td.poll
+        = image('poll', :alt => "")
+        %span.title= @poll.title
+
+- form_for [:admin, @poll], :html => {:method => :delete, 'data-onsubmit_status'=>"Removing poll…"} do
+  .buttons
+    %input.button{:type=>"submit", :value => t('delete_poll')}/
+    = t('or')
+    = link_to t('cancel'), admin_polls_url

data/config/locales/en.yml

@@ -0,0 +1,25 @@
+---
+en:
+  polls_action:
+    edit: 'Edit Poll'
+    new: 'New Poll'
+  polls_form:
+    label:
+      title: 'Title'
+      start_date: 'Start Date'
+      options: 'Options'
+      add_option: 'Add Poll Option'
+  polls_index:
+    title: 'Polls'
+    instructions: 'Click on a poll name below to edit it, or click <code>Remove</code> to delete it. If a poll has responses, click the responses value to toggle the view of the results. Poll responses can be cleared by clicking <code>Clear responses</code>.'
+    column:
+      title: 'Title'
+      start_date: 'Start Date'
+      responses: 'Responses'
+    empty: 'You have not created any polls. Click <code>New Poll</code> below to create a new poll.'
+    reset: 'Clear responses'
+    reset_confirm: "Clear all responses for the poll '%{poll}' ?"
+    delete_confirm: "Permanently delete the poll '%{poll}' ?"
+    results: 'Results'
+  polls_controller:
+    responses_cleared: "Responses have been cleared."

data/config/locales/en_available_tags.yml

@@ -0,0 +1,187 @@
+---
+en:
+  desc: 
+    poll: "Selects the active poll.
+
+      *Usage*:
+      
+      <pre><code><r:poll [title=\"Poll Title\"]>
+          ...
+      </r:poll></code></pre>"
+    poll-unless_submitted: "Expands inner tags if the poll has not been submitted yet.
+
+      *Usage*:
+      
+      <pre><code><r:poll:unless_submitted>
+          ...
+      </r:poll:unless_submitted></code></pre>"
+    poll-if_submitted: "Expands inner tags if the poll has been yet.
+
+      *Usage*:
+      
+      <pre><code><r:poll:if_submitted>
+          ...
+      </r:poll:if_submitted></code></pre>"
+    poll-title: "Shows the poll title.
+
+      *Usage*:
+      
+      <pre><code><r:poll><r:title /></r:poll></code></pre>"
+    poll-form: "Renders a poll survey form.
+
+      *Usage*:
+      
+      <pre><code><r:poll:form>
+          ...
+      </r:poll:form></code></pre>"
+    poll-options: "Render a collection of options, optionally sorted by @response_count@
+      in @asc@ending, @desc@ending, or @rand@om order. If no order is specified, the
+      result will be in whatever order is returned by the SQL query.
+      
+      *Usage*:
+      
+      <pre><code><r:poll:options [order=\"asc|desc|rand\"]>
+          ...
+      </r:poll:options></code></pre>"
+    poll-options-each: "Iterate through each poll option.
+
+      *Usage:*
+
+      <pre><code><r:poll:options:each>
+          ...
+      </r:poll:options:each></code></pre>"
+    poll-options-each-if_first: "Render inner content if the current contextual option is the first option.
+
+      *Usage:*
+      
+      <pre><code><r:poll:options:each:if_first>
+          ...
+      </r:poll:options:each:if_first></code></pre>"
+    poll-options-each-if_last: "Render inner content if the current contextual option is the last option.
+
+      *Usage:*
+      
+      <pre><code><r:poll:options:each:if_last>
+          ...
+      </r:poll:options:each:if_last></code></pre>"
+    poll-options-each-unless_first: "Render inner content unless the current contextual option is the first option.
+
+      *Usage:*
+      
+      <pre><code><r:poll:options:each:unless_first>
+          ...
+      </r:poll:options:each:unless_first></code></pre>"
+    poll-options-each-unless_last: "Render inner content unless the current contextual option is the last option.
+
+      *Usage:*
+      
+      <pre><code><r:poll:options:each:unless_last>
+          ...
+      </r:poll:options:each:unless_last></code></pre>"
+    poll-options-input: "Show the poll option radio button input type.
+
+      *Usage:*
+      
+      <pre><code><r:poll:form>
+        <r:options:each>
+          <r:input />
+        </r:options:each>
+      </r:poll:form></code></pre>"
+    poll-options-title: "Show the poll option title.
+
+      *Usage:*
+      
+      <pre><code><r:poll:form>
+        <r:options:each>
+          <r:title />
+        </r:options:each>
+      </r:poll:form></code></pre>"
+    poll-submit: "Show a poll form submit button.
+      The optional @value@ attribute may be specified to override the default
+      button label.
+
+      *Usage:*
+      
+      <pre><code><r:poll:form>
+        <r:options:each>
+          <r:input /><r:title />
+        </r:options:each>
+        <r:submit [value=\"Go!\"] />
+      </r:poll:form></code></pre>"
+    poll-options-percent_responses: "Show the percentage of responses for an option.
+
+      *Usage:*
+
+      <pre><code><r:poll:options:each>
+        <r:title /> <r:percent_responses />
+      </r:poll:options:each></code</pre>"
+    poll-options-number_responded: "Show the number of responses for an option.
+
+      *Usage:*
+
+      <pre><code><r:poll:options:each>
+        <r:title /> <r:number_responded />
+      </r:poll:options:each></code</pre>"
+    poll-total_responses: "Show the total number of visitors that responded.
+
+      *Usage:*
+
+      <pre><code><r:poll:total_responses /></code></pre>"
+    polls: "Selects all polls.
+
+      By default, polls are sorted in ascending order by title and limited to
+      10 per page; the current poll and any future polls are excluded. To
+      include the current poll, set @show_current@ to @true@. Any polls where
+      @attribute@ is null are also excluded, so if you have a set of polls that
+      include polls that do not have a defined start date, then when @by@ is set
+      to @start_date@, only those polls with start dates will be shown.
+
+      *Usage:*
+
+      <pre><code><r:polls [per_page=\"count\"] [by=\"attribute\"]
+       [order=\"asc|desc\"] [show_current=\"true|false\"] /></code></pre>"
+    polls-each: "Loops through each poll and renders the contents.
+
+      *Usage:*
+
+      <pre><code><r:polls:each>
+          ...
+      </r:polls:each></code></pre>"
+    polls-each-poll: "Creates context for a single poll.
+
+      *Usage:*
+
+      <pre><code><r:polls:each:poll>
+          ...
+      </r:polls:each:poll></code></pre>"
+    polls-pages: "Renders pagination links with will_paginate.
+      The following optional attributes may be controlled:
+
+      <ul>
+        <li>@id@ the id to apply to the containing div</li>
+        <li>@class@ the class to apply to the containing div (default is \"pagination\")</li>
+        <li>@previous_label@ override the default of \"&laquo; Previous\"</li>
+        <li>@next_label@ override the default of \"Next &raquo;\"</li>
+        <li>@inner_window@ the number of pagination links shown around the current page (default is 4)</li>
+        <li>@outer_window@ the number of pagination links shown around the first and last page links (default is 1)</li>
+        <li>@separator@ the string separator for page HTML elements (default is a single space)</li>
+        <li>@page_links@ if false, only previous/next links are rendered (default is true)</li>
+        <li>@container@ if false, pagination links are not wrapped in a containing div (default is true)</li>
+      </ul>
+
+      *Usage:*
+
+      <pre><code><r:polls>
+        <r:each:poll>
+          ...
+        </r:each:poll>
+        <r:pages [id=\"\"]
+                 [class=\"pagination\"]
+                 [previous_label=\"&laquo; Previous\"]
+                 [next_label=\"Next &raquo;\"]
+                 [inner_window=\"4\"]
+                 [outer_window=\"1\"]
+                 [separator=\" \"]
+                 [page_links=\"true\"]
+                 [container=\"true\" />
+      </r:polls></code></pre>"