In this article you’ll find:
- The Widget Builder
- Custom Widget Templates
- Widget Parameters
- API vs. Widgets
- Widgets FAQ
The Widget Builder
To access the Widget builder from the Admin Dashboard:
1. Navigate to Content > Widgets
2. Select Public Widget Builder
To access the Widget builder from your public-facing platform:
– Note –
You must have the Share Events component added to your Homepage layout or a link to the Widget builder in order to access the Widget builder via your public-facing platform.
1. On your homepage, in the Share Events box, select the Build a Widget link.
Widget Builder Fields
- Template: Select the default template or one of your custom Widget templates
- Number of Results: You can enter any number up to 50.
- Days Ahead: You can enter any number up to 365.
- Groups/Departments: The builder allows you to select one group. If you’d like to pull multiple groups’ or departments’ events you can tack on more groups or departments to the URL (&groups=group_a&groups=group_b OR &departments=department_a&departments=department_b). It’s just not currently baked into the actual builder.
- Keywords and Tags: Enter all applicable words.
– Note –
Tags and Keywords are only available to Event Admins.
- Only Show Featured: When checked, only events flagged as a featured event will be included.
- Only Show Sponsored: When checked, only events flagged as a sponsored will be included.
- Include All Matching Instances: If checked, the Widget will display all recurring instances. If not checked, the Widget will only display the first instance in the recurring chain.
- Places: Select all that apply.
- Filters: Select all that apply.
- Content Must Match
- At least one Place, Group, Keyword or Tag, and one Filter item
- Any Place, Group, Keyword, Tag, or Filter item
- At least one Place and Group, and all Keywords, Tags, and Filter items
- Any place or Group, and at least one Keyword or Tag, and one Filter item
- Excluded Content: Any Filters specified in these drop downs will not be included in the Widget. This is helpful in an “all, but one” situation.
- Hide past events: Hide all events in the past