gCalEvents

gcalevents

  • By eelkevdbos
  • Latest release September 11, 2011 (15 years ago)

About

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.

Installation & usage

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

At a glance

MODX 3 compatibility unknown. Based on our testing and community reports where available.

  • Developer eelkevdbos
  • Latest release September 11, 2011 (15 years ago)
  • First seen in SiteDash September 6, 2011 (15 years ago)
  • License GPLv2
  • MODX support 2.1 – 100.0

Releases 1 indexed release

Changelog
MODX.com

0.3.0-alpha

September 11, 2011

15 years ago

<p><b>Bug fixes</b>:</p><p>Stylesheet corrections.</p><p>Errormessage from feed added.</p><p><b>Changes (!IMPORTANT!)</b>:</p><p>showAgenda is now gcalAgendaView</p><p>showWeek is now gcalWeekView</p><p><b>Changes (.. LESS important)</b>:</p><p>Cleanup of code.</p><p>Check for cache initiation</p>