Public Sharing

Your Google Calendars™ must be publicly shared for gCalMarkup to use them.  To make a calendar public follow these steps (also see Google's Help page here):

  • Log into Google Calendar
  • Select the small triangle to the right of a calendar name in the calendar list to the lower left of the page.
  • Select "Share this calendar" from the menu.
  • Check the "Make this calendar public" box:

Key (Calendar ID)

You must also obtain the Calendar ID from each of your calendars that you intend to use with gCalMarkup.  These IDs are used as the key parameter of the {gCalDefine calendar.../} commands.  To find the keys follow these steps (also see Google's Help page here):

  • Log into Google Calendar
  • Select the small triangle to the right of a calendar name in the calendar list to the lower left of the page.
  • Select "Calendar Settings" from the menu.
  • Scroll down to the "Calendar Address:"

  • The key is the part after ":" and before ")" (shaded blue above).
  • Change the "@" in the key to "%40" (see below for more detail on why this is necessary.) so the key above becomes: "6hmji7d389ho5eavfq817fgtmlcg7iur%40import.calendar.google.com"
  • Be sure not to use the private address for the calendar

Google Calendar IDs can be in several formats. A normal public calendar looks like this:

  • teel1p2f28q985gr9i9mod53sg@group.calendar.google.com
While a public calendar created from an iCal feed looks like this:
  • 6hmji7d389ho5eavfq817fgtmlcg7iur@import.calendar.google.com

Joomla has an email cloaking feature that is enabled by default.  Google Calendar IDs contain "@" symbols and the cloaking feature interprets them as email addresses.  To avoid this the "@" symbols must be converted to "%40" or the email cloaking feature must be turned off.  The above Google Calendar IDs become:

  • teel1p2f28q985gr9i9mod53sg%40group.calendar.google.com
  • 6hmji7d389ho5eavfq817fgtmlcg7iur%40import.calendar.google.com

Alternatively, the email cloaking feature can be turned off by following these steps:

  • Log in the Joomla administrator for your site.
  • Select "Extensions / Plugin Manager" from the menu
  • Select "Content - Email Cloaking" and click on the green check to disable it (it will become a red X)