Day: October 18, 2016

Calendar Admins can use the Widget Builder to generate a URL to use in a CMS RSS Module or to generate embed code to put the widget on a website.

1. Go to https://events.mtu.edu.
2. Login to the calendar using the link in the header.
3. Once logged in, click the “Admin” shortcut in the header.
4. From the Localist Success Resources menu on the right choose Public Widget Builder.
   
5. Enter the Number of Results you want to display in the widget. If this is to be used in the CMS, you can leave it at the default.
6. Enter the number of Days Ahead that you want events to be displayed for. For use in the CMS, you will most likely set this to a large number, like 365.
7. If you are displaying events for a student organization, select the organization from the Groups dropdown.
8. To filter your widget to only specific keywords or tags that are on events, enter that word in the Keywords and Tags field. Separate multiple words with a comma.
9. If you only want to display featured events in your widget, check the Only Show Featured box.
10. Michigan Tech does not currently use Sponsored Events, so leave the Only Show Sponsored box blank.
11. Include All Matching Instances: Check this box if you want an single event with multiple dates in the calendar to show up separately in your widget. If you do not check this box a single event on the calendar with multiple dates will show up once in the widget with the next upcoming date and then change to the next date as the current date passes.
12. Select one or more items from the Places, Event Type, Audience, and/or Department dropdowns to filter your results as needed. Be sure you are not in the Excluded Content section!
    
13. Select your Match option from the dropdown.
    1. At least one place, group, keyword or tag, and one filter item will display any event that matches at least one of the dropdown filters and at least one place, group, keyword, or tag that you selected.
    2. Any place, group, keyword, tag, or filter item will display events that match any of the filters, places, groups, keywords, or tags that you selected.
    3. At least one place and group, and all keywords, tags, and filter items will only display events that match every filter, keyword, or tag and at least one place or group that you selected.
    4. Any place or group, and at least one keyword or tag, and one filter item will display events that match at least one keyword or tag and one of the dropdown filters that you selected.
14. In the Excluded Content section you can select criteria to exclude from your results. For example, you selected to display all events for your department, but you do not want Socials, you could exclude the Event Type of Social.
15. Display Options do not matter if you are using this in the CMS, but can be set if you are embedding the widget code directly onto a webpage.
    1. Widget Type gives you the option to only show the events or to also include a calendar that users can choose a date on.
    2. Style changes the formatting of the widget. Use the Preview Widget button to see the various styles available.
    3. There are several checkboxes that will also change the format of the widget.
16. Click the Preview Widget button to see what your widget will look like.
    1. For use in the RSS Module in the CMS, look at the resulting events, not the formatting. If these events are correct, remove the “&template=…” part at the end of the URL and change “&format=html” to “&format=rss” (without the quotation marks). Use this URL as the Feed URL.
17. If you are happy with the way the widget looks, go back to the previous tab where you made your selections and click the Generate Embed Code button. This will provide you with script code that can be used to embed the previewed widget into a website if you are not using the RSS Module in the CMS.