Access Keys:
Skip to content (Access Key - 0)

Using advanced parameters in events calendar widgets for more control

Localist's widgets support additional capabilities and parameters than are available from their widget builder form. For example, you can create widgets that show events spanning several groups or departments, and how recurring events are handled. For the full list of available parameters, see:

To help you get started with a common use case here on campus, we include the below example.

Example: Create a widget to include events from two different departments

First, use the widget builder to generate your widget to your liking, selecting a single department in the widget builder.

Second, click the Generate Embed Code button at the bottom of the widget builder. Copy the embed code from the web page into the text editor of your choice. In our example, we have selected MIT Music and Theater Arts as the department, and our embed code looks like this:

<script type="text/javascript"
    src="http://calendar.mit.edu/widget/view?schools=mit&days=31&num=50&departments=mit_music_and_theater_arts&template=modern">
</script>
<div id="lclst_widget_footer">
    <a rel="nofollow" style="margin-left:auto;margin-right:auto;display:block;width:81px;margin-top:10px;" 
        title="Widget powered by Localist Online Calendar Software"
        href="http://www.localist.com?utm_source=widget&utm_campaign=widget_footer&utm_medium=branded%20link">
        <img src="//d3e1o4bcbhmj8g.cloudfront.net/assets/platforms/default/about/widget_footer.png"
            alt="Localist Online Calendar Software" style="vertical-align: middle;" width="81" height="23">
    </a>
</div>

We are going to remove the Localist branding that is included by the widget builder to leave us with:

<script type="text/javascript"
    src="http://calendar.mit.edu/widget/view?schools=mit&days=31&num=50&departments=mit_music_and_theater_arts&template=modern">
</script>

The src link sent to the MIT events calendar includes several parameters. We are going to modify the department parameter to include both mit_music_and_theater_arts and a second department, museum, which is the short code for the MIT Museum.

There are several ways you can find out the short code for a department. Selecting it in the widget builder and looking at the generated embed code is one way. You can also go to the department's landing page in the events calendar, and the short code will be the part after the .../department/ part of the URL. The landing page of the MIT Museum is http://calendar.mit.edu/department/museum.

Several of the widget builder parameters can take a list rather than just a single value. For a full description of which parameters can handle lists, see Widget Parameters (Localist's Knowledge Base). For our example, the embed code changes to:

<script type="text/javascript"
    src="http://calendar.mit.edu/widget/view?schools=mit&days=31&num=50&departments=mit_music_and_theater_arts,museum&template=modern">
</script>

We can now include this widget in our web page to see future events from both MIT Music and Theater Arts, and from MIT Museum.

See also

IS&T Contributions

Documentation and information provided by IS&T staff members


Last Modified:

July 25, 2017

Get Help

Request help
from the Help Desk
Report a security incident
to the Security Team
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
Feedback
This product/service is:
Easy to use
Average
Difficult to use

This article is:
Helpful
Inaccurate
Obsolete
Adaptavist Theme Builder (4.2.3) Powered by Atlassian Confluence 3.5.13, the Enterprise Wiki