Skip to content

Availability Rules

Jeremy Anderson edited this page Nov 3, 2026 · 1 revision

Availability Rules

How the plugin decides which times to offer. If a time you expected is missing, walk down this page in order.

The calculation

flowchart TD
    A["Days requested (one month at a time)"] --> B["Keep days inside the booking window:<br/>today to today + 'Book up to' days,<br/>or the last posted shift if sooner"]
    B --> C{"Day off?"}
    C -->|"yes"| X["No times that day"]
    C -->|"no"| D["Hours for the day:<br/>the type's own hours or your usual hours"]
    D --> E["Start times every 'spacing' minutes<br/>that fit the whole appointment"]
    E --> F["Drop times sooner than 'Minimum notice'"]
    F --> G{"Daily cap reached?"}
    G -->|"yes"| X
    G -->|"no"| H["Busy times from every blocking calendar<br/>(fails closed if any can't be read)"]
    H --> I["Plus bookings made here,<br/>widened by their own free time"]
    I --> J["Plus shifts on the work schedule,<br/>widened by 'Keep free around each shift'"]
    J --> K{"Start time, with free time before and after,<br/>overlaps anything busy?"}
    K -->|"yes"| X2["Not offered"]
    K -->|"no"| OK["Offered"]
Loading

Each rule

Rule Setting Effect
Hours When people can book → each day, or the type's own hours Only start times where the whole appointment fits inside a range
Start-time spacing Type → spacing 30 = :00 and :30; 15 = every quarter hour
Minimum notice When people can book → Minimum notice (hours) No times sooner than this from now
Booking window Book up to (days ahead) Last bookable day
Work schedule Where bookings go → Open booking only as far as Window ends at the last posted shift (optionally that Sunday); see Shift-Work Mode
Days off When people can book → Days off Whole days closed; one date or range per line
Free time before / after When people can book Clear time around each new appointment, also kept around appointments booked here
Free time around shifts Where bookings go → Keep free before and after each shift Clear time around work-schedule events; counts toward the above, doesn't stack
Daily cap Most bookings per day (0 = no limit) Counts payment holds too
Per-person cap Upcoming bookings per person (0 = no limit) Checked at booking time, by email address
Busy calendars Each service's section Events marked busy, tentative or out of office block; free/transparent and cancelled events don't

Days off format

2026-12-24
2026-12-31 to 2027-01-02
2027-07-04  # a comment after # is ignored

Invalid lines are reported when you save.

Buffers in practice

With Free time after = 15 and a 30-minute type:

Existing event Last start before it First start after it
10:00–11:00 in your calendar 9:15 (ends 9:45 + 15 = 10:00) 11:00
10:00–10:30 booked here (also keeps its 15) 9:15 10:45
Shift 12:00–16:00, 60 min kept free around shifts 10:30 (ends 11:00, an hour before) 17:00

At the moment of booking

Open times are cached for 2 minutes, so a visitor's page can be slightly out of date. Booking never relies on that cache:

sequenceDiagram
    participant V as Visitor
    participant S as Your site
    participant C as Calendars
    V->>S: Book 10:00
    S->>S: Take the lock for 10:00 (atomic)
    S->>C: Read busy times live (no cache)
    alt Still free
        S->>C: Create the event
        S-->>V: Booked
    else Taken meanwhile
        S-->>V: "That time was just taken. Pick another time."
    end
    S->>S: Release the lock
Loading

Times and time zones

Thing Time zone
Your hours, days off, notice Your site's timezone (Settings → General)
What visitors see Their own browser's timezone, labelled on the widget
Events in your calendar Exact instants, so they land correctly in any calendar timezone
Daylight saving changes Handled when the site timezone is a city

Related: Calendar Services · Shift-Work Mode · Settings Reference · Troubleshooting

Clone this wiki locally