-
Jim Mulholland
For the complete changelog see the CHANGELOG-file in the Redmine Google Calendar plugin directory.
The currently available, latest stable release of the plugin is version 0.1.2.
The Google Calendar plugin is a simple Redmine plugin which provides the project-manager a way to include a 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.
This plugin is compatible with Redmine 0.8.x as well as with the current Redmine trunk.
The plugin requires the tzinfo-gem (tzinfo.rubyforge.org) to be available. If it does not already exist on your server, you can install it using a command like:
$ sudo gem install tzinfo
The plugin can be downloaded as packaged releases from:
-
this GitHub-site: github.com/MischaTheEvil/redmine_google_calendar/downloads
-
this MediaFire-account: www.mediafire.com/evildev
URL of the GitHub repository: http://github.com/MischaTheEvil/redmine_google_calendar/tree/master
The source of this plugin can be “cloned” from the GitHub-repo using two different methods:
-
using
git clone(Git version < 1.5.3):$ cd {RAILS_ROOT}/vendor/plugins && git clone git://github.com/MischaTheEvil/redmine_google_calendar.git -
using
git-rails(Git version >= 1.5.3 – Because thegit-railsgem uses Git Submodules which were introduced in v. 1.5.3):$ sudo gem install git-rails && git-rails install git://github.com/MischaTheEvil/redmine_google_calendar.git
-
Download the plugin from the available sources (see www.redmine.org/wiki/redmine/PluginGoogleCalendar#Obtaining)
-
Install the plugin as described at: www.redmine.org/wiki/redmine/Plugins, according to the way you’ve obtained the plugin (this plugin does not require a plugin database migration)
-
Restart Redmine
Before you can actually use the plugin within the preferred projects some setup has to be done first.
-
Go to “Administration -> Custom fields” and create a Project custom field of the type “long text”, named ‘Google Calendar IFrame’ for example.
-
Go to “Administration -> Plugins -> Google Calendar Plugin > Configure” to configure the Google Calendar plugin:
-
select the project custom field which contains the Google Calendar-iframe; in this example select the newly created project custom field “Google Calendar IFrame”
-
After you have completed the global setup of the plugin you can select which projects will actually be able to use the feature brought by the plugin. Due to the way the plugin implements this feature it is also possible to configure which Google Calendar is actually being displayed on a project level base. The project level setup consists of the following two tasks:
You should retrieve the actual Google Calendar embedding-code (<iframe>). Therefore, go to the Google Calendar which you want to embed and:
-
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.)
For detailed help on how to obtain the calendar-information see www.google.com/calendar/embed/EmbedHelper_en.html.
Now the copied <iframe> code should be added to a Redmine project. At first we need to make sure the plugin is enabled for the project. In the preferred Redmine project, go to the “Project settings”:
-
On the “Modules” tab: enable the plugin-module by checking “Google Calendar”.
-
On the “Information” tab: paste the
<iframe>code, that you have copied to your clipboard from the Google Calendar you want to embed, into the ‘Google Calendar IFrame’ project custom field you created in the global setup under step 1.
After that, a new item named “Calendar” will show up in the project menu. Click on this item to see your Google Calendar.
-
On the project overview tab I see the iframe code. Could that be removed?
-
Yes, see my Redmine patch #1746 (www.redmine.org/issues/1746) which provides an option to project custom fields to hide them from the project overview especially written for this purpose.
-
-
When using packaged releases: download the latest source of the plugin from the available sources (see www.redmine.org/wiki/redmine/PluginGoogleCalendar#Obtaining)
-
Backup the currently deployed Google Calendar plugin (
cp -r /vendor/plugins/redmine_google_calendar /vendor/plugins/redmine_google_calendar-backup) -
Reinstall the updated plugin:
-
When using packaged releases: Unpack the downloaded file to your Redmine into the plugin-directory “../vendor/plugins” and let it overwrite your outdated plugin instance (which you’ve backed-up earlier)
-
When using the GitHub-sources: with either
git pullorgit-rails update
-
-
Restart your Redmine
-
Remove the directory “redmine_google_calendar” from the plugin-directory “../vendor/plugins”
-
Restart Redmine
This plugin is open-source and licensed under the “GNU General Public License v2” (GPL, www.gnu.org/licenses/old-licenses/gpl-2.0.html). See the included COPYRIGHT.txt and GPL.txt files for details.
-
©2009, Mischa The Evil (www.evil-dev.net)
-
©2008, Jim Mulholland (www.squeejee.com)
If you would like to report a bug or request a new feature you can open a new issue at the issue-tracking section of the plugins’ GitHub site: github.com/MischaTheEvil/redmine_google_calendar/issues. You can also post your feedback about the plugin in the dedicated plugin-section of the Redmine forums (www.redmine.org/projects/redmine/boards/3)
As an alternative you can also join the #redmine-channel on the “freenode IRC network” (freenode.net/irc_servers.shtml) to see if the active maintainer is connected (with the nickname Mischa_The_Evil).