Introduction #

This user guide discusses the main Events page and the individual event pages, and how they are edited, indexed and displayed. It is assumed that the u3a’s Administrator or Editor(s) have entered all the required information including venues, contacts and group categories, as discussed in the Entering u3a Specific Information user guide.

Events can be displayed on any page using the u3a events list widget or a configurable Shortcode. All events will be listed unless the event is explicitly linked to a specific group during its creation, and the correct selection is made in the Event Settings as discussed here.

Main Event Page #

Event information is normally accessed from Event from the main Navigation Menu. This page is provided within the Starter Site distribution, and on a migrated site. To edit this page, select Pages ⇒ All Pages ⇒ Events from the Dashboard. Depending on the individual u3a preferences, the page can be renamed, e.g. Whats On.

A typical top-level event page during editing is shown below, note the inclusion of the u3a events list block (note the background colour of the Widget may change as various options are selected) :

This will give the following to a visitor to the page. The event listing is configured as a grid with a white background.

The text that the visitor sees in the list is sourced from either the main text added when the event was created or a specific excerpt as discussed here. The site visitor can select the blue link to view more information about the event.

Displaying a List of Events #

u3a Widget #

In the example discussed above, the list of events is provided by the u3a event Widget, where the future events will remain listed until the end date has passed, if no length is set, the end date is considered to be equal to the start date, if the duration is set, the end date is the start date plus the event length. To enhance the Website the u3a events list is configurable, under three options: Sort and Filter, Limits, and Layout Choices. To access the option, select the Widget, and the option will be visible in the righthand toolbar.

The opinions available are as follows:

• SORT AND FILTER
  • When: Previous and Future events can be listed.
  • Order: In Ascending or Descending date order.
  • Categories: Events relating to All categories or just one can be listed.
• LIMIT
  • Show group events: If the Widget is used on a specific group page, only events relating to that group can be displayed.
  • Limit Number of Entries: limits the length of the list of events – the number entered must be positive and greater than one.
  • Limit Number of Days: Only displays events that are a specified number of days in the past or future. The maximum selectable value is 90. This feature overrides the limit on the number of entries.
• LAYOUT
  • The events can be presented as a simple list. 0r a Grid with the featured image. If the grid option is selected the following additional options are available:
    • The image can be cropped to make the grid symmetrical.
    • The Background colour can be selected. It should be noted that the Widget background colour, will be changed to the grid background colour.

Using the Shortcode #

The widget is the most convenient approach to providing a list of all future events as it can be inserted as a block. However, it is currently not possible to customise the displayed list, using a configurable shortcode can overcome this. This has the general form of [u3aeventlist option], where option is the parameter that provides the customisation, and is in the form Command Word = “Parameter”. The available options are given below:

For events, the following options can be set:

Function	Command Word	Parameter
Listing future or previous events	when†	past, future
Determines the number of events to be listed	order	asc, desc
Lists events in a specific category	cat	all, selected event category
Listing events attached to a group	groups	y, n
Lists a specific number of events	limitnum	An integer greater than zero
Lists events within a specific number of days from the current date	limitdays	An integer greater than zero

^† The list of events will be headed with Forthcoming Events or Previous Events, depending on the parameter associated with when.

If no configuration options are set, the information added when the event was created is displayed. The shortcode option can contain one or more command words with their parameters to modify the display. For example, the following two-column layout is created using two shortcodes:

The following is displayed, the left-hand column shows the default event listing, while the right-hand column displays only two events (limitnum = “2”) in descending order (order = “desc”).

Adding a Specific Event #

Event Details #

Select u3a Events ⇒ Add New Events from the Dashboard, which gives the following:

The screen is divided into two areas:

In the area labelled A, enter the Name of the event (if not included an error will appear), then use the block editor to add any additional information in the normal fashion.

In the area labelled B:

• Enter the Event Date and Event Category for the event, these fields are mandatory. The event category can be selected from the pull-down menu.
• In addition, the following optional information can be provided:
  • Start time of the meeting and its duration (in days). If no duration is added, the event is removed from the list following the day of the event, or if the duration is added the event is removed from the list following the completion of the event.
  • Group, if the event is a general meeting leave it blank.
  • Venue and Contact from the associated populated lists.
  • A flag can be set, to indicate if prior booking to attend an event is required.

Optional Text #

Depending on your requirements, the text visible to the site visitor can either be an extract from the main text entered in A above or a specific piece of information. Enter any optional text in the WRITE AN EXCERPT (OPTIONAL) box, this will overwrite the except from the main text.

Publication #

On completion, select Publish.

An event of three days duration, linked to a specific group will appear as:

Selecting the links will provide visitors with more information regarding the group, the meeting venue, and the ability to send a message to the event organiser.

Reviewing and Sorting Events. #

From the Dashboard select u3a Events ⇒ All Events, all events are now shown:

Summary information regarding events is contained in A. The number of events created by the current user is shown after Mine (in this case three). On opening the page, the default sorting is alphabetic over the title. It is possible to sort and filter events by:

• To filter events by Categories or Groups, use the filter terms, B. Once the required criteria are set, select Filter. If an event belongs to a Group that is currently in Draft, it is shown in the list, but cannot be used as a filter term.
• Next to the Event date, small arrowheads, C, allow sorting either in ascending or descending date order. Similar arrowheads are provided next to the Title heading.

Editing Contacts from the Event page #