The Event Aggregator: Event Importer

The Events Calendar has an importing tool called the Event Aggregator. The Event Aggregator enables you to import calendars from other sources, including Facebook, iCalendar, Google and more. You can even import EWU's calendars, such as the Academic Calendar and the EWU Events Calendar. In this way, you can have a full calendar on your WordPress site without needing to manually create events. This article will cover all the basics of importing events.

Getting Started

To import events, you first need to navigate to the Event Aggregator. You can get to the Event Aggregator in two ways. The first is to hover over Events in the Admin Toolbar and select Import from the drop-down.

Import through Admin Toolbar

The second is the navigate to the dashboard of your site. Hover over Events in the sidebar, and then select Import.

Import through dashboard

Both methods will take you to a page titled Events Import. This page contains the Events Aggregator.

The Event Aggregator

Importing Events

Import Origins

Next, select the origin of the events or calendar you want to import. The settings of the import will vary depending on the origin. For more details about each import type, see the Events Calendar’s knowledge base articles:

Importing Data from a CSV File

Importing Events from a Feed or URL

Importing Events from an ICS File

Refine Imports

Once you choose an imported origin, you have the option to narrow your import results by keywords, date and/or location. For example, you can filter the import so that only events located within a 5-mile radius of Cheney will show. Note that the filter is not perfect, and depends on how the source is formatted. It might filter out events you want to import.

Import origin, file upload, and refine import options

Import Preview

Once you select your import origin and optional import refinements, select Preview. This will generate a full list of the events that will be imported. You can either import all events or check the events that you want to import. You have the option to import the events as drafts, pending review, private, or published (default). You also have the option to sort the events into an event category.

Preview list of events

To import the events, select the Import All button (Or Import Checked, if you have checked any events). The import will start.

Editing Imports

Once your events are imported, you can edit your events just as you would any other event you created. You can choose which events to display or ignore. Imports may also include Event Categories and Venues, which you can also edit.

Your changes will only reflect on your site; they will not affect the source calendar.

Per default settings, any changes made to the source calendar will override your changes with the next import. To change this setting so that your changes are preserved, navigate to Events > Settings > Imports.

Events settings Import tab

Under Event Update Authority, select the option that says, “Import events but preserve local changes to event fields.”

Event update authority settings

Importing EWU Calendars

EWU’s calendars—including the Academic Calendar and the EWU Events Calendar—are hosted on 25Live. Thanks to the Events Aggregator, you can import these events into your Events Calendar and display them on your site.

To import events from the Academic Calendar or the EWU Events Calendar, first, navigate to the page where the 25Live calendar is located. The embedded calendar will look like this:

25Live embedded calendar

One-time imports

One-time imports include all events in the current feed. By default, the Event Aggregator will only import events one month out from the current date; you can change this setting to import up to three months of events. The best way to perform a one-time import for 25Live is with an ICS file.

You can find the ICS file at the top of a 25Live calendar. In the top right corner of the calendar is a link that says iCAL. If you click on this link, it will trigger an automatic download of the ICS file for the 25Live Calendar.

Once you have the ICS file, navigate to the Event Aggregator. From Import Origin, select ICS File. Upload the ICS file you just downloaded. Optionally, refine your search by keyword, date or location. Then select Preview. Select the events you want to import or import all.

Scheduled Imports

Scheduled imports automatically grab new events and updates from the source calendar on a set schedule. Like one-time imports, they will pull one month of events from the current date by default. However, scheduled events will regularly and automatically import, removing the need to manually import at a later time.

In the top right corner of the 25Live calendar, select Subscribe. This will bring up a window with multiple subscription options. Select Subscribe to iCalendar Feed and then click Subscribe.

Subscribe to iCalendar

This will prompt you to open the Calendar app. Select Open Calendar. When the Calendar app opens, copy the Calendar URL.

Calendar URL

In your WordPress dashboard, navigate to the Event Aggregator. From Import Origin, select iCalendar. In Import Type, select Scheduled Import. Select how often you want your calendar to pull changes from the source. (Note that you can also perform a one-time import. This will produce the same result as using an ICS file to import.) In URL, paste the Calendar URL that you previously copied.

Optionally, refine your search by keyword, date or location. Then select Preview. Like with a one-time import, this will generate a list of events. However, you cannot select events to import with a Scheduled import; you can only import all. You can, however, choose to ignore or delete events after they have been imported.

To begin the import, select Save Scheduled Import.