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

= Embed a Google Calendar into Trac wiki pages

== Description

This plugin integrates a Google Calendar into Trac wiki pages, by embedding such a calendar into an iFrame. 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.

'''Note:''' This plugin is incompatible with Trac 0.12 or 0.13, see #9686 and #8915.

See also: TeamCalendarPlugin, GanttCalendarPlugin

== 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 new ticket].

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

== Download

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

== Source

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

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

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

== Configuration

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).

Through the {{{GOOGLECALENDAR_VIEW}}} permission you can avoid the calendar being visible publicly or you can make it visible to some specific users/groups only. Thanks to AlfonsoEscribano, see #8512.

== Recent Changes

[[ChangeLog(googlecalendarplugin, 3)]]

== Author/Contributors

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