google-calendar

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

Labels

macro macro Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.