devot:eeDevoted to ExpressionEngine

The Google Calendar Events plugin displays a list of upcoming events from one or more Google Calendars in your web site. It contains variables for the main Calendar fields (what, where, when, description), can combine events from multiple Calendars in a single event list, and has an alternate start_day variable pair for displaying a date header above the first event per day.

Google Calendar Events is a plugin for the ExpressionEngine Content Management System that provides a new {exp:googlecal_events} tag for your templates.

The {exp:googlecal_events} tag displays a list of upcoming events from one or more Google Calendars in your web site. This makes it possible to take advantage of the superior editing and time management features of Google Calendar while displaying these scheduled and/or recurring events in your own style on your site.

Requires the free Zend Gdata package and a working Google account to use. This plugin has been tested with ExpressionEngine 1.6.8.

Installation

 
1. Download the Zend Gdata package and install the Zend library in a directory in your PHP Include Path.
 
2. Download this plugin to your site’s System/Plugins directory.

Parameters

                                                                                               

Name	Description
google_calendars	The Google Calendar id (eg “12345@group.calendar.google.com”) or a comma-delimited list of id’s.
user	The username of your Google account (your Gmail address should work here).
password	The password of your Google account.
num_days	The number of days to display
max_cache_age [optional]	The maximum age in seconds of the local file cache for the events. If not specified, the default value of 900 (15 minutes) will be used.

Single Variables

                                                                                               

Name	Description
{start_time format=“%Y %m %d”}	The start time of the event. Uses ExpressionEngine’s Date Variable Formatting
{end_time format=“%Y %m %d”}	The end time of the event. Uses ExpressionEngine’s Date Variable Formatting
{what}	The title of the event (from the “what” field in Google Calendar)
{where}	The location of the event (from the “where” field in Google Calendar)
{description}	The description of the event (from the “description” field in Google Calendar)

Variable Pairs

                               

Name	Description
{start_day}   {start_day_format   format=“%Y %m %d”} {/start_day}	The start time of the event, only displayed for the first event each day. Uses ExpressionEngine’s Date Variable Formatting . This makes it possible to create a Date header that appears above all of the events for that day.

Example 1 – Simple List Of Events

{exp:googlecal_events google_calendars="<cal>" user="<user>" 
    password="<password>" num_days="14" }
    {start_time format="%g:%i %a"}: {what} ({where})<br>
{/exp:googlecal_events}

Example 2 – TV Shows This Week

{exp:googlecal_events 
    google_calendars="3t2brro1crmt94uuqomrgipqiulm7fs7@import.calendar.google.com"
    user="<user>" password="<password>" num_days="7" 
}
    {start_day}<div style="font: bold 14px Verdana;">
        {start_day_format format="%l, %M %j %Y"}
    </div>{/start_day}
    {start_time format="%g:%i %a"} - {what} <br>
    <div style="margin: 0 4em 1em 4em;">{description}</div>
{/exp:googlecal_events}

Download Google Calendar Events

EE Version	Downloads	Add-On Version	Release Date
1.x	Download	1.0	03/28/2010

Google Calendar Events Links

• GitHub Project Page
• [EE Forums] Forum Thread

This entry was last updated March 31, 2010, 5:37 pm.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. Devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!