Calendar Widget Arguments & Examples

Note: the below arguments apply only to calendar widgets. See here for all other widget arguments.

Basic

Argument Description Examples
group show items from group(s) <arg id="group">me</arg>
<arg id="group">biology</arg>

or using the CORS widget:
group: ["Alumni","Academics"]
exclude_group don’t show items from group(s) <arg id="exclude_group">biology</arg>
default_view which view (day, week, month) should load first <arg id="default_view">week</arg>
exclude_view don’t include this view in the menu <arg id="default_view">month</arg>
month_view_only only show the month view <arg id="month_view_only">true</arg>
show_public show events from the Public group (default: false) <arg id="show_public">true</arg>

Categories

Argument Description Examples
category show items in selected category <arg id="category">lectures</arg>
exclude_category do not show items in selected category <arg id="exclude_category">Deadlines</arg>
category_mode require that items match any or all categories <arg id="category_mode">any</arg>
use_category_classes apply categories as css classes <arg id="use_category_classes">true</arg>
exclusive_categories only allow one category to be selected at a time (automatically pre-pends an “All” link) <arg id="exclusive_categories">true</arg>

Tags

Argument Description Examples
tag show items that are tagged with specific tag(s) <arg id="tag">apples</arg>
exclude_tag show items that are not tagged with specific tag(s) <arg id="exclude_tag">oranges</arg>
tag_mode require that items match any/all the specified tags <arg id="tag_mode">any
use_tag_classes apply tags as css classes <arg id="use_tag_classes">true</arg>

Filtering and Sorting

Argument Description Examples
only_starred show only starred items <arg id="only_starred">true</arg>
hide_repeats Only show next instance of a repeating/multi-day event <arg id="hide_repeats">true</arg>
filter_mode require items match any/all filters below <arg id="filter_mode">any</arg>
filter select one of the options below with an action and a value to filter based on your criteria <arg id="filter" name="title" action="contains">Apples</arg>
search_all_events_only any search will go to the “All” view (default: true) <arg id="search_all_events_only">true</arg>
display_all_day_events_last show all day events at the end of the list rather than first (default: false) <arg id="display_all_day_events_last">true</arg>
show_archived show archived events (default: false)
Note: use both to show both archived and non-archived events in your calendar. Using true will show only archived events.
<arg id="show_archived">true</arg>
<arg id="show_archived">false</arg>
<arg id="show_archived">both</arg>

Format

Argument Description Examples
location_char_limit truncates the event location (default is 50 characters) <arg id="location_char_limit">60</arg>
thumb_width format thumb image width <arg id="thumb_width">100</arg>
thumb_height format thumb image height <arg id="thumb_height">100</arg>
image_width format event details image width <arg id="image_width">600</arg>
image_height format event details image height <arg id="image_height">400</arg>
image_crop crop event details image (defaults to true if you set image_width and image_height, otherwise defaults to false) <arg id="image_crop">false</arg>
ampm_with_dots use “a.m./p.m.” instead of “am/pm” in time formats <arg id="ampm_with_dots">true</arg>
month_view_day_limit number of events shown in month view before “show X more…” link (default: 4) <arg id="month_view_day_limit">4</arg>
hide_local_timezone hides local times when user is outside the calendar’s timezone (default: false) <arg id="hide_local_timezone">true</arg>
disable_timezone removes timezone abbreviations from all times (default: false) <arg id="disable_timezone">true</arg>

Using the CORS widget

When using a LiveWhale Calendar remote (CORS) calendar widget, you’ll reconfigure the above arguments into JavaScript. Make sure to put quotes around strings:

1
2
3
4
5
6
7
8
9
10
11
12
<script>
lwCalendar({
host: '//calendar-hostname',
theme: 'global',
widget_args: {
hide_repeats: true,
category: "Performances",
thumb_width: 200,
thumb_height: 200
}
});
</script>