CoolCMS API

SchedulePresenter extends BasePresenter

in package

• Application

Schedule calendar administration (`/admin/company/schedule`): year, month, week and day views over the availability of a company calendar.

Table of Contents

Constants

LOGIN_BACKLINK  : string = 'backlink'

Login page parameter with the key of the stored request to return to ({@see loginReturnArgs()}).

DEFAULT_ITEMS_PER_PAGE  : mixed = 20

Items per page of admin lists when the DB setting is missing.

FORM_BACK_SUBSECTION  : mixed = 'formBack'

Session subsection mapping a key to the previous page URL of edit forms.

SESSION_NAMESPACE  : mixed = 'admin'

BLOCKED_EXTENSIONS  : mixed = ['php', 'php3', 'php4', 'php5', 'php7', 'php8',...

Extensions that must not be uploaded into the web-served folder; otherwise an editor upload would mean running foreign code on the server. It is no content whitelist (the editor uploads what is needed), only a safeguard against executable files.

DAY_HOUR_HEIGHT_PX  : int = 72

Pixels per hour in the day timeline. IMPORTANT: must match `--cal-hour-height` (`abstracts/_vars.scss`); `day.latte` receives precomputed `axisHeightPx`/`topPx`/`heightPx`, so changing one side without the other misaligns the timeline.

EDITOR_PAGE_LIMIT  : mixed = 500

Listing cap; the dialog is a suggester, not a paged list.

EDITOR_PAGE_TARGETS  : mixed = ['front:system:page:show']

Routes the editor may link to: text pages only.

EDITOR_UPLOAD_FOLDER  : mixed = 'editorUploads'

Editor root (relative to the `uploads/` root). Changing it to `''` would open the whole `uploads/` tree to the manager; the editor user could then reach (and delete) files of other modules such as products and avatars.

IMAGE_EXTENSIONS  : mixed = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', '...

Extensions the file manager shows as a preview instead of a document icon.

LOCALE_MAP  : mixed = ['cs' => 'cs_CZ', 'en' => 'en_US', 'sk' => 'sk_...

Maps the short language code to the full locale of the registered NEON sources.

MINUTES_PER_DAY  : int = 1440

Minutes per day, used for the closed bookend bars ({@see makeBookendBlock()}).

MONTH_KEYS  : array<string|int, mixed> = ['01' => 'jan', '02' => 'feb', '03' => 'mar', '...

ISO month (`m`, `01`..`12`) to key `list.overview.months.*`, see {@see formatMonthLabel()}; same mapping as {@see \App\UI\Front\Company\Components\BookingCalendarComponent\Traits\InitTrait::MONTH_KEYS}.

WEEK_HOUR_WIDTH_PX  : int = 108

Pixels per hour in the week grid. IMPORTANT: must match `--cal-week-hour-width`.

WEEKDAY_KEYS  : array<string|int, mixed> = [1 => 'mon', 2 => 'tue', 3 => 'wed', 4 => 'thu'...

ISO weekday (`N`, 1..7) to key `list.overview.weekdays.*`, analog of {@see MONTH_KEYS} (the int-key trap does not apply, `N` has no leading zero).

Properties

$accessTokenValidator  : AccessTokenValidator

Signature and expiry alone are not enough: a revoked token (`jti` on the deny-list) that has not expired yet would keep the session logged in although the Api guard rejects the same token. Same contract as {@see \App\Core\Traits\Api\Presenters\JwtAuthTrait::checkJwtAuth()}, one implementation.

$adminPageManager  : AdminPageManager

$authManager  : AuthManager

$authStorageManager  : AuthStorageManager

$authUserManager  : UserManager

Admin `UserManager` for {@see UserManager::login()}. A module must not read through another module, so admin has its own `login()` that calls the same Api endpoint (`api/system/auth/login`).

$columnSchema  : ColumnSchema

Limits of the real database columns for {@see guardColumns()}.

$container  : Container

$deviceDetector  : DeviceDetector

$editorAutosaveScope  : EditorAutosaveScope

Scope of the editor autosave drafts, see {@see \App\Core\Security\EditorAutosaveScope}.

$editorLinkPageManager  : PageManager

NOTE: own property name. `$pageManager` already exists on presenters (`PagePickerTrait`), and two `#[Inject]` properties of the same name would collide in the trait composition.

$editorUploadManager  : FileSystemManager

NOTE: own property name, not `$fileSystemManager`.

$eventDispatcher  : EventDispatcher

$formSubmissionGuard  : FormSubmissionGuard

One-time submission tokens of "add" forms, see {@see guardFormSubmitOnce()}.

$jwtManager  : JwtManager

$languageContext  : LanguageContext

$languageManager  : LanguageManager

$localizationContext  : LocalizationContext

$localizationManager  : LocalizationManager

$loginDeviceCookie  : LoginDeviceCookie

Cookie of a known device for the password login throttle ({@see self::rememberLoginDevice()}).

$modalWindowFactory  : ModalWindowFactory

Injected through Nette presenter inject (after construction), not the constructor.

$picker  : string

Picker mode of a list; when not empty, the presenter renders its `show` grid as a selection modal (no add/edit/delete/checkboxes, each row has a select button) in the minimal `@picker.latte` layout.

$pickerExclude  : int

Id of the record that cannot be selected in picker mode (its select button is hidden).

$pickerExcludeSubtreeLft  : int

`lft`/`rgt` bounds of a whole subtree whose nodes cannot be selected in picker mode.

$pickerExcludeSubtreeRgt  : int

$presenterContext  : PresenterContext

$privilegeManager  : PrivilegeManager

$queryCacheContext  : QueryCacheContext

Query cache policy for the whole admin request; `startup()` disables it.

$routerDispatcher  : RouterDispatcher

$settingContext  : SettingContext

$settingManager  : SettingManager

$themeContext  : ThemeContext

$themeManager  : ThemeManager

$themeResolver  : DefaultThemeResolver

$translator  : ITranslator

$translatorSessionResolver  : Session

$userManager  : UserManager

$adminPageEntity  : AdminPage|null

$debugMode  : bool

$productionMode  : bool

$savedEntityId  : int|null

Id of the record just saved; set by the `$processData` callback in `createForm()` after a successful save.

$translatorDomain  : string

$calendarManager  : CalendarManager

$companyManager  : CompanyManager

$isLoggingIn  : bool

$occupiedSlotIds  : array<int, true>|null

Memoized set `timeSlotId => true` of slots with an active reservation (`pending`/`confirmed`), see {@see loadOccupiedSlotIds()}.

$reservationManager  : ReservationManager

$slotModalFactory  : SlotModalFactory

$theme  : Theme|null

$timeSlotManager  : TimeSlotManager

$userPrivileges  : array<int, string>

Methods

__construct()  : mixed

actionDay()  : void

actionWeek()  : void

actionYear()  : void

beforeRender()  : void

createComponent()  : IComponent|null

flashFormOwnErrors()  : void

Flashes form-level errors (`$form->getOwnErrors()`) as `danger` messages.

flashRejectedUploads()  : void

Flashes one `warning` listing the files the Api rejected (type, dimensions, unreadable) after a successful save of a form with a dropzone ({@see UploadRejection}).

formatLayoutTemplateFiles()  : array<string|int, mixed>

Admin version of {@see \App\Core\Traits\Front\Presenters\ThemeInitTrait::formatLayoutTemplateFiles()}.

getAdminPageEntity()  : AdminPage|null

getContainer()  : Container

getFormBackUrl()  : string

Returns the stored previous page URL for the key, used by the `cancel` link in the template.

getModalWindow()  : ModalWindow

getRouterDispatcher()  : RouterDispatcher

getTranslator()  : ITranslator

guardFormSubmitOnce()  : void

Protects a form against a double submit: one rendered form saves at most once.

handleChangeLocale()  : void

handleEditorCreateFolder()  : void

Creates a subfolder in `folder` (path relative to the editor root).

handleEditorDelete()  : void

Deletes a file or (recursively) a folder. An empty path would point to the editor root, which cannot be deleted.

handleEditorFiles()  : void

Sends the folder listing for the editor file manager. The `folder` parameter is a path relative to the editor root (empty means the root).

handleEditorPages()  : void

Sends the page list for the link dialog as JSON `{"pages": [{id, label, url}, ...]}` sorted by label.

handleEditorRename()  : void

Renames a file or folder (`path` relative to the editor root).

handleEditorUpload()  : void

Accepts a file from the editor (field `file`, multipart POST; optional `folder` = subfolder of the editor root) and sends JSON `{"location": "/www/uploads/editorUploads/..."}`, the format TinyMCE expects from `images_upload_handler`.

handleLogout()  : void

handleMergeSlots()  : void

Merges adjacent time slots (button "Merge" above the day timeline).

handleSignOut()  : void

hasServiceByType()  : bool

Returns whether the container has a service of the given type.

initializeTranslator()  : void

isAddAction()  : bool

Tells whether the current action creates a record: `add` and the `add<Something>` actions (`addMenu`, `addKey`). Derived from the server context only, like {@see formSubmitPrivilege()}.

isAllowed()  : bool

Returns whether the logged-in user has the given privilege.

isSubmitOnceForm()  : bool

Tells whether the form was protected by {@see guardFormSubmitOnce()}.

loginWithCredentials()  : void

Logs in with username and password; called only by the login form (after validation and CSRF).

publishFieldErrors()  : void

Publishes element errors of a failed submit to the client.

redirectToFormBack()  : void

Redirects to the stored previous page and discards the key.

renderDay()  : void

Renders the day timeline of one calendar. Consumes the admin-only Api {@see \App\UI\Api\Company\Models\Managers\TimeSlotManager::dayDetailForCalendar()} (bridge {@see TimeSlotManager::dayDetail()}); gap filling into free/closed between windows is done by {@see buildDayTimeline()}. Without a calendar (the company has no active one) `dayDetail` stays `null` and the template shows a message instead of an empty card.

renderShow()  : void

`show` is the default action of admin presenters (fallback route).

renderWeek()  : void

Renders the week grid in two modes: one calendar (default) or all calendars of the company merged (`calendarId=0` in the URL; the switcher inside `week.latte` is a `<select>` with an extra "all calendars" option).

renderYear()  : void

Year overview: previous/next year buttons, the year, and a table of months (January to December).

resolveFormBackKey()  : string

Returns the previous-page key: from the URL if present (survives the update redirect), otherwise on a plain GET render of the edit page stores `Referer` in the session under a new random key.

runSubmitOnce()  : bool|null

Runs a saving step of a form under its one-time token (a form without the token just runs it).

setConfigParameters()  : void

setTranslator()  : $this

startup()  : void

typedComponent()  : T

Returns a subcomponent with a verified type.

authorize()  : void

Authorization hook; by default requires the `:Admin` privilege.

authorizeFormSubmit()  : void

Gate for writing presenter forms built by `createForm()`.

authorizeListing()  : void

Gate for reading lists.

checkAdminAccess()  : void

Entry gate to the admin: a guest is sent to login; a logged-in user without `:Admin` is sent to login with an error.

checkAuthentication()  : void

checkCurrentPrivilege()  : void

Builds the key from the current request (`:Admin:<Module>:<Presenter>:<action>`) and checks it. `getName()` already contains the `Admin:...` prefix, so only one leading colon is added.

checkPrivilege()  : void

Checks a specific privilege; throws 403 when denied.

createComponentModalWindow()  : ModalWindow

createComponentSlotModal()  : SlotModal

Slot edit modal. Templates do not mount it via `{control slotModal}`, they only generate `{link slotModal:open…!}` links; the content renders into the shared {@see \App\UI\Admin\System\Components\ModalWindowComponent\ModalWindow}.

createForm()  : Form

Creates an edit form with the standard actions and a return to the previous page.

domainTranslator()  : PrefixedTranslator|null

Returns a translator prefixed with the presenter domain, or `null` (empty domain or a translator other than Contributte).

formSubmitPrivilege()  : string

Returns the privilege key required to save a form built by `createForm()`.

getAdminItemsPerPage()  : int

Returns the default items per page of admin lists from the DB setting `admin.itemsPerPage` (module System = 1), falling back to {@see DEFAULT_ITEMS_PER_PAGE}.

getAdminLayout()  : string

Returns the layout name; in picker mode ({@see $picker}) the `show` grid uses the minimal `@picker.latte` (no sidebar/header) so the opener fetch returns only the table.

getFormBackFallback()  : string

Returns the return URL when the previous page is unknown; override in a presenter without a `show` action.

getSessionKey()  : string

Returns a session key string, e.g. 'front.auth.step1'.

getSessionSection()  : SessionSection

Returns a Nette\SessionSection instance using a dynamically built session key.

guardColumns()  : void

Gates every text and number field of the form by the real column it writes to ({@see \App\Core\Forms\ColumnGate::guard()}): an oversized value is an error at the field, never a database error that closes the entity manager (admin walkthrough A1, A14).

initializePresenterContext()  : void

isSameSiteRequest()  : bool

Tells whether the request comes from the own site (Nette SameSite cookie); protects GET actions with a side effect.

loadUserPrivileges()  : void

Loads all privileges of the logged-in user with one database query. Call it right after `checkAdminAccess()` in `startup()` (the user is guaranteed to be logged in by then).

logout()  : void

setTranslatorDomain()  : void

setupTemplateTranslator()  : void

Sets a translator prefixed with the presenter domain into the template (as Front components do, see {@see \App\Core\Base\BaseComponent::setup()}).

buildDayTimeline()  : array{axisStartHour: int, axisEndHour: int, labelStartHour: int, labelEndHour: int, axisHeightPx: int, hourHeightPx: int, blocks: list>}

Builds the day timeline blocks from the Api payload (`windows` + `segments`, both HH:MM): generic interval arithmetic, not the day resolution logic (that stays in the Api `dayDetailForCalendar()`).

buildMetaLabel()  : string

Builds the metadata row of a day in the grid: "free · H:MM" (free), "occupied · H:MM" (partial/full, summed from the payload `busy` intervals, see {@see sumBusyMinutes()}) or an empty string (closed). Requires `freeMinutesLabel` already computed (see {@see decorateOverview()}).

buildWeekAllData()  : array{axisStartHour: int, axisEndHour: int, axisWidthPx: int, hourWidthPx: int, rows: list>}

Builds week data of all company calendars merged: `numCalendars × 7` bridge calls (small volumes, a company typically has a few calendars). A row per day holds `lanes`, one entry per calendar (`calendar` entity + its bubbles); the template builds nested `.cal-week__lane` rows.

buildWeekBubbles()  : array<int, array<string, mixed>>

Converts day segments into week grid bubbles (`leftPx`/`widthPx` on the common week axis, {@see WEEK_HOUR_WIDTH_PX} instead of {@see DAY_HOUR_HEIGHT_PX}, because the week is horizontal).

buildWeekDates()  : array<int, string>

Builds the 7 dates Monday to Sunday containing `$anyDateInWeek` (ISO `N` arithmetic, Monday = 1, same convention as {@see withPaddingDays()}). An invalid date falls back to today so the week is always built.

buildWeekSingleData()  : array{axisStartHour: int, axisEndHour: int, axisWidthPx: int, hourWidthPx: int, rows: list>}

Builds week data of one calendar: 7 bridge calls {@see TimeSlotManager::dayDetail()} (small volumes, same reasoning as {@see loadOccupiedSlotIds()}). Returns one row per day with bubbles on the common axis ({@see resolveWeekAxis()}).

buildYearMonths()  : array<int, array{month: string, label: string, isCurrent: bool, reservations: int, blocked: int, closedDays: int, hasAny: bool}>

Builds the twelve months of the year with a summary. Two queries over the whole year (calendar rows plus active reservations) and aggregation in PHP, with no Api call per month.

createIdentity()  : SimpleIdentity|null

createMultiplierComponent()  : Multiplier<string|int, IComponent>

Creates a multiplier for the component.

createNewComponentInstance()  : IComponent|null

Creates a new component instance without adding it to the presenter; used by the multiplier.

createStandardComponent()  : IComponent|null

Creates a standard component (not a multiplier).

daySegmentKey()  : string

decorateOverview()  : array<int|string, mixed>

Adds to every day of the Api payload {@see \App\UI\Api\Company\Models\Managers\TimeSlotManager::availabilityForCalendar()} a readable `freeMinutesLabel` (`H:MM`) and a uniform `metaLabel` ("free · H:MM" / "occupied · H:MM", empty for `closed`), so the template only prints. Also adds padding days of the neighboring months ({@see withPaddingDays()}) so the grid always starts on the `$firstDow`-th weekday and ends on the day before it.

editorBreadcrumb()  : array<int, array{label: string, path: string}>

Builds the breadcrumb navigation: cumulative segment paths.

editorLinkLangId()  : int

Returns the language used to pick labels and URLs (default 1, Czech).

editorPageLabel()  : string

Returns the page label: title, otherwise name, otherwise `#id`.

editorPageRoute()  : Route|null

Returns the first page route the editor may link to. A page may have several (many-to-many); the whitelisted one is taken, not the first in order, so a page with both `Page:show` and `Page:form` ends up on the right one.

editorPageUrl()  : string|null

Returns the front end address of a page. The router builds it from the page route, so `/o-nas` and any prefix come out on their own.

editorParentFolder()  : string|null

Returns the parent folder (null in the editor root).

editorPath()  : string|null

Converts a client path (relative to the editor root) to an Api path (relative to the `uploads/` root).

editorUploadName()  : string|null

Builds a safe and unique file name. Sanitization copies the Api layer rules (webalize of the base and of the extension), so the name returned in the URL is exactly the name the file is stored under. The random suffix prevents collisions: `writeFile()` overwrites the same name without asking, so two different `obrazek.jpg` files would overwrite each other.

editorUploadUrl()  : string

Returns the public URL of a file. `$path` is relative to the `uploads/` root (so it includes `editorUploads/`), the same shape as other uploads in the system.

ensureEditorRoot()  : void

Creates the editor root folder; when it already exists the Api returns false and nothing happens.

expireIdleLogin()  : bool

Returns whether the login expired from inactivity. If so, revokes the tokens (like a logout), clears the `auth` section, logs out the Nette identity and returns true; otherwise moves the activity stamp forward.

findOutsideSegments()  : array<int, array<string, mixed>>

Returns the segments that did not land in any block of {@see buildDayTimeline()}: outside all offered windows (a reservation from before the working hours were narrowed or before a day override, or a block on a `closed_day`). Without this the admin would not know about such a reservation.

formatDayLabel()  : string

Builds a readable day label for the day timeline header ("Thursday 12. March 2026"). The weekday name uses its own key `list.overview.weekdays.*` in this presenter domain, see {@see WEEKDAY_KEYS}; not a cross-domain `//` to `calendar.form.openingHours.days.*`, because those are abbreviations for working hours and this is a full name for a header date.

formatFreeMinutesLabel()  : string

Converts minutes to `H:MM` (like Api `TimeSlotManager::formatMinutes()`, without a cross-module import).

formatIntervals()  : string

Formats Api payload intervals (`[{from, to}, …]`) as `09:00–10:00, 12:00–13:00`; empty input gives an empty string and the template then renders no badge. The payload is `mixed` (it came over the bridge), so every item is verified, with no bare casts.

formatMonthLabel()  : string

Builds a readable month label ("March 2026"). The project has no general Latte filter for a localized month name (PHP `date('F')` is English), so this follows the Front {@see \App\UI\Front\Company\Components\BookingCalendarComponent\Traits\InitTrait} (ISO month to `months.*` key, translated via the translator) within this admin presenter, with no cross-module import of a Front component.

formatWeekRangeLabel()  : string

Builds the week range label ("10.–16. March 2026" within one month; otherwise "24. August – 30. August 2026", with the year when that differs too). Readability, not canvas-exact typography.

getClientIp()  : string

initializeMetaTags()  : void

Fills the template with the title, meta tags and HTML text of the page from the translation (`PageText`) of the current language, for the layout (like the Front {@see \App\Core\Traits\Front\Presenters\PageInitTrait}).

initializePage()  : void

isDevelopment()  : bool

loadLocalization()  : Localization|null

loadOccupiedSlotIds()  : array<int, true>

Returns the set of slots with an active reservation (`pending`/`confirmed`). Loads all active reservations of the Admin {@see ReservationManager} in one query (small volumes, no query per day or month). Memoized in a property; only {@see buildYearMonths()} calls it.

localizationCurrencyKey()  : string|null

Admin ignores the localization currency (it takes the language only).

loginReturnArgs()  : array<string, string>

Remembers the request of a logged-out user so the login can return to it ({@see storeRequest()}, `backlink` of the login page, restored by `AuthStorageTrait::redirectAfterLoginAction()`).

logoutNetteUser()  : void

makeBookendBlock()  : array<string, mixed>

Builds a compact "closed" block directly in `blocks` (same shape as {@see makeDayBlock()}, so `day.latte` renders it without a special branch). `$visualFromMin`/`$visualToMin` set the position (one hour), `$realFromMin`/`$realToMin` the label and click target (the real gap).

makeDayBlock()  : array<string, mixed>

normalizeSegments()  : array<int, array<string, mixed>>

normalizeWindows()  : array<int, array{from: string, to: string}>

Normalizes `windows` of the bridge {@see TimeSlotManager::dayDetail()} result, which is `array<int|string, mixed>` (it passed through the Service/Mapper/Repository layers without a type contract). They are not read with a bare cast but verified item by item (like `formatIntervals()`/`sumBusyMinutes()`). Shared by `renderDay()` and both `buildWeek*Data()` methods so the validation is not repeated in three places.

parseHm()  : int

Converts `H:MM`/`HH:MM` to minutes since midnight (`24:00` at the end of the day gives 1440, same convention as the Api).

prepareCalendarEntities()  : array<int, Calendar>

Returns the company calendars as entities (not `id => name` like {@see prepareCalendarOptions()}); the all-calendars week grid needs `getColor()`/`getName()`/`getId()` for the lane headers. Same filter and order as `prepareCalendarOptions()`.

prepareCalendarOptions()  : array<int, string>

Builds company calendar options `id => name`, active and not deleted only, ordered by `order` (the calendar management order). Unlike {@see prepareCompanyOptions()} there is no `asort()`: the `order` is intentional, not alphabetical, and the first one is the default (see {@see resolveOverviewCalendarId()}).

prepareCompanyOptions()  : array<int, NotTranslate>

Builds company options `id => internal name` (`Company.name` is a flat column, not translated).

processFailedLogin()  : void

processInvalidToken()  : void

processLogin()  : void

processLoginException()  : void

processMissingToken()  : void

processSuccessfulLogin()  : void

processValidToken()  : void

readLoginDeviceToken()  : string|null

Returns the raw known-device cookie for the Api login (the Api verifies its signature).

redirectAfterLoginAction()  : void

After a login attempt: a successful login returns to the request remembered before the login (`backlink`, {@see PrivilegeCheckTrait::loginReturnArgs()}), otherwise to the dashboard; a failed one stays on the login page and keeps the way back.

refreshNetteIdentity()  : bool

Refreshes the token of the same logged-in user: identity data (token, name, email) are overwritten in the stored object without `login()`, so neither the session id nor the form CSRF tokens change. The identity is stored in the session section as an object; the change is written at the end of the request.

rememberLoginDevice()  : void

After a successful login (password or OAuth) issues or renews the known-device cookie ({@see LoginDeviceCookie}): a signed proof that this browser has already logged in to the account. The next login sends it to the Api ({@see self::processLogin()}), and above the account limit the password from this browser is still verified, so foreign attempts do not lock out the owner. HttpOnly, SameSite=Lax, Secure on HTTPS; lifetime from `ratelimit.loginDevice.cookieLifetime`.

resolveContextCalendarId()  : int|null

Resolves the view calendar: the modal context wins (only a valid, active calendar of the company), otherwise GET (like {@see resolveContextCompanyId()}).

resolveContextCompanyId()  : int|null

Resolves the view company: the modal context wins, but only when it is a company the admin can see (otherwise a foreign or invalid id from a submitted form would override the selection), otherwise GET.

resolveFirstDayOfWeek()  : int

Returns the first day of the week for the current localization (ISO 8601: 1 = Monday .. 7 = Sunday).

resolveLoginErrorMessage()  : string

Resolves the flash message of a failed login.

resolveOverviewCalendarId()  : int|null

Resolves the calendar of the day overview from GET `calendarId`, otherwise the first calendar (`$calendarOptions` is already ordered by `order`, so first means default, the same decision as {@see \App\UI\Api\Company\Models\Managers\CalendarManager::resolveDefault()} in the Api).

resolveOverviewCompanyId()  : int|null

Resolves the company of the day overview from GET `companyId`, otherwise the first company by id.

resolveOverviewDate()  : string

Resolves the day/week overview date (`YYYY-MM-DD`) from GET `date`, otherwise today (like {@see resolveOverviewMonth()}).

resolveOverviewMonth()  : string

Resolves the overview month (`YYYY-MM`) from GET `month`, otherwise the current server month.

resolveOverviewYear()  : int

Resolves the year from GET `year` (`?year=2026`), otherwise the current one; the bounds keep years in a sane range.

resolveWeekAxis()  : array{0: int, 1: int}

Resolves the common hour axis of the week grid across all days (unlike the day timeline, where it is per day): the narrowest hour range covering the windows of all days that have any window.

revokeTokensOnLogout()  : void

Calls the Api logout (revokes the refresh family and deny-lists the access `jti`) for the tokens of the current session. Fail-open on purpose: any failure is only logged, because the local logout must not stay unfinished.

setNetteUser()  : void

shiftDate()  : string

Shifts a date by `$deltaDays` days (like {@see shiftMonth()}); an invalid date is returned unchanged.

shiftMonth()  : string

slotModalContext()  : array{companyId: int, calendarId: int, date: string, allCalendars: bool}|null

Returns the view context after a modal signal.

storeEditorUpload()  : bool

Stores a file; the target folder may not exist (first upload into the root), so after a failure the root is created once and the write is retried. Deeper subfolders are created by the editor user through `editorCreateFolder`.

sumBusyMinutes()  : int

Sums `to - from` (minutes) over the `list<TInterval>` `busy` array of the payload, without a cross-module import of the Api `TimeSlotManager` (same rule as {@see formatFreeMinutesLabel()}), see {@see parseHm()}.

tryRefresh()  : bool

Tries an auto-refresh for an expired access token. If the session holds a refresh token and the Api accepts it, stores the new pair in the session and returns true; otherwise returns false and the caller cancels the session.

weekdayLabel()  : string

Returns the full translated weekday name for an ISO weekday (1..7) via `WEEKDAY_KEYS`, `''` for invalid input (`dayOfWeek === 0`).

withPaddingDays()  : array<string, array<string, mixed>>

Adds padding days before/after the current month so the grid always starts on the `$firstDow`-th weekday (from the localization, {@see resolveFirstDayOfWeek()}) and ends on the day right before it. The `weekdayOrder` header columns must match the data. Returns a chronologically ordered array (leading padding, real days, trailing padding) keyed by date (`Y-m-d`); the template only renders. Empty input (no real data) is returned unchanged, because the template does not render a padding-only grid anyway.