Use this widget to display existing events in a “card” format.

You must have at least one event created before adding the Events widget to a page.

When you drag and drop an Events widget onto a page, it will be auto populated with up to 20 event cards by default.

You can then configure it to display events from certain calendars, event types date ranges, or all events. 

To change which events are displayed, click the Edit button  in the upper-right corner of the widget.

The configuration window appears where you can configure the following:

Content

In the content tab, you can choose which calendar(s) you want to pull from and which events you want to display.

Under Which events to display? select one of the following:

·         All events

With this selection, all events are displayed, and up to 20 will be shown per page within the widget.

·         Events by date…

This will make the widget only display events from a selected date range:

o   Upcoming events…

By default, this option will display upcoming events from any time in the future.

If you click the “Change” button, another window will pop up which will let you choose events from a range of days, weeks, months or years.

Under “Custom range…” you can choose a specific date range, down to the hour.

o   Current events

This option should not be used by itself, but it’s fine to use in conjunction with Upcoming events. 

 Selecting only “Current events” will only show events that are currently in progress, and the widget will be empty unless there is an event happening at the time the webpage is being viewed. I.e., if you have an event scheduled for July 4, 2019 from 10am-2pm, the widget will only display the event content on July 4, 2019 from 10am-2pm, the rest of the time the content area would be empty. 

o   Past events…

Just like Upcoming events, by default, this option will display upcoming events from any time in the past.

If you click the “Change” button, another window will pop up which will let you choose events from a range of days, weeks, months or years.

Under “Custom range…” you can choose a specific date range, down to the hour.

·         Selected events…

You can choose to display only the events you manually select.

If you click “Narrow selection,” you can further specify which events to display by choosing one of the following:

·         All published events

This is selected by default and displays all events from the dates selected in the previous step.

·         Filtered events by…

You can narrow down the displayed events by Calendar, Categories, Chapters and Tags

Select one or more of the following:

o   Calendar…

A Select button will appear. Click it to select the calendar from which you want to display events, then click Done.

o   Categories…

Select the categories from which you want to display events, then click Done.

o   Chapters…

Select the chapter from which you want to display events, then click Done.

o   Tags…

This will display events with tags you select.

List Settings

On this tab you can choose how to display the events you have selected.

By default, the events will be paginated within the widget’s content area, and up to 20 event cards will be displayed per page. You can limit this by selecting one of the following options:

·         Use paging

The system divides the event cards into pages.

In the input field you can specify how many events per page you want to display.

·         Use limit

The system displays only a limited number of the events you have chosen to display.

In the input field, you can specify how many events you want to display.

·         No limit and paging

 This option should not be used as it can result in an extremely long page and slow load times.

In the Sort events dropdown menu, you can select a sorting method for the events. By default, the event with the oldest start date is shown first.

You shouldn’t need to change this if you are only displaying Upcoming events. This will sort the events by the order in which they happen starting with your next upcoming event and moving forward.

List template will only have one option and cannot be changed.

Single item settings

Here, you will choose how you want to open the details of a single event when it’s clicked on.

Under Open single item in…, you can choose from the following:

·         Selected existing page…

Always use this selection.  The Single Event Page will have already been created and is part of the CMS.

If you need to create an additional page to display a single event:

o   Create a child page under Education & Events, name it “Single Event”

o   Un-check “Show in navigation”

o   Use template “ChapterTemplate”

o   Click “Create and go to add content”

o   On the page, drag an Events widget into the main content area. The page does not need any other elements or editing.

o   Publish the page

Now you have a page that can display all the details of a single event item. Click the Edit button on the Event widget, go to the Single item settings tab, click the radio button for “Selected existing page…,” click the Select button, choose the “Single Event” page you created under Education & Events, then click “Done selecting.”

The Detail template dropdown menu will only have one option and cannot be changed.