2008-01-22

Meta: Google Calendar

I finally figured out how to aggregate multiple Google Calendars into a single view. I knew it was possible, because others have done it with my Flatbush Gardener calendar. My calendar has been in the sidebar for some time now, but I have to squish and stretch it so it will fit comfortably. Here's a big version.



I found the trick to aggregation in the Google Calendar Help Center:

If you'd like to customize your embedded calendar, click the link above the iframe field to access the Google Embeddable Calendar Helper. ...
To display events from multiple calendars in the same embedded calendar, simply follow the instructions above to access the Google Embeddable Calendar Helper. Then, check the box next to each calendar you wish to display, listed under "Calendars to Display."
- How do I embed Google Calendar on my website?

The "link" mentioned reads "Customize the color, size, and other options." "Other options" is a rather obscure reference to "oh, and by the way, you can aggregate multiple calendars."

Of more importance is the HTML that gets rendered, in particular, the parameters to the URL which is the src of the iframe which renders the calendar. Here's a partial list of what my calendar widget now contains:
  1. %lt;iframe src="">
  2. showTitle=0
  3. mode=AGENDA
  4. height=300
  5. wkst=2
  6. bgcolor=#FFFFFF
  7. src=xrisfg@gmail.com
  8. color=#0D7813
  9. ...>
And here's a translation:
  1. "iframe" is the "container" for the calendar. "src" identifies the contents. Here, we're asking Google Calendar to generate the contents for use, based on the other parameters we provide.
  2. "0" (zero) is programmer for "No" or "Off". In other words: don't display the title of the calendar, "Xris (Flatbush Gardener)".
  3. The default layout for the calendar. On wide displays, tabs at the top of the calendar allow you to choose different layouts. I chose "Agenda" as the default because it shows the most information about each event.
  4. The height, in pixels (dots on your display) for the contents.
  5. "wkst=2" means "Make Monday the start of the week." Doesn't make any difference for the Agenda layout.
  6. "bgcolor" = "background color." "FFFFFF" means "white."
  7. Which calendar to display (mine, in this case).
  8. With which color to display the preceding identified calendar.
  9. Repeat 7&8 for each calendar you want to aggregate.



No comments: