[[PageOutline(2-5,Contents,pullout)]]

= Google Calendar Plugin

== Description

This plugin integrates a Google Calendar IFRAME into Trac. See also #2374.

It is compatible with Trac 0.10 and 0.11: tested with Trac 0.10.3 and 0.11.7.

For use with Trac 0.11 you have to install ClearSilver as well, see #8128.

'''Incompatible with Trac 0.12 or 0.13, see #9686 and #8915'''

See also: TeamCalendarPlugin, GanttCalendarPlugin, CalendarPlugin

== Bugs/Feature Requests

Existing bugs and feature requests for GoogleCalendarPlugin are 
[report:9?COMPONENT=GoogleCalendarPlugin here].

If you have any issues, create a 
[/newticket?component=GoogleCalendarPlugin&owner=StefanSimroth new ticket].

[[TicketQuery(component=StefanSimroth&group=type,format=progress)]]

== Download

Download the zipped source from [download:googlecalendarplugin here].

== Source

You can check out GoogleCalendarPlugin from [http://trac-hacks.org/svn/googlecalendarplugin/trunk here] using Subversion, or [source:googlecalendarplugin browse the source] with Trac.

== Installation

Install like any other trac:TracPlugins.

This could be simply done by using the Web-Admin UI.

== Example

An example `trac.ini` file is as follows:

{{{#!ini
[components]
googlecalendar.* = enabled

[googlecalendar]
calendar_url = http://www.google.com/calendar/embed?src=823sd8f7f87bgj67jhssd6f5%40group.calendar.google.com&ctz=Europe/Berlin&pvttk=92h3bfjgh2345gsah355hjh
}}}

'''Notes:''' 
 * In `trac.ini` you have to enable the plugin and configure it with the Calendar URL. This can either be the public URL (if your calendar is public) or the private URL.
 * If you choose your private URL, you can usually see this in the About Trac > Configuration page (if you didn’t adjust the permissions).

== Permissions

Thanks to AlfonsoEscribano you have now {{{GOOGLECALENDAR_VIEW}}} permissions to avoid the calendar being visible publicly or make it only visible to some users/groups (see #8512).

== Recent Changes

[[ChangeLog(googlecalendarplugin, 3)]]

== Author/Contributors

'''Author:''' StefanSimroth [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' AlfonsoEscribano