Documentation

Calendar View

Navigate to JoomBook → Appointments. You first land in the calendar view, which shows all appointments visually by day, week, or month. Use the arrow buttons and Today to move between periods.

Click an event to open the appointment for editing. Use New (top left) or click a day to create a new appointment.

Closed times and absences in the calendar

The calendar shows not only appointments but also when no booking is possible, so you can see at a glance why a day stays empty.

• Closed days and holiday periods are shaded in rose and, in month view, labelled with the reason.
• In day and week view, the time outside the opening hours is greyed out.
• If you filter to a single staff member above, that person's absences and non-working days are shaded as well (amber, with an opposite pattern), and the opening hours shown are their working hours.

A legend below the calendar explains the states: "Location closed", "Outside opening hours" and - when filtered to a staff member - "Staff member absent". Every state carries a pattern as well as a colour, so the information does not depend on colour vision alone.

Calendar settings (gear)

The gear button above the calendar opens the Calendar settings panel, which slides in from the right and has three tabs: General, Tooltip and Colours. Changes are applied immediately. Important: the settings are tied to the signed-in Joomla user account - each person sees their own view. Existing installations keep the previous values as the default.

"General" tab

• Start view - which view the calendar opens with: month, week or day.
• Sound on new booking requests - turns the signal tone on or off (see "New booking requests" below).
• Time range in day and week view - the full 24 hours or only the opening hours (default). Entries outside always stay visible.
• Closed days - show or hide.
• Day view - "One column" or "One column per staff member". In the column layout, dragging across a column blocks that period for that person straight away (no dialog); clicking a time opens a new appointment with that person already filled in. The columns can be arranged by hand at the column header, by dragging - or via the arrows.

"Tooltip" tab

The tooltip is the small box that appears when you hover an appointment. Here you decide what it contains and in which order.

• Appointment title - the order in the title: service first then customer, or the other way round.
• Service label - the full name or the service short code. If no short code is set, the full name is shown.
• Tooltip rows - tick what should appear; drag the handle on the left to reorder. Available: date, time, staff member, location, e-mail address (clickable), price, first-visit note, appointment status, duration, customer name, phone number (clickable), payment status, customer comment and booked-on. E-mail address and phone number are clickable links in the visible tooltip.

"Colours" tab

Set separately what the colouring follows - status, service, service category, staff member or payment status:

• Main bar - the dominant colour of the appointment (default: status).
• Start segment - the small area before the time (default: service).
• Colour of blocked time and Colour of appointments awaiting confirmation.

The text colour switches automatically between dark and light so it stays readable on any colour. Pair bookings coloured by staff show both staff colours as a split (top/bottom) bar.

New booking requests: the bell

As soon as a booking is waiting for a decision - on installations that confirm manually, or that confirm automatically but hold back requests carrying a comment - a bell appears above the calendar with the number of open requests. When a new one arrives the bell pulses briefly and, if the sound is on, a short tone chimes. Clicking the bell opens the list of open requests - each with its date and time, the customer, the service and the staff member, the customer comment where there is one, and a Confirm and a Decline button right there.

The sound stays silent until the page has been clicked once (browsers require this). It is switched on and off under Gear → General → "Sound on new booking requests".

Jumping to a date

In the toolbar above the calendar, the "Go to date" button opens a small date picker that takes you straight to any day - especially handy in day view, where each arrow click otherwise moves only a single day. The picker starts on the date currently shown and works in month, week and day view alike.

List View

Use the toggle at the top right to switch between Calendar and List. The list view shows your appointments with the key columns:

• Date & time of the appointment
• Customer name
• Booked service
• Assigned staff member
• Location
• Status (Pending / Confirmed / Cancelled / Completed / No Show)
• Payment status and price
• Booked on (time the booking was made)

A coloured bar on the left of each row indicates the status at a glance. Click a row to open the appointment in the edit panel.

Filter & Sort

• Filter by location: via the location tabs above the list ("All Locations" plus one tab per location)
• Filter by staff member: via the staff dropdown
• Sort: by clicking the relevant column heading (e.g. by date or status)