Stacks has 2 pre-built pages that will display your events. The /events page will display your events in a list view that is filterable by Category, Topic, and Type. The /calendar page will display your events in a calendar view, which is also filterable by the same options.
How your users/patrons are able to access these pages is up to you, options include adding links in:
- Your main navigation menu
- Other Stacks features (like callouts or sliders)
- Or by adding a content block on your homepage or another landing page
Configuring the Event List and Detail Views
When users/patrons access the /events page, you can configure the settings that control how this list is initially displayed. The steps below describe the options available for configuring both the initial list view and the detail view, which is seen when a user/patron clicks on any one event from the list.
- From the Dashboard, click the Events Management tile
- Click the Events tile, then click Settings tab near the top of the screen,
- Click the Listing View sub-tab to configure the view when a user/patron accesses the /events page
-
Enable Listing View, check this box to enable access to the listing view for the content type
- Note: if disabled, when a user attempts to load the events page they will be redirected back to the homepage
- Title, edit the title for the page if desired, the default value is Events
- Description, enter a description for the page if desired, this will be visible to users/patrons
-
Display section
- Expand First Group by Default, check this box to expand the items, when they are grouped
- Display search form, check this box to display a search bar for news articles
- Display A-Z Link Index, check this box to display a link on the list view when "Group by None" is selected
- Enable Add to saved list button, check this box to enable a save to list button
-
Defaults section
- Default Page Limit, select the number of events to be displayed before pagination is enforced
-
Default Grouping, select the default value events should be grouped by
- Note: users/patrons can change this when viewing the list of events
- Default Sort Field, select the default value events should be sorted by
-
Default Sort Order, select the default order in which events should be sorted
- Note: users/patrons can change this when viewing the list of events
-
Field Visibility section
- Check the box beside each field that should be made visible to users/patrons when viewing the list of events
- Click Save configuration when finished
-
Enable Listing View, check this box to enable access to the listing view for the content type
- Click the Details View sub-tab to configure the view when a user/patron clicks on any one event
-
Field Visibility section
- Check the box beside each field that should be made visible to users/patrons when viewing the list of events
- Enable Add to saved list button, check this box to enable a save to list button
- Click Save configuration when finished
-
Field Visibility section
Additional Settings
On the Event Settings tile of the Events Management area of the Dashboard, administrators can access a few other settings, including the ability to enable an RSS feed for your events, and setting the day of the week the calendar should start on.
- From the Dashboard, click the Events Management tile
- Click the Event Settings tile
-
Default Display
-
Calendar
- It is recommended to leave this box unchecked, use the /calendar to direct your users/patrons to the calendar view
-
List
- It is recommended to leave this box unchecked, use the /events path to direct your users/patrons to the event list view
-
Calendar
-
RSS feeds for Events, check this box to enable a RSS feed users/patrons can subscribe to which contains a list of upcoming events
- An RSS icon will appear on the /events page, but only when viewing events as a list, click the icon to access the feed via a RSS capable reader or use with third party tools compatible with displaying RSS information to see the list
- Starts week on, select the day of the week the calendar should start on
- Click Save Configuration
Navigating to the Events and Calendar Pages
As mentioned earlier, you can direct your users/patrons to your event pages in a few different ways, the steps below describe the various methods that can be used.
Menu Links
Add a link in your Stacks main menu and/or top menu that directs users/patrons to your Events Listing page.
- From the Dashboard, click the Menus tile
- Click the List Links button to the right of Main Menu or Top Menu, depending on where you wish to place the link
- Click the +Add link button
- Menu link title, enter a title for the menu link, this is the value users/patrons will see in the menu
-
Link, enter the link or path to the desired events page
- Use /events, to direct to a list view of events
- Use /calendar, to direct to a calendar view of events
- Note: for internal Stacks pages, the full URL is not required in the link field, just the path mentioned above
- Enabled, ensure this box is checked to enable the link to appear in the menu
- Description, if required, enter a description for the menu link
- Show as expanded, when checked, this will expand the menu link if there are child links added under the main link
- Language, select the appropriate language, if applicable
-
Parent Link, select the appropriate option
-
<Main menu>, select this option to display the link in the main menu
- Please note, if adding to the Top Menu, you will initially see <Top Menu> here
- <--link name>, select from other menu links listed to embed this link as a child link under the selected option
-
<Main menu>, select this option to display the link in the main menu
-
Weight, enter a numerical value to determine the order of appearance
- Alternatively, after saving, click and drag the 4-way arrow in the list link page to change the order of appearance
- Click Save to complete the creation of the menu link
Other Stacks Features
To direct users/patrons to your Events page through another Stacks feature, such as a Callout or Slider as example, navigate to that feature in the Dashboard. Whether creating new content or editing the information on existing content, ensure the desired event path (/events or /calendar) is added to the appropriate Link or URL field.
When viewing events from the /calendar view, patrons will be able to see past events. When viewing past events, an indicator will appear to inform the viewer the event has already occurred; also, if a past event had registration enabled, this will be disabled once the event has occurred.
For more information on creating or editing content such as Callouts or Sliders, please see the associated Hub article(s) for the desired feature type.
Homepage (or other Landing Pages)
Another option allows for a list of your upcoming events to be added to your homepage or another landing page. This lets users/patrons to quickly see a list of upcoming events; from here they can view the event name, as well as the date and time of the event, clicking on the event will direct the user to the detail view for that event.
- Ensure you are logged into your site as an Administrator or Moderator
- From your homepage, or the landing page you wish to add the content block to, click the Layout tab (just below your header)
- Content can be added to a new or existing section on the page, for more information on adding new sections, please see the article Adding and Editing Content on Landing Pages
- To add the content block
- Click +Add block, in the desired section
- In the window that opens on the right, scroll to the Stacks Events section and click Upcoming Events
- Helper Text, optional - if required, enter helper text that can direct users/patrons on how to use or interact with this feature
- Subheading, optional - if required, enter a subheading to appear under the heading
- Items per block, select a numerical value, this will be the number of upcoming events that will be displayed in the content block
-
Overide title, optional - if required, check this box to display the heading field, then enter a new value for the heading
- The default heading that will be displayed is Upcoming Events
- Click the black eyeball icon to the right of the helper text field name to hide the Heading
- Please note: hiding the heading will also hide the helper text
- Click Add block, to add the block to the page
- Scroll to the top of the page, then click Save Layout to save the changes to your page