gCalEvents

Package Description

Features:

• Agenda-view
• Week-view
• Caching synced with MODx resource caching
• Support for public and private calendars
• Support for custom feed URL

Features to come:

• Calendar-view
• Multiple calendar support

Usage/Installation Instructions

Please report bugs & feature requests on Github:https://github.com/eelkevdbos/gCalEvents

/* DESCRIPTION */

gCalEvents is a component that requests a Google Calendar eventfeed. It enables you to easily integrate google calendar items into your website.

It can be used to extract raw data from the feed and optionally parse the data to format it. To speed up the code, caching can be enabled.

Both public and private feeds can be used. For private feeds you can either supply your privateCookie in the snippet call or store it like a setting.

/* QUICK START */

[[!gcalAgendaView &userID=`yourcalendaremail%40yourdomain.tld` &cached=`1` &decay=`86400` &limit=`5`]] // for public calendars and caching enabled (1 day decay)

[[!gcalAgendaView &userID=`yourcalendaremail%40yourdomain.tld` &privateCookie=`cookievalue`]] // for private calendars

[[!gcalAgendaView &useSettings=`1`]] // to use system settings

[[!gcalWeekView &useSettings=`1` &includeHeader=`0` &cached=`1`]] // for weekview of agenda defined in settings

[[!gcalWeekView &useSettings=`1` &currentWeek=`1` &currentYear=`2011` &cached=`1`]] // for weekview of agenda starting on week 1 of 2011

For detailed documentation, please visit Github wiki:https://github.com/eelkevdbos/gCalEvents/wiki/

/* GENERAL */

The eventchunk has all the placeholders google calendar specifies in it's feed. A complete list of keys can be found at: 

http://code.google.com/intl/nl-NL/apis/calendar/data/2.0/developers_guide_protocol.html#RetrievingEvents

Multi-level feeds are concatenated with a dot as key. The entries are concatenated with a ', ' as separator.

Example:

Feed: {'attendees':[{'displayName':'John Doe'}, {'displayName':'Henry Lloyd'}]}

Placeholder: [[+attendees.displayName]]

Result: John Doe, Henry Lloyd