WiscWeb - Using the UW Events plugin

The UW Events plugin is a custom plugin for building and maintaining events in your WiscWeb site.

In this document:

Purpose

The UW Events plugin will allow users of WiscWeb sites to easily create and display events within their site in a list format, using posts to deliver content such as date and location, URLs, images, and general information.

Activation

This plugin is not activated in WiscWeb projects by default. However, site administrators can activate it in the project by following the instructions in WiscWeb - Self service plugin activation / deactivation

Usage

The UW Events plugin is a useful tool to use to schedule and display events on your site and have them look integrated with the UW Theme.

Features

  • Date/time
  • All day events
  • Multi-day events
  • Short or long description
  • Hyperlinks and buttons
  • Event URL link
  • Featured image
  • Images within text
  • Custom categories
  • Page element (list display only)
  • Embed content (e.g., a Google Map)
  • Include social icons

Not accommodated

  • Monthly calendar view
  • Sharing events between sites
  • Registration/payment processing
  • Display related events
  • ‘Add to personal calendar’ options
  • Recurring events

Creating an event

  1. After activating the plugin, click UW Events on the left menu (specifically, the one that shows the calendar icon):

    Menu value for UW Events plugin
    • Your full list of events will appear here.

  2. Select the Add New button at the top of the screen

  3. Add a Title for this event

  4. In the text field, add the event description including relevant information, images, contact information, and other details you would like to share.

  5. For the event to be valid, you must set:
    • Event Start Date
    • Start Time (if it is an all day event, toggle that option and then start time is not required)

  6. Optionally add:
    • End Time
    • All day event designation
    • Multi-day event designation
    • Location
    • URL/URL text
    • Featured image
    • Excerpt
    • Event Categories

  7. When finished, click Publish (if this is a new event) or Update (if this is an edit to an existing event)

Edit screen for an event created within the UW Events Plugin

Displaying your events on a page

To display your events on a page, follow these steps:

  1. Click the Add Page Element button

  2. Select the Events List option from the popup list

    Events List page element selection

  3. The events list defaults to the title Events, and can be updated as you see fit

  4. Choose the number of events to display in the list (defaults to 5)

  5. Other options include:
    • Specifying an event category or multiple categories to display
    • Choose to show the event excerpt
    • Choose the option to add a "More Events" link to the bottom of the list
  6. Be sure to Publish or Update your page once you've made the change.

Featured Image display

Users can opt to display a featured image for their event. There are three different options for display:

  • To the right of event text
  • Above event text
  • Do not display (this will show the image in the archive view of events but it will not appear on the actual event page)

Featured image display options shown with radio buttons next to each one

Note: The featured image defaults to a 3x2 aspect ratio unless the photo has a width less than 800px. If less than 800px wide, the image will appear as its original size/dimensions. This may result in inconsistent display of images. Therefore, we recommend uploading images that are 900x600 or resizing your images (before uploading) to be a consistent size.

Featured content block display

Users have the option to display their events list as a set of cards, similar to what is shown for featured content blocks. They can also optionally set drop shadow and card style.

To utilize these options, the settings must be enabled within the UW Events Listing page element: 

  1. Navigate to the page that is utilizing your UW Events Listing page element

  2. Under the title, you should see a section called Style as featured content blocks

  3. Select Check this box to style each event like a featured content block

    New featured content block style settings within the UW Events Listing page element.
     
    1. Optionally select:
      1. Apply drop shadow
      2. Apply UW Card Style

Display options

Featured content block display:

Three blocks of event content shown in a featured content block style

Featured content block with drop shadow display: 

Three blocks of event content shown in a featured content block style with a drop shadow.

Featured content block with UW Card style display: 

Three blocks of event content shown in a featured content block style and UW Card Style display

Featured content block with both drop shadow and UW Card Style display: 

Three blocks of event content shown in a featured content block style with drop shadow and UW Card Style display

Options for recurring events

As of now, the UW Events plugin does not have the ability to create recurring events when you are creating your event. However, you can try one of the following options:

  • Use the Yoast Duplicate Post plugin to create a single event, Clone it, and then update it to the new date and/or time.
  • Create it as a page on the site where you advertise the regularly scheduled event.

See Also:




Keywords:event, event management, date, time, calendar, display, schedule, list, month, day   Doc ID:127256
Owner:Matt G.Group:WiscWeb CMS
Created:2023-04-12 15:51 CDTUpdated:2023-07-20 15:20 CDT
Sites:DoIT Help Desk, WiscWeb CMS
Feedback:  1   2