Upcoming Events

### Description

This widget pulls from qualified Content Publishing events to display an eye-catching date badge as well as high-level event information at a glance. It also expands to show more detailed event information, including an optional image. This widget makes use of the RocketFuel Date Badge widget.

### Instance Options
|  Option       | Property | Comments | Default Value | Source |
| ----- |:-----:| ---- | ---- | ---- |
| Display Heading Text | `displayHeadingText` |Designate heading text. | `true` | Instance |
| Display Bounding Box | `displayBoundingBox` | Option to display a bounding box around each listed event. | `true` | Instance |
| Display Widget Background Color | `showBackground` | Option to display a background color behind each listed event. | `true` | Instance |
| Show Empty State| `show_empty_state` | Shows empty state if the widget content is empty. | `false` | Instance |
### Templates
| Name | Comments |
| -------- |:---|
| `rf-upcoming-events-default.html` | Sets the standard default template. |

Implementation Tips

Associate Widget to the Event Content Type

Before content can be targeted to this widget, the widget must be associated with the Event Content Type. In the Filter Navigator type “content publishing” to bring up the module. Click the Content Types item and select Event from the list. Add the RocketFuel Upcoming Events widget to the Associated widgets list and click Update.

Add Widget to the Page

After adding the RocketFuel Upcoming Events widget to your page you will want to follow a few tips to allow events to be displayed.

First, it can be helpful to name the instance of the widget. This allows for easy identification during configuration. Open the Page Editor for your page and ensure the proper instance is selected in the hierarchy tree. Give the instance a title, e.g., RF Upcoming Events instance.

Target the Widget with Content

In Content Publishing > Portal Content, create or edit an event. The dates must be in the future for the event to appear in the portal. From the Schedule Content related list click New to associate this event with the widget instance.

Find and select your page from the Page reference list, find and select the Widget instance (for example, “RF Upcoming Events instance” in previous section), and configure the Audience field.

Configure Cross-Scope Privilege

You will need to configure a Cross-scope privilege to allow the widget to read from the content publishing API. Load your event page to make the cross-scope request. Then go to Restricted Caller Access Privilege module in the platform. You should see a Source with the value “Widget: RocketFuel Upcoming Events” and Status field of “Requested”. Change the Status field to “Allowed” and click Update.

Revisit your page and confirm that it is working as expected.

‍