URL parameters for setting paging and grouping
Paging and grouping settings for your published Trumba® calendar are available with templates that display events in list format, such as the Classic Table, List, 3 Columns, or Compact List templates, whether you assign the template in the Web Publishing Wizard or in the published calendar's URL with the template= parameter. If a template does not support paging and grouping, the paging and grouping parameters are ignored.
Where do I find out more about how the paging and grouping settings work?
Note The URL parameters for changing a calendar view are considered by Trumba development to be undocumented and subject to change. Please use the parameters described in this topic with the understanding that if they change, a calendar that is using the older parameters will display in the default, no-parameter view.
Parameter
paging=
Values
- smart
Tries to display as close to the number of events set as possible, while avoiding events that occur within the same group from breaking across two pages.
- exact
Always displays exactly the number of events set in
events=or the publishing wizard.
Parameter
events=
Specifies the number of events per page.
Values
Any whole number 1–1000.
Parameter
groupby=
Values
Groups are organized by time ranges. Valid values are:
|
|
Example
http://www.trumba.com/calendars/calendarname?paging=smart&events=10&groupby=month
Displays 10 or so events on a page, depending on how many events occur in one month. If 12 events occur in a month, and the first event of the month starts a new page, most likely all 12 events will appear on the same page.
The number of events displayed is approximate, because Trumba Connect tries to avoid breaking events that occur within the time period set for groupby across two pages.
Parameter
subgroupby=
Specifies how events are arranged within groups.
Values
Allows the values that are valid for the groupby= parameter, as well as the following:
|
|
Parameter
groupspan=
Specifies whether multi-day events are shown in a group if they start on an earlier date but are still occurring during that group's dates.
Values
- yes
Displays the multi-day event in all of the groups that include the dates during which the event occurs.
- no
Displays the multi-day event on only the first day it occurs.
Backward compatibility
Previously the pageby= parameter was used to specify the behavior that is now set in the groupby= parameter. The pageby= parameter is no longer supported.
For backward compatibility, in a URL that includes the pageby= parameter, Trumba Connect will transfer the value into the groupby= parameter, and if a groupby= parameter exists, it will transfer its value into a subgroupby= parameter. For example:
http://www.trumba.com/calendars/?calendarname&pageby=month&groupby=location
becomes
http://www.trumba.com/calendars/?calenarname&groupby=month&subgroupby=location