Configuring the Events widget

Use this widget to display already created events.

PREREQUISITES: You have created at least one event. For more information, see Creating and editing events.

After you have dragged the Events widget on your page, the widget automatically displays all published events.
To configure the display of the events, perform the following:

Click Edit button in the upper-right corner of the widget.
The Events window appears where you can configure the following:

Content

In content, you can choose which events of all the created events you want to display.

1. In Which events to display? radio button select the events that you want to display.
   The events are grouped according to the time for which they are scheduled. To display all events, select All upcoming, current, and past events.
2. Under Narrow the 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 selected in the previous step.
• One particular event only…
  Select one event to display using the Select an event button.
• Selection of events
  You can narrow the displayed events, using categories, tags, and dates.
  Select one or more of the following:
  • by Categories…
    Click the Select button to select the categories from which you want to display events and click Done.
  • by Tags…
    Click Select button to select the tags, so that events tagged with those particular tags will be displayed and click Done.
  • by Dates…
    Click Select button.
    Select one of the predefined time intervals, so that events created during that interval will be displayed or choose Custom range… and use the From and To input fields to select a time interval. When finished click Done.

List Settings

On this tab you choose how to display the event(s) you have selected.

• If you select Use paging radio button, the system divides the events into pages.
  In the input field you specify how many events per page you want to display.
• If you select Use limit radio button, the system displays only a limited number of the events you have chosen to display.
  In the input field, you specify how many events you want to display.
• If you select No limit and paging radio button, the system displays all the events that you have selected in Content tab.
• In Sort events dropdown box, select a sorting criterion for the events.
• In List template, select the template which is used to display the events on the webpage.
  You can create a custom template by clicking Create new template. You can edit existing templates by selecting them and clicking Edit.
  For more information, see Creating and editing widget templates.

Single Item Settings

On this tab you choose the way to display the events.
In Open Single item in… radio button, select one of the following:

• Auto-generated page
  When an event is clicked, it is displayed in a page which is automatically generated and has the same layout as the current page.
• Select existing page…
  You select a page from the existing pages with certain layout where an event will be displayed when clicked.

  NOTE: In order to display the event, the page you have selected must have the Events widget added.

  1. Click Select Page.
     From the treeview, select the page where you want to display the event.
  2. Click Done selecting.
• In Detail templates, select the template which is used to display the events on the webpage.
  You can create a custom template by clicking Create New Template. You can edit existing templates by selecting them and clicking Edit.
  For more information, see Creating and editing widget templates.
• If you want to display buttons for social sharing, select Enable social share buttons.
  This enables your users to share the items, for example, on Facebook.
  To configure which buttons to display, see Social sharing.

Filtering and sorting the events

You can filter and sort the events, which the widget displays, using both the default and the custom fields of the events.

1. To filter or sort the events, click Advanced button in the lower-right corner of the window.
   The advanced editing mode opens.
2. Click ControlDefinition » Views » EventsFrontendList buttons.
   • To filter the events, in FilterExpression input field, enter the desired filtering expression.
     You can use both default and custom fields. The field supports AND and OR Boolean operators.
     For example, enter Visible = true AND Status = Live
   • To sort the events, in SortExpression input field, enter the desired sorting expression.
     You can use both default and custom fields. The field supports operators ASC for ascending and DESC for descending.
     For example, enter PublicationDate DESC

NOTE: To see all custom and default fields, perform procedure Creating a new custom field » Step 1 and Step 2.

For more information about advanced configuration options, see Advanced configuration of widgets.

When you are finished with all the settings, click Save.
The Events window closes and the Events widget is configured to display the event you have selected.