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:
We are going to remove the Localist branding that is included by the widget builder to leave us with:
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:
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.