Skip to content
Voxbi Cockpit APIs
API Guides

Layout

A status changer layout is a per-target button arrangement for the status-changer widget on terminals, in the Voxbi app, and on the web. Each layout maps a set of statuses to buttons so different devices and departments see only the statuses relevant to them.

Overview

Layouts decouple what statuses exist (managed on the statuses page) from what a given device shows.

What it does

When someone opens the status changer, the client reports its source (terminal, app, or web) and its target (the employee or terminal). The system picks the most specific layout matching both, and falls back to the default when nothing matches.

The layout editor: a grid size picker beside the arrangement of status buttons
The layout editor: a grid size picker beside the arrangement of status buttons

The grid size sets how many columns and rows of buttons the target sees, and the editor beside it is what the employee will actually be looking at.

Every PBX keeps exactly one default layout. The Default switch in the layout list moves it without opening the layout: switch it on for another layout, confirm the move, and the one that held it is cleared as the list refreshes. The same thing happens from Is default on the edit form.

Because one layout always has to hold it, the default is moved rather than cleared — switching it off on the only default is refused, on the list and on the form alike. To hand it over, turn the switch on for the layout that should have it.

See also

Form fields

Fields available in the create and edit forms.

General

Name

Descriptive label for this layout, shown in dropdowns and on the terminals configuration page.

Sources

Which client apps show this layout. Select one or more of Voxbi Web, Voxbi Mobile, Badge Tablets, and Tempus Native.

Is default

When on, this layout is the fallback for users with no specific layout assigned. Saving it as default removes default from the layout that held it, so there is only ever one. It cannot be switched off on the only default - turn it on for another layout instead.

Is active

When off, this layout is hidden from all users and devices.

All targets

When on, the layout applies to every terminal, user, and group. Turn off to target specific groups or devices below.

Shown when

Is default is off

Targets

Specific terminals, departments, employees, or Cockpit groups that see this layout. Editable only when All targets is off.

Shown when

Is default is off

Updated