Buttons and dialogs
The colour, shape and icon of a button show how serious the consequences of an action are. Before anything that cannot be undone, fepli asks in a dialog first.
Consequences of an action
Some actions can be undone, others cannot. This decides whether a dialog asks first and what colour the button has.
| Level | The action … | Examples | How fepli shows it |
|---|---|---|---|
| 0 View | opens or shows something and changes nothing. | Details, Export | is carried out at once, without a dialog |
| 1 Change | changes data; the change can be undone. | Save, Archive | is carried out at once; a message confirms the result |
| 2 With consequences | sends messages, moves money, fixes a decision or has an effect beyond the page. Often it cannot be undone. | Newsletter, Refund, Cancel, Allocation, Commit | asks in a dialog or shows a preview first, with the button in the primary colour; the label ends with “…” |
| 3 Delete | removes data or an access permanently. | Delete, revoking an access, withdrawing a permission | red text on a white button; only the dark red button in the dialog carries out the action |
Buttons
| Example | Meaning |
|---|---|
| Main action | The most important action of a window, e.g. Save. At most one per window. It is in the primary colour (Primary colour). |
| Further action | All other actions, including Cancel |
| Start deleting | Opens the dialog for deleting or revoking. Deleting happens only there. |
| Carry out for good | Only in a dialog. Deletes, revokes or discards changes for good, with a trash can when it deletes. |
| “…” at the end | Opens a dialog. The action is carried out only there. The manual names the label without “…”. |
| Without label | In the rows of a list, for closing (✕) and for the actions menu (⋮). When you point at it with the mouse, the label appears. |
Primary colour
Every instance sets its own primary colour (Settings: Identity & appearance). Without a colour of its own, it is the red of fepli. The dark red button for carrying out an action for good always stays dark red.
Symbols on buttons
These symbols mean the same on every button. Buttons such as Save carry no symbol.
| Symbol | Meaning | Example |
|---|---|---|
| Plus | Creates or adds something. | |
| Paper plane | Sends a message. | |
| Trash can | Deletes. | |
| Arrow pointing up and to the right | Opens a page outside the admin panel in a new tab. | |
| Box with an arrow pointing up | Opens an export. You select what and in which format; it is created only afterwards. | |
| Arrow pointing down into a tray | Downloads a file. | |
| Sparkle | Creates something with AI. | |
| Arrow pointing right or left | Leads to another page. |
Actions menus
In the actions menu (⋮) every action carries an icon, some carry their key on the right. Actions that delete or revoke stand at the end in red.
| Symbol | Action | Example |
|---|---|---|
| Two arrows pointing outwards | Open: the page of the entry | |
| Pencil | Edit | |
| Two sheets | Copy | |
| Paper plane | Sends a message. | |
| Trash can, red | Delete | |
| Prohibition sign, red | Revoke, e.g. an access |
Dialogs and notices
In front the confirmation dialog for deleting an offer, below it the question before saving the API settings.
| Element | Meaning |
|---|---|
| Confirmation dialog | Asks before deleting and before actions with consequences. It names what is affected, who receives a message and whether the action can be undone. |
| Icon beside the title | Red before deleting or revoking, yellow before other consequences, orange before a refund, green after something done, in the primary colour before sending or approving |
| Buttons in the dialog | Cancel closes the dialog without consequences. Beside it is the action with the same label as in the menu, e.g. Delete offer. |
| Question before saving | For changes that have an effect beyond the page. Save then does not save at once (Question before saving). |
| Notice | Stands on the page above what it concerns. The bold part says what is the case, the text what follows. At most one action as a link. |
| Message | Confirms the result after an action or names the error (Messages after an action). |
If something prevents the action, the confirmation dialog names the reason and offers only Close.
The colour of a notice says how important it is: blue informs, green confirms, yellow warns, red blocks, grey names a state in which nothing needs doing.
Question before saving
Some changes can be undone but have an effect beyond the page. Then Save first shows a dialog:
- It shows each change with the old and the new value, and the entries it affects.
- Apply change can be selected only when the checkbox above it is turned on.
Examples are turning off Organizers under Fields and a new email address of an account (Email address change).
Messages after an action
- A message appears at the bottom right and disappears after 5 seconds. An error message stays until you close it.
- After sending, the message gives the number of messages sent.
- If an action can be taken back for a moment, “Done” appears with Undo at the bottom edge.
- If saving takes longer than about 2 seconds, fepli reports “Saved”.
- If saving fails after you have left the page, “Not saved” with Open stays until you close the message.