Skip to main content

Agenda

The Agenda is a calendar surface that lets a resource - or anyone with the URL - consult the planning of one or more resources without opening the full planning view. It runs at https://app.dimescheduler.com/agenda and supports four views (Day, Week, Month, List), a rich appointment details sheet, multi-resource filtering, kiosk/embed mode, and a set of keyboard shortcuts.

Agenda

Toolbarโ€‹

A single toolbar drives the entire agenda. Most controls are context-aware: irrelevant ones disable themselves rather than disappear, so the layout stays stable when switching views.

Date navigationโ€‹

  • < / > shifts the visible range by one period (one day, one week, or one month, depending on the active view).
  • Today jumps back to today.
  • The date picker lets you jump to an arbitrary date.

Resource filterโ€‹

The resource tag input at the centre of the toolbar accepts one or more resources. Adding tags narrows the agenda to those resources; an empty input means "all resources". The choice is reflected in the URL via ?resources=A,B,C so the filtered view can be bookmarked or shared.

Group by resourceโ€‹

Day view only. When two or more resources are visible, the Group by resource toggle (columns icon) splits the day into one column per resource. Outside day view (or when fewer than two resources are present) the toggle is disabled.

Zoomโ€‹

Day and week views only. The two zoom buttons step through four density levels that pair grid height with snap interval:

LevelSlot duration
11 hour
230 minutes
315 minutes
45 minutes

Zooming in increases the row height and decreases the slot duration in lock-step.

Time rangeโ€‹

Day and week views only. The time range input bounds the visible hours of the day (e.g. 07:00 - 19:00). Outside those hours the grid is hidden.

Pin to nowโ€‹

Day and week views only. When enabled, the agenda auto-scrolls to the current time on load and again every minute. Useful for monitors that sit on a wall and need to follow "now" without user input.

Weekendsโ€‹

Week, month, and list views only. Toggles whether Saturday and Sunday are rendered.

View switcherโ€‹

The view switcher on the right swaps between Day, Week, Month, and List. The selected view is reflected in the URL via ?view=<name> so links survive a refresh.

Refresh and collapseโ€‹

  • Refresh (circular arrow) re-fetches appointments. Also bound to R.
  • The chevron at the right end of the toolbar collapses the toolbar to a thin strip; click the chevron in the strip to bring it back.

Keyboard shortcutsโ€‹

Shortcuts work whenever focus is not inside an input or the appointment details sheet:

KeyAction
โ†Previous period
โ†’Next period
TToday
DDay view
WWeek view
MMonth view
LList view
RRefresh

Modifier-key combinations (Ctrl/Cmd/Alt) are ignored so they don't collide with browser shortcuts.

Appointment details sheetโ€‹

Clicking an appointment opens a side sheet with the full record:

  • Subject, body and category accent.
  • Start and end (formatted in the user's locale).
  • Assigned resources. Each resource name is clickable - clicking adds or removes that resource from the agenda's filter, so you can quickly pivot the agenda onto the resources of the appointment you're inspecting.
  • Linked task and job numbers.
  • Category and time marker, with their colour swatches.
  • Site address (when the linked job has one).
  • Planning quantity and priority/importance.
  • Created/last-modified metadata, with the user who made the change.

Multiple resourcesโ€‹

Resources can be supplied through several mechanisms (in priority order):

  1. ?resources=A,B,C query string - the canonical form.
  2. Legacy ?resource=A query string - still honoured, mapped to the new resources list.
  3. The URL path /agenda/<resourceNo> - the original form, still works.
  4. The data-resourceno attribute on the host element - used when the agenda is embedded in another page.

The toolbar always emits the canonical ?resources=... form when the filter changes, so URLs converge after the first interaction.

Kiosk and embed modeโ€‹

For wallboards, embedded views inside back-office systems, or any case where the chrome should be hidden, append ?hideToolbar=true to the URL. The toolbar disappears entirely (no collapsed strip) and the calendar fills the viewport edge to edge.

Combine this with the canonical query string parameters to hard-code the desired view:

https://app.dimescheduler.com/agenda
?view=day
&resources=LINDA,JOHN
&minTime=07:00:00
&maxTime=19:00:00
&slotDuration=00:15:00
&pinToNow=true
&groupByResource=true
&hideToolbar=true

Configuration parametersโ€‹

All toolbar settings can be set up-front via the query string and are written back to the URL when the user changes them in the toolbar. The full list:

ParameterTypeNotes
viewstringday, week, month, list. Defaults to day.
datestringYYYY-MM-DD. Defaults to today.
minTimestringhh:mm:ss. Defaults to 00:00:00.
maxTimestringhh:mm:ss. Defaults to 24:00:00.
slotDurationstringhh:mm:ss. Defaults to 00:15:00.
slotHeightnumberPixels per hour. Driven by the zoom buttons; rarely set by hand.
showWeekendbooleanDefaults to true. Only meaningful in week, month, and list views.
pinToNowbooleanDefaults to false. Only effective in day and week views.
groupByResourcebooleanDefaults to false. Only effective in day view with two or more resources.
resourcesstringComma-separated resource numbers. The canonical multi-resource form.
resourcestringLegacy. Single resource number, mapped onto resources for backwards compatibility.
hideToolbarbooleanDefaults to false. When true, the toolbar is hidden entirely (kiosk mode).

Mobile users typically prefer the mobile app over the agenda for daily use - it's purpose-built for the on-the-go workflow.