PluginGoogleCalendar

Version 1 (Eric Davis, 2008-03-13 06:59)

1 1 Eric Davis
h1. PluginGoogleCalendar
2 1 Eric Davis
3 1 Eric Davis
4 1 Eric Davis
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.
5 1 Eric Davis
6 1 Eric Davis
Currently, the only way to install is using Git and GitHub:
7 1 Eric Davis
8 1 Eric Davis
bq. URL: http://github.com/mully/redmine_google_calendar/tree/master
9 1 Eric Davis
10 1 Eric Davis
h2. To install from git: 
11 1 Eric Davis
12 1 Eric Davis
(Git Version < 1.5.3)
13 1 Eric Davis
@$ cd {RAILS_ROOT}/vendor/plugins@
14 1 Eric Davis
@$ git clone git://github.com/mully/redmine_google_calendar.git@
15 1 Eric Davis
16 1 Eric Davis
(Git Version >= 1.5.3 -- Because the "git-rails" gem uses Git Submodules introduced in ver. 1.5.3)
17 1 Eric Davis
@$ sudo gem install git-rails@
18 1 Eric Davis
@$ git-rails install git://github.com/mully/redmine_google_calendar.git@
19 1 Eric Davis
20 1 Eric Davis
21 1 Eric Davis
h2. Plugin setup
22 1 Eric Davis
23 1 Eric Davis
# Install the plugin as described "here":http://www.redmine.org/wiki/redmine/Plugins (this plugin doesn't require migration).
24 1 Eric Davis
# Go to "Admin -> Custom fields" and create a Project custom field of "long string" type, named 'Google Calendar IFrame' for example.
25 1 Eric Davis
# Go to "Admin -> Information" to configure the Google Calendar plugin:
26 1 Eric Davis
    * Project custom field 'Google Calendar IFrame': select the newly created custom field.
27 1 Eric Davis
28 1 Eric Davis
h2. Enabling Calendar at project level
29 1 Eric Davis
30 1 Eric Davis
Go To Your Google Calendar:
31 1 Eric Davis
32 1 Eric Davis
# Click on "Settings" in the upper left hand corner
33 1 Eric Davis
# Click on the "Calendars" tab
34 1 Eric Davis
# Select the calendar you want to use
35 1 Eric Davis
# In the "Embed This Calendar" section, copy the entire <iframe> code from the text box
36 1 Eric Davis
37 1 Eric Davis
(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.)
38 1 Eric Davis
39 1 Eric Davis
In your project in Redmine, go to "Project settings" :
40 1 Eric Davis
41 1 Eric Davis
# On the "Modules" tab, enable the module by checking "Google Calendar".
42 1 Eric Davis
# 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.
43 1 Eric Davis
44 1 Eric Davis
After that, a new item named "Calendar" should show up in the project menu. Click on this item to see your Google Calendar.