Book Me

By Moses Cursor Ssebunya

0+ active installationsVersion 1.2.0

Appointment bookings with 30/60-minute durations, daily available times, working hours, time away and email notifications.

Description

Book Me keeps the original official ZIP’s customer details and notifications, with scheduling features incorporated from the Book-Me GitHub project.

  • Offer 30-minute appointments, 60-minute appointments, or both.
  • Let clients choose a date and see only available start times.
  • Show a monthly calendar with availability counts.
  • Set weekly working hours and closed days.
  • Block partial days, whole days or multi-day time away.
  • Prevent overlaps across different appointment durations.
  • Capture client name, email, international phone and description.
  • Send customer/admin confirmations and client cancellation emails.
  • Review bookings and mail processing outcomes in the admin dashboard.
  • Retry failed cancellation emails from the booking list.
  • Import old ZIP/GitHub records and upgrade version 1.1.0 bookings safely.
  • No external calendar library or CDN is required.

Installation

  1. Back up your site/database and test this ZIP in Playground or staging first.
  2. Deactivate any separate GitHub Book Me installation. Run only this plugin.
  3. Upload book-me.1.2.0.zip under Plugins > Add New > Upload Plugin.
  4. Choose to replace an earlier book-me version, then activate if necessary.
  5. Set the site timezone under Settings > General.
  6. Visit Book Me > Availability to choose durations, working hours and time away.
  7. Add [booking_form] to a page. [book_me_form] and [booking_calendar] are aliases.
  8. Exclude booking pages and the availability endpoint from full-page/CDN caching.

FAQ

Where do I choose slot duration?

In Book Me > Availability, enable 30 minutes, 60 minutes, or both. Clients choose among your enabled durations on the booking page. Starts are offered every 10 minutes; the entire chosen duration must fit inside working hours and avoid all bookings and time away.

Where can I see available times for a day?

Select a date in the calendar or date picker. The Available times section shows only currently free starts for the selected duration. Choosing a different duration updates the available times and calendar counts in place without leaving the form or clearing client details. Without JavaScript, use Show available times and the time dropdown.

How do I set time away?

Go to Book Me > Availability > Time away. Enter the beginning and end in the displayed site timezone. For a whole day, enter 00:00 to 00:00 the next day. Partial-day and multi-day blocks are supported. Labels are private. Time away prevents new reservations; existing appointments remain booked until you cancel them explicitly.

Does cancelling notify the client?

Yes. Cancel from Book Me > All Bookings. The appointment is released, its history is retained, and a cancellation email is attempted to the saved client address. The dashboard shows the result. Retry cancellation email appears for a failed send when a usable address exists. Imported GitHub slots have no client address and therefore cannot be emailed. Clients cannot yet cancel themselves.

Are existing bookings preserved on upgrade?

Version 1.1.0 bookings remain 60-minute appointments. Their end times are added automatically. Older ZIP contact details become an unscheduled legacy request. Valid GitHub date/time entries become one-hour reservations. The original bm_booked_slots option is retained untouched. Malformed/overlapping legacy entries are skipped; the dashboard notes skipped entries. Data overwritten before this release cannot be recovered by the plugin.

How are overlaps prevented?

Reservations, cancellations and availability edits share a transactional database mutex. The server checks the whole UTC appointment interval while holding that lock. A unique request key also prevents repeated POSTs from generating extra reservations or confirmation attempts. A displayed time may become unavailable before confirmation; the server checks again.

Do emails arrive in Playground?

Playground is not a reliable external email-delivery environment. Reservations/cancellations remain saved if mail fails. Production delivery depends on your host or SMTP service. Accepted by mail system does not prove inbox delivery. A server interruption during an email attempt may leave an in-progress status requiring operator review.

How do the ten-minute breaks work?

A ten-minute break is required between meetings in either booking order. For example, 09:00-10:00 can be followed at 10:10. Actual appointment duration and stored end times stay unchanged. Existing adjacent bookings are retained; the buffer applies when accepting new appointments. Time away retains its entered boundaries.

How does timezone handling work?

The booking page and working hours use the timezone in WordPress Settings > General. Bookings and away intervals are stored as UTC instants; booking records retain their original displayed timezone. Existing appointments are not moved by a later timezone change. Automatic visitor timezone detection is not included.

What are the defaults?

Both 30- and 60-minute durations, every day 09:00–17:00, no time away, and a 365-day booking horizon. Weekly settings support one daytime window per day in 30-minute increments. Overnight windows, recurring split shifts and automatic break rules are not included; individual breaks can be time-away entries.

Is this a full Calendly replacement?

This release provides the core booking flow for a single shared resource. Google/Outlook calendar sync, visitor timezone switching, multiple staff/services, payments, reminders, rescheduling, customer cancellation links, automated retention and privacy export/erasure are not included.

How is public abuse handled?

Nonce and input validation, a honeypot, and best-effort hourly limits (3 accepted booking attempts per email; 5 per source IP). Shared IPs share a limit. These controls do not replace a firewall or stronger bot protection.

Does deleting the plugin delete records?

No. Customer records, schedule settings and original legacy data remain for deliberate backup/retention decisions. Activate per site; network-wide multisite provisioning has not been validated.

Changelog

1.2.0

  • Update duration, date and month availability without navigating away from the booking form.
  • Require a ten-minute break between appointments and offer starts in ten-minute increments.
  • Verify compatibility with WordPress 7.1 while keeping version 1.2.0.
  • Make nonce checks explicit in availability settings handlers.
  • Escape and validate custom table identifiers, cache read-only lists, and invalidate them after committed changes.
  • Keep reservation decisions uncached under the database mutex, with documented per-query exceptions.
  • Add configurable 30/60-minute durations and interval-aware reservations.
  • Add daily available-time selection and live availability lookup.
  • Add weekly working hours, closed days and private time-away periods.
  • Send client cancellation emails and expose failed-send retries.
  • Preserve existing 1.1.0 reservations as one-hour appointments.
  • Improve responsive rendering in narrow theme content areas.
  • Validate upgrade, booking, availability and cancellation behavior in Playground SQLite.

1.1.0

  • Merge GitHub scheduling/admin features into the official ZIP baseline.
  • Add durable storage, migration, unique reservations and shortcode aliases.

1.0.0

  • Initial official ZIP with contact capture and email notifications.