Events widget

Use this widget to display already created events.

PREREQUISITES: You have created at least one event. For more information, see Events.

After you have dragged the Events widget on your page you must configure it to display events and calendars. 

1. To do this, click Edit button in the upper-right corner of the widget.
   The Events window appears.
2. Under What events functionality to use? you must choose how your events will function.
   

   NOTE: If you are using multiple site management, regardless of what functionality you choose, under Settings, you must first choose the source from which you want to display events.
   For more information, see Multisite: Manage multiple sites.

3. Choose how to display events by selecting one of the following:
   

   List + single item	The system displays a list of events, when you click an event, you can see its details. Under Settings, perform the following: In Display… radio button select one of the following: All upcoming, current, and past events Upcoming events only Current events only Past events only Upcoming and current events Current and past events Under Narrow the selection you can further specify which events to display by choosing one of the following: By calendar Click the Select button to select the calendars from which you want to display events and click Done. All published events This is selected by default and displays all events selected in the previous step. 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 Authors… Click the Select button to select the authors of events from which you want to display events 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. 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. Click Select Page. From the treeview, select the page where you want to display the event. Click Done selecting. Under Paging, limit and sorting, perform the following: 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. Under Templates, perform the following: 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. 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 Create and edit widget templates.
   Single item only	The system displays only one event in detail. Under Settings, perform the following: Select the event to be displayed by choosing one of the following: Current opened event item Selected particular event item... Select the event and click Done selecting. Under Templates, perform the following: 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. 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 Create and edit widget templates. If you want users to be able to add the event to their Outlook, Google Calendar, and iCal, select Allow users to add events to their calendar checkbox.
   Calendar	The system displays all events in a calendar view and events from different calendars are color coded. Under Settings, perform the following: In Display… radio button select one of the following: All upcoming, current, and past events Upcoming events only Current events only Past events only Upcoming and current events Current and past events Under Narrow the selection you can further specify which events to display by choosing one of the following: By calendar Click the Select button to select the calendars from which you want to display events and click Done. All published events This is selected by default and displays all events selected in the previous step. 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 Authors… Click the Select button to select the authors of events from which you want to display events 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. Under Page for Single item, select the page where the event will open when clicked by choosing Select button, selecting the page and clicking Done selecting. Under Calendar appearance, perform the following: In Default view dropdown, select whether you want the calendar to display a Month, a Week, or a Day. Choose if you want the users to be able to change the view by selecting Allow users to change view mode checkbox. You can allow users to create events or calendars, by selecting Allow users to create events and Allow users to create calendars checkboxes, respectively. Under Templates, perform the following: In Calendar template, select the template which is used to display the events on the calendar view. You can create a custom template by clicking Create new template. You can edit existing templates by selecting them and clicking Edit. In Quick create template and Full create template select the templates which are used when a user creates and event or calendar. 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 Create and edit widget templates. If you want users to be able to add the event to their Outlook, Google Calendar, and iCal, select Allow users to add events to their calendar checkbox.

You can filter and sort the events, which the widget displays, using both the default and the Overview: 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
     For more information, see Filter expressions for content items.
   • 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 Create custom fields » 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. 

NOTE: If your site is multilingual and the page you are editing is synchronized with another translation, when you edit the widget, the Save to all translations button appears. If you click it, the current widget configuration will be saved to all translations, else, if you click Save, the widget configuration is saves only to the current translation, but the pages are still synchronized. If your pages are synchronized, you can have different widget configurations, but you cannot have different widgets.