Redmine

h1. PluginGoogleCalendar

A simple plugin to include Google Calendar iframe as a tab within Redmine projects.  The calendar timezone will be user dependent based off the timezone in your Redmine user account and defaulted to the timezone set in the <iframe> if the user does not have a timezone selected.

Currently, the only way to install is using Git and GitHub:

bq. URL: http://github.com/mully/redmine_google_calendar/tree/master

h2. To install from git: 

(Git Version < 1.5.3)

<pre>

$ cd {RAILS_ROOT}/vendor/plugins

$ git clone git://github.com/mully/redmine_google_calendar.git

</pre>

(Git Version >= 1.5.3 -- Because the "git-rails" gem uses Git Submodules introduced in ver. 1.5.3)

<pre>

$ sudo gem install git-rails

$ git-rails install git://github.com/mully/redmine_google_calendar.git

</pre>

h2. Plugin setup

# Install the tzinfo gem if it does not already exist on your server:  <pre>$ sudo gem install tzinfo</pre>

# Install the plugin as described "here":http://www.redmine.org/wiki/redmine/Plugins (this plugin doesn't require migration).

# Go to "Admin -> Custom fields" and create a Project custom field of "long string" type, named 'Google Calendar IFrame' for example.

# Go to "Admin -> Information" to configure the Google Calendar plugin:

    * Project custom field 'Google Calendar IFrame': select the newly created custom field.

h2. Enabling Calendar at project level

Go To Your Google Calendar:

# Click on "Settings" in the upper left hand corner

# Click on the "Calendars" tab

# Select the calendar you want to use

# In the "Embed This Calendar" section, copy the entire <iframe> code from the text box

(If this is a private calendar, you will have to replace the "src" in the <iframe> with the HTML found by clicking the blue "HTML" block in the "Private Address" section on the same page.)

In your project in Redmine, go to "Project settings" :

# On the "Modules" tab, enable the module by checking "Google Calendar".

# On the "Information" tab, paste the <iframe> code that you have copied in your clipboard from Google next to the 'Google Calendar IFrame' project custom field you created in step 1.

After that, a new item named "Calendar" should show up in the project menu. Click on this item to see your Google Calendar.