gCalEvents 0.3.0-alpha

gCalEvents 0.3.0-alpha

Released Sep 11, 2011 by eelkevdbos

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 in a system-/context-/usersetting.

Download 65kb (1803 downloads)
Downloads: 2,262
License: GPLv2
Requires Revolution 2.1.x or greater
Supports mysql,sqlsrv

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

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

Bug fixes:

Stylesheet corrections.

Errormessage from feed added.

Changes (!IMPORTANT!):

showAgenda is now gcalAgendaView

showWeek is now gcalWeekView

Changes (.. LESS important):

Cleanup of code.

Check for cache initiation

Version Released Author Downloads
3 Versions 1 Contributors 2,266 Downloads
0.2.2-alpha Sep, 06 2011 eelkevdbos 246
0.1.0-alpha Sep, 01 2011 eelkevdbos 220