Calendar Maker

Putting a calendar on a web page is easy now. Also, you can add events to a calendar, which are denoted by adding a custom class name to that day, allowing you to style it differently, or even define behavior for that day via unobtrusive Javascript.

Usage

You can create a new calendar object by simply running "Calendar.new" from either your controller or your view. You can specify the month and year of your calendar like so:

@calendar = Calendar.new(:month => 'oct', :year => 2001)

If you'd like to add events to the calendar object, you can simply pass it an array of objects via its #add method, then designating an attribute to signify the event date using the :schedule_for option. This option is not optional. If you don't include it, an ArgumentError exception will be raised.

You can also specify which class should be added to days that have certain events by using the :html_class option. If you don't provide one, then the plugin will just add the :schedule_for value as a class name.

Finally, use the #generate method to actually render the HTML code for your calendar.

Example

In your controller...

class PartyController < ApplicationController def index @parties = Party.find(:all) @calendar = Calendar.new @calendar.add @parties, :schedule_for => :party_date, :html_class => "party_time" render :action => :index end end

In your view...

<%= @calendar.generate %>

Todo

• Clean it up. Big time.
• Finish documentation.

Copyright (c) 2007 Pat Nakajima, James Herdman, released under the MIT license