This chapter describes how to embed Google calendars in your course. For more information, see any of the following topics.
You can also use Google Drive files, such as documents, spreadsheets, and images, in your course. For more information, see Google Drive Files Tool.
Google services are not available in some regions and countries. If Google services are not available in a learner’s area, the learner might see an “image unavailable” message in the place of the Google Drive file or calendar. We strongly suggest that you provide alternative resources for learners in these areas.
You can embed a Google calendar in your course so that students see the calendar in the courseware. You can use a Google calendar to share quiz dates, office hours, or other schedules of interest to students. For example:
Embedding a Google calendar in your course has three steps.
You can enable Google Calendars in the course by using either Studio or OLX.
To enable Google Calendars in your course:
From the Settings menu, select Advanced Settings.
In the Advanced Module List field, place your cursor between the braces,
and then type
"google-calendar". If you see other values in this field,
add a comma after the closing quotation mark for the last value, and then
"google-calendar". For example:
At the bottom of the page, select Save Changes.
To enable Google Calendars in your course, you edit the XML file that defines
the course structure. You locate the
attribute, and add the string
google-calendar to it.
For example, the following XML code enables Google Calendars in a course. It also enables Google Drive files.
<course advanced_modules="["google-document", "google-calendar"]" display_name="Sample Course" start="2014-01-01T00:00:00Z"> ... </course>
For more information, see The Courseware Structure.
Before you can add a Google calendar to your course, you must make the calendar public and obtain its ID.
The tasks described in this section rely on the use of third-party software. Because the software is subject to change by its owner, the steps provided here are intended as guidelines and not as an exact procedure.
Open the Google calendar.
From the Settings menu, select Settings.
Select the Calendars tab.
You might have multiple calendars on the Calendars tab. Find the calendar that you want to share in your courseware.
In the row for the calendar to share, in the Sharing column, select Edit Settings.
Click the Share this Calendar tab, and then select Make this calendar public.
The Calendar Settings page closes, and you return to the Calendars tab. You continue by obtaining the Google calendar’s ID.
On the Calendars tab, click the name of the calendar.
Select the Calendar Details tab.
Next to the Calendar Address label, look to the right of the three colored XML, ICAL, and HTML buttons. In parentheses, you can see the calendar ID.
The calendar ID resembles the following text.
Select and copy the calendar ID. You use this value to configure the Google calendar component in your course.
To add a Google calendar in the courseware, you create aan advanced component in Studio or create a Google calendar XBlock in OLX.
Make sure that you enable Google Calendars in your course before you add the Google Calendar component.
To add a Google calendar component:
On the Course Outline page, open the unit where you want to add the Google calendar component.
Under Add New Component click Advanced, and then select Google Calendar.
The new component is added to the unit, with the default edX Google calendar embedded.
In the new component, select Edit.
In the Display Name field, type the name for the component.
In the Public Calendar ID field, paste the calendar ID you copied in the Obtain the Google Calendar ID task.
For the Default View field, select Month, Week, or Agenda.
This is the initial view that your students have of the calendar. Each student can change his or her view.
You can then Preview Course Content to see how the unit with the Google calendar will appear to students.
To add a Google calendar XBlock in OLX, create the
You can embed this element in the
vertical element, or you can embed this
element in its own file that is referenced within the vertical. For more
information, see The Courseware Structure.
<google-calendar url_name="4115e717366045eaae7764b2e1f25e4c" calendar_id="email@example.com" default_view="1" display_name="Class Schedule"/>
The value of the
calendar_id attribute is the calendar ID that you copied
in the Obtain the Google Calendar ID task.
The edX Learning Management System sets the height and width values for Google Calendars. If you add these attributes, the LMS overrides your changes.
When you make changes to a Google calendar that is embedded in your course, students see the updates immediately. You make changes to calendars with the Google user interface. You do not need to edit the Google Calendar component.