elevation_event_calendar 1.0.0

data/lib/event_calendar/calendar_helper.rb

@@ -0,0 +1,360 @@
+module EventCalendar
+  module CalendarHelper
+ 
+    # Returns an HTML calendar which can show multiple, overlapping events across calendar days and rows.
+    # Customize using CSS, the below options, and by passing in a code block.
+    #
+    # The following are optional, available for customizing the default behaviour:
+    # :month => Time.now.month # The month to show the calendar for. Defaults to current month.
+    # :year => Time.now.year # The year to show the calendar for. Defaults to current year.
+    # :abbrev => true # Abbreviate day names. Reads from the abbr_day_names key in the localization file.
+    # :first_day_of_week => 0 # Renders calendar starting on Sunday. Use 1 for Monday, and so on.
+    # :show_today => true # Highlights today on the calendar using CSS class.
+    # :month_name_text => nil # Displayed center in header row.
+    #     Defaults to current month name from Date::MONTHNAMES hash.
+    # :previous_month_text => nil # Displayed left of the month name if set
+    # :next_month_text => nil # Displayed right of the month name if set
+    # :event_strips => [] # An array of arrays, encapsulating the event rows on the calendar
+    #
+    # :width => nil # Width of the calendar, if none is set then it will stretch the container's width
+    # :height => 500 # Approx minimum total height of the calendar (excluding the header).
+    #     Height could get added if a day has too many event's to fit.
+    # :day_names_height => 18 # Height of the day names table (included in the above 'height' option)
+    # :day_nums_height => 18 # Height of the day numbers tables (included in the 'height' option)
+    # :event_height => 18 # Height of an individual event row
+    # :event_margin => 1 # Spacing of the event rows
+    # :event_padding_top => 1 # Padding on the top of the event rows (increase to move text down)
+    #
+    # :use_all_day => false # If set to true, will check for an 'all_day' boolean field when displaying an event.
+    #     If it is an all day event, or the event is multiple days, then it will display as usual.
+    #     Otherwise it will display without a background color bar.
+    # :use_javascript => true # Outputs HTML with inline javascript so events spanning multiple days will be highlighted.
+    #     If this option is false, cleaner HTML will be output, but events spanning multiple days will 
+    #     not be highlighted correctly on hover, so it is only really useful if you know your calendar
+    #     will only have single-day events. Defaults to true.
+    # :link_to_day_action => false # If controller action is passed,
+    #     the day number will be a link. Override the day_link method for greater customization.
+    #
+    # For more customization, you can pass a code block to this method
+    # The varibles you have to work with in this block are passed in an agruments hash:
+    # :event => The event to be displayed.
+    # :day => The day the event is displayed on. Usually the first day of the event, or the first day of the week,
+    #   if the event spans a calendar row.
+    # :options => All the calendar options in use. (User defined and defaults merged.)
+    #
+    # For example usage, see README.
+    #
+    def calendar(options = {}, &block)
+      block ||= Proc.new {|d| nil}
+ 
+      defaults = {
+        :year => Time.now.year,
+        :month => Time.now.month,
+        :abbrev => true,
+        :first_day_of_week => 0,
+        :show_today => true,
+        :month_name_text => Time.now.strftime("%B %Y"),
+        :previous_month_text => nil,
+        :next_month_text => nil,
+        :event_strips => [],
+        
+        # it would be nice to have these in the CSS file
+        # but they are needed to perform height calculations
+        :width => nil,
+        :height => 500, 
+        :day_names_height => 18,
+        :day_nums_height => 18,
+        :event_height => 18,
+        :event_margin => 1,
+        :event_padding_top => 2,
+        
+        :use_all_day => false,
+        :use_javascript => true,
+        :link_to_day_action => false
+      }
+      options = defaults.merge options
+    
+      # default month name for the given number
+      options[:month_name_text] ||= I18n.translate(:'date.month_names')[options[:month]]
+      
+      # make the height calculations
+      # tricky since multiple events in a day could force an increase in the set height
+      height = options[:day_names_height]
+      row_heights = cal_row_heights(options)
+      row_heights.each do |row_height|
+        height += row_height
+      end
+      
+      # the first and last days of this calendar month
+      first = Date.civil(options[:year], options[:month], 1)
+      last = Date.civil(options[:year], options[:month], -1)
+      
+      # create the day names array [Sunday, Monday, etc...]
+      day_names = []
+      if options[:abbrev]
+        day_names.concat(I18n.translate(:'date.abbr_day_names'))
+      else
+        day_names.concat(I18n.translate(:'date.day_names'))
+      end
+      options[:first_day_of_week].times do
+        day_names.push(day_names.shift)
+      end
+ 
+      # Build the HTML string
+      cal = ""
+      
+      # outer calendar container
+      cal << %(<div class="ec-calendar")
+      cal << %(style="width: #{options[:width]}px;") if options[:width]
+      cal << %(>)
+      
+      # table header, including the monthname and links to prev & next month
+      cal << %(<table class="ec-calendar-header" cellpadding="0" cellspacing="0">)
+      cal << %(<thead><tr>)
+      if options[:previous_month_text] or options[:next_month_text]
+        cal << %(<th colspan="2" class="ec-month-nav">#{options[:previous_month_text]}</th>)
+        colspan = 3
+      else
+        colspan = 7
+      end
+      cal << %(<th colspan="#{colspan}" class="ec-month-name">#{options[:month_name_text]}</th>)
+      if options[:next_month_text]
+        cal << %(<th colspan="2" class="ec-month-nav">#{options[:next_month_text]}</th>)
+      end
+      cal << %(</tr></thead></table>)
+      
+      # body container (holds day names and the calendar rows)
+      cal << %(<div class="ec-body" style="height: #{height}px;">)
+      
+      # day names 
+      cal << %(<table class="ec-day-names" style="height: #{options[:day_names_height]}px;" cellpadding="0" cellspacing="0">)
+      cal << %(<tbody><tr>)
+      day_names.each do |day_name|
+        cal << %(<th class="ec-day-name" title="#{day_name}">#{day_name}</th>)
+      end
+      cal << %(</tr></tbody></table>)
+      
+      # container for all the calendar rows
+      cal << %(<div class="ec-rows" style="top: #{options[:day_names_height]}px; )
+      cal << %(height: #{height - options[:day_names_height]}px;">)
+      
+      # initialize loop variables
+      first_day_of_week = beginning_of_week(first, options[:first_day_of_week])
+      last_day_of_week = end_of_week(first, options[:first_day_of_week])
+      last_day_of_cal = end_of_week(last, options[:first_day_of_week])
+      row_num = 0
+      top = 0
+      
+      # go through a week at a time, until we reach the end of the month
+      while(last_day_of_week <= last_day_of_cal)
+        cal << %(<div class="ec-row" style="top: #{top}px; height: #{row_heights[row_num]}px;">)
+        top += row_heights[row_num]
+        
+        # this weeks background table
+        cal << %(<table class="ec-row-bg" cellpadding="0" cellspacing="0">)
+        cal << %(<tbody><tr>)
+        first_day_of_week.upto(first_day_of_week+6) do |day|
+          today_class = (day == Date.today) ? "ec-today-bg" : ""
+          cal << %(<td class="ec-day-bg #{today_class}">&nbsp;</td>)
+        end
+        cal << %(</tr></tbody></table>)
+        
+        # calendar row
+        cal << %(<table class="ec-row-table" cellpadding="0" cellspacing="0">)
+        cal << %(<tbody>)
+        
+        # day numbers row
+        cal << %(<tr>)
+        first_day_of_week.upto(last_day_of_week) do |day|
+          cal << %(<td class="ec-day-header )
+          cal << %(ec-today-header ) if options[:show_today] and (day == Date.today)
+          cal << %(ec-other-month-header ) if (day < first) || (day > last)
+          cal << %(ec-weekend-day-header) if weekend?(day)
+          cal << %(" style="height: #{options[:day_nums_height]}px;">)
+          if options[:link_to_day_action]
+            cal << day_link(day.day, day, options[:link_to_day_action])
+          else
+            cal << %(#{day.day})
+          end
+          cal << %(</td>)
+        end
+        cal << %(</tr>)
+        
+        # event rows for this day
+        # for each event strip, create a new table row
+        options[:event_strips].each do |strip|
+          cal << %(<tr>)
+          # go through through the strip, for the entries that correspond to the days of this week
+          strip[row_num*7, 7].each_with_index do |event, index|
+            day = first_day_of_week + index
+            
+            if event
+              # get the dates of this event that fit into this week
+              dates = event.clip_range(first_day_of_week, last_day_of_week)
+              # if the event (after it has been clipped) starts on this date,
+              # then create a new cell that spans the number of days
+              if dates[0] == day.to_date
+                # check if we should display the bg color or not
+                no_bg = no_event_bg?(event, options)
+                
+                cal << %(<td class="ec-event-cell" colspan="#{(dates[1]-dates[0]).to_i + 1}" )
+                cal << %(style="padding-top: #{options[:event_margin]}px;">)
+                cal << %(<div class="ec-event ec-event-#{event.id} )
+                if no_bg
+                  cal << %(ec-event-no-bg" )
+                  cal << %(style="color: #{event.color}; )
+                else
+                  cal << %(ec-event-bg" )
+                  cal << %(style="background-color: #{event.color}; )
+                end
+                cal << %(padding-top: #{options[:event_padding_top]}px; )
+                cal << %(height: #{options[:event_height] - options[:event_padding_top]}px;" )
+                if options[:use_javascript]
+                  # custom attributes needed for javascript event highlighting
+                  cal << %(data-event-id="#{event.id}" data-color="#{event.color}" )
+                end
+                cal << %(>)
+                
+                # add a left arrow if event is clipped at the beginning
+                if event.start_at.to_date < dates[0]
+                  cal << %(<div class="ec-left-arrow"></div>)
+                end
+                # add a right arrow if event is clipped at the end
+                if event.end_at.to_date > dates[1]
+                  cal << %(<div class="ec-right-arrow"></div>)
+                end
+                
+                if no_bg
+                  cal << %(<div class="ec-bullet" style="background-color: #{event.color};"></div>)
+                  # make sure anchor text is the event color
+                  # here b/c CSS 'inherit' color doesn't work in all browsers
+                  cal << %(<style type="text/css">.ec-event-#{event.id} a { color: #{event.color}; }</style>)
+                end
+                
+                if block_given?
+                  # add the additional html that was passed as a block to this helper
+                  cal << block.call({:event => event, :day => day.to_date, :options => options})
+                else
+                  # default content in case nothing is passed in
+                  cal << %(<a href="/events/#{event.id}" title="#{h(event.name)}">#{h(event.name)}</a>)
+                end
+                
+                cal << %(</div></td>)
+              end
+              
+            else
+              # there wasn't an event, so create an empty cell and container
+              cal << %(<td class="ec-event-cell ec-no-event-cell" )
+              cal << %(style="padding-top: #{options[:event_margin]}px;">)
+              cal << %(<div class="ec-event" )
+              cal << %(style="padding-top: #{options[:event_padding_top]}px; )
+              cal << %(height: #{options[:event_height] - options[:event_padding_top]}px;" )
+              cal << %(>)
+              cal << %(&nbsp;</div></td>)
+            end
+          end
+          cal << %(</tr>)
+        end
+        
+        cal << %(</tbody></table>)
+        cal << %(</div>)
+        
+        # increment the calendar row we are on, and the week
+        row_num += 1
+        first_day_of_week += 7
+        last_day_of_week += 7
+      end      
+    
+      cal << %(</div>)   
+      cal << %(</div>)
+      cal << %(</div>)
+    end
+    
+    # override this in your own helper for greater control
+    def day_link(text, date, day_action)
+      link_to(text, params.merge(:action => day_action, :year => date.year, :month => date.month, :day => date.day), :class => 'ec-day-link')
+    end
+    
+    # check if we should display without a background color
+    def no_event_bg?(event, options)
+      options[:use_all_day] && !event.all_day && event.days == 0
+    end
+    
+    # default html for displaying an event's time
+    # to customize: override, or do something similar, in your helper
+    def display_event_time(event, day)
+      time = event.start_at
+      if !event.all_day and time.to_date == day
+        # try to make it display as short as possible
+        fmt = (time.min == 0) ? "%l" : "%l:%M"
+        t = time.strftime(fmt)
+        am_pm = time.strftime("%p") == "PM" ? "p" : ""
+        t += am_pm
+        %(<span class="ec-event-time">#{t}</span>)
+      else
+        ""
+      end
+    end
+  
+    private
+    
+    # calculate the height of each row
+    # by default, it will be the height option minus the day names height,
+    # divided by the total number of calendar rows
+    # this gets tricky, however, if there are too many event rows to fit into the row's height
+    # then we need to add additional height
+    def cal_row_heights(options)
+      # number of rows is the number of days in the event strips divided by 7
+      num_cal_rows = options[:event_strips].first.size / 7
+      # the row will be at least this big
+      min_height = (options[:height] - options[:day_names_height]) / num_cal_rows
+      row_heights = []
+      num_event_rows = 0
+      # for every day in the event strip...
+      1.upto(options[:event_strips].first.size+1) do |index|
+        num_events = 0
+        # get the largest event strip that has an event on this day
+        options[:event_strips].each_with_index do |strip, strip_num|
+          num_events = strip_num + 1 unless strip[index-1].blank?
+        end
+        # get the most event rows for this week
+        num_event_rows = [num_event_rows, num_events].max
+        # if we reached the end of the week, calculate this row's height
+        if index % 7 == 0
+          total_event_height = options[:event_height] + options[:event_margin]
+          calc_row_height = (num_event_rows * total_event_height) + options[:day_nums_height] + options[:event_margin]
+          row_height = [min_height, calc_row_height].max
+          row_heights << row_height
+          num_event_rows = 0
+        end
+      end
+      row_heights
+    end
+  
+    #
+    # helper methods for working with a calendar week
+    #
+    
+    def days_between(first, second)
+      if first > second
+        second + (7 - first)
+      else
+        second - first
+      end
+    end
+  
+    def beginning_of_week(date, start = 0)
+      days_to_beg = days_between(start, date.wday)
+      date - days_to_beg
+    end
+    
+    def end_of_week(date, start = 0)
+      beg = beginning_of_week(date, start)
+      beg + 6
+    end
+  
+    def weekend?(date)
+      [0, 6].include?(date.wday)
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,2 @@
+ActiveRecord::Base.extend EventCalendar::PluginMethods
+ActionView::Base.send :include, EventCalendar::CalendarHelper

data/rails/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/rails/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

data/tasks/event_calendar_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :event_calendar do
+#   # Task goes here
+# end

data/test/event_calendar_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class EventCalendarTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'active_support'
+require 'active_support/test_case'

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: elevation_event_calendar
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- elevation
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-08 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Easily show multiple, overlapping events across calendar days and rows.
+email: info@semanticgap.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- ./CHANGELOG.rdoc
+- ./generators/event_calendar/event_calendar_generator.rb
+- ./generators/event_calendar/lib/insert_routes.rb
+- ./generators/event_calendar/templates/controller.rb.erb
+- ./generators/event_calendar/templates/helper.rb.erb
+- ./generators/event_calendar/templates/javascript.js
+- ./generators/event_calendar/templates/jq_javascript.js
+- ./generators/event_calendar/templates/migration.rb.erb
+- ./generators/event_calendar/templates/model.rb.erb
+- ./generators/event_calendar/templates/stylesheet.css
+- ./generators/event_calendar/templates/view.html.erb
+- ./generators/event_calendar/USAGE
+- ./rails/init.rb
+- ./rails/install.rb
+- ./lib/event_calendar/calendar_helper.rb
+- ./lib/event_calendar.rb
+- ./MIT-LICENSE
+- ./Rakefile
+- ./README.rdoc
+- ./tasks/event_calendar_tasks.rake
+- ./test/event_calendar_test.rb
+- ./test/test_helper.rb
+- ./rails/uninstall.rb
+has_rdoc: true
+homepage: http://github.com/semanticgap/event_calendar
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Calendar helper for Rails
+test_files: []
+