Extremely Simple Calendar Integration for Rails
Today we’ll go over an extremely simple way to add a javascript/css calendar to your Rails app. We will be using the Calendar Date Select Plugin. It is a small, easy to use calendar based on the prototype library.
This was written back in the day for Rails 1.2, so take all this information with a grain of salt.
Installation is simple, and uses the typical installation syntax:
script/plugin install http://calendardateselect.googlecode.com/svn/tags/calendar_date_select
Voila! Installed!
Now, we just need to integrate it.
First, in your layout you need to add the javascript tag:
<%= calendar_date_select_includes "silver" %>
You can also use “red”, “blue” or “nil” for other color schemes.
Also note that you need to have prototype included as well, so if you haven’t already, you should also add the following to your layout:
<%= javascript_include_tag :defaults %>
And now, we’re ready to use it! Usage is simple. I was using it to keep track of an expiry date for a property, so I used to the following tag:
<%= calendar_date_select_tag "property[expiry_date]", @property.expiry_date.to_s %>
If you wish, you can also check out the demo section for more information on using it with Form Builder.
Finally, I didn’t like the default ‘natural’ syntax for the date “August 8th, 2007″, so I changed it to use my preference, hyphenated syntax. To do this, open your environment.rb file and add the following line:
CalendarDateSelect.format = :hyphen_ampm
There! That is all I needed to do. Of course, there are more options, simply adding a :time => true will allow you to have a time field as well. There are a few more configuration options available for the calendar. You can find out more and get some more screenshots by visiting the project’s homepage.
Update:
Sorry, I haven’t responded to basically anyone that has commented here. I wish I had more time, but at this point I don’t. I am planning on getting back into this, but it might take a while. :(