{google-calendar}
Plugin: Google Calendar Plugin
This macro displays a Google Calendar within Confluence.
Description
It can be set to default in either 'month' or 'agenda' mode, as well as some other refinements.
Usage
{google-calendar:mode=[month,agenda,mini]|colors=green,red,#FF00FF|controls=[all,navigation,none]|title=Title|eventsPerDay=X|width=X|height=X}
// Public XML Link (green)
http://www.google.com/calendar/feeds/[calendar id 1]/public/basic
// Private ICAL Link (red)
http://www.google.com/calendar/feeds/[calendar id 2]/private-[private key]/basic.ics
// Public HTML Link (#FF00FF, aka purple)
http://www.google.com/calendar/embed?src=[calendar id 3]
{google-calendar}
Parameters
| Name | Required | Default | Description |
|---|---|---|---|
| mode | | month
| The default calendar mode ('month', 'agenda'). |
| controls | | navigation
| The controls to display ('all', 'navigation' or 'none'). |
| title | | The title to display if displaying 'all' controls. Defaults to the first calendar's name. | |
| firstDay | | The day of the week to start on. May be any day of the week. | |
| colors | | A comma-separated list of colours for each of the calendars being displayed.
Note: This currently only has any effect when mode is 'mini'. | |
| bgcolor | | The background colour ('#AABBCC' or 'red', 'blue', etc). | |
| width | | 100%
| The width of the calendar (either pixels - '500' - or percentage - '80%'). |
| height | | 610
| The height of the calendar in pixels (eg. '350'). |
Examples
Standard calendar listing Australian holidays
{google-calendar}
// Australian Holidays calendar (XML link)
http://www.google.com/calendar/feeds/australian@holiday.calendar.google.com/public/basic
{google-calendar}
Australian and US holidays agenda
{google-calendar:mode=agenda|title=Australian and US Holidays|controls=all}
// Australian Holidays calendar (XML link)
http://www.google.com/calendar/ical/australian@holiday.calendar.google.com/public/basic
// USA Holiday calendar (ICAL link)
http://www.google.com/calendar/ical/usa@holiday.calendar.google.com/public/basic.ics
{google-calendar}
Australian and US holidays in mini mode
{google-calendar:mode=mini|title=Australian and US Holidays|controls=all|width=250|height=450|colors=green,red}
// Australian Holidays calendar (XML link) (green)
http://www.google.com/calendar/ical/australian@holiday.calendar.google.com/public/basic
// USA Holiday calendar (ICAL link) (red)
http://www.google.com/calendar/ical/usa@holiday.calendar.google.com/public/basic.ics
{google-calendar}
Notes
Calendar URLs can be found in the 'Calendar Details' section of a given Google Calendar. You can use any one of the
,
or
links for a calendar. You can also use a single private link, however be aware that anyone who can view the page will be able to view the URL, so your private calendar will be private no longer.
See Also
- Calendar Plugin - Allows adding events dynamically from within Confluence.
Discussions