In Localist you can build and customize your own calendar widgets to embed them into your website or other digital spaces. It is recommended to use a Localist widget on your homepage or elsewhere on your site that is the most useful to your audiences then send them to your page in the events calendar itself instead of having a separate Events page on your website.

See Sample Styles for Embedding

Setting Up a New Calendar Widget

You can access the widget builder on the main calendar page at the bottom of the right column in the Share Events block.

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.
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

Display Options

Widget Type: You have the option of a List Widget or a Mini Cal + List Widget.
- The List + Mini Cal Widget provides a drop down of all available Event Type Filters to narrow down what events the list displays. The mini cal and “today’s events”/”this week’s events” will change the list results accordingly. The mini calendar extends 12 months.
Style: Localist provides three out-of-the-box styles to choose from:
- Modern - bigger pictures, less text
- Classic - smaller pictures, more text
- Mini Cal + List

Generating Your Widget

After you have made all necessary specifications, you will see two options to generate your Widget results.

Preview Widget: This will open your Widget results in another tab. On this page you can confirm that the correct events are showing and that the output options are working as expected.
Generate Embed Code: This will display the embed code for your Widget to be included on your website.

Click Copy Code.
Go the the page in cascade where you'd like to embed the feed.
Open the row and slot where you want the code to live. Review style examples.
In the WYSIWYG click the Source Code (< >) button.
Paste the code you just copied here.
Click Ok.

Do not paste your code into the WYSIWYG view. This will break the code.
Do not embed your calendar code into a Rich Text Widget, this is currently not working. Use a content slot or the main body of a page instead.

Finish Up | Submit and Publish

Click Submit to save your work.
Publish (or send the request to publish).

CSS Conflict with Twitter Embed Code

Note: If you also have your Twitter feed embedded on the same page, the CSS (styles) in either your calendar or Twitter may break. In order to prevent this, you must wrap the "protect" code around the Twitter code that you embed so that other CSS styles do not overwrite it.
EXAMPLE:


Review the page on embedding the Twitter code if you need more help.