Project

General

Profile

PluginGoogleCalendar » History » Version 4

Mischa The Evil, 2009-06-15 02:46
Fixed typos and some more

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