ACS Business Calendar

by ACS

Description

ACS Business Calendar is a small booking calendar built for the way Japanese shops, clinics and studios actually run a day: one thing happens on a given day, a fixed number of people can join it, and visitors want to see at a glance whether there is still room.

You create a calendar, add one event per day, and place the calendar anywhere with a shortcode. Visitors switch between a month grid, a week strip and a list, open an event to read the details, and send their booking from the same screen. They get a confirmation e-mail and you get a notification.

What it does

Month, week and list views, switched from the calendar itself.
Rokuyou (the six-day cycle: Sensho, Tomobiki, Sakimake, Butsumetsu, Taian, Shakko) shown per day, on or off per calendar.
Japanese public holidays marked, including substitute holidays and the weekday sandwiched between two holidays.
Today highlighted; Saturdays, Sundays and holidays coloured.
One event per day per calendar, with title, date, start and end time, place, description, capacity and up to five images.
An availability mark next to each event with a capacity: a circled mark for places available, a triangle when 30% or less is left, and a cross when it is fully booked.
A front-end booking form with name and e-mail required, telephone and notes optional.
Live capacity: the form disappears when the event is full, and a second booking from the same e-mail address is refused.
A confirmation e-mail to the visitor and a notification e-mail to the address you set per calendar.
A bookings screen with search, status and calendar filters, editing, deleting and a CSV export.
Per-calendar settings: rokuyou on or off, holidays on or off, bookings on or off, accent colour and notification address.

Privacy and external services

This plugin sends nothing to any external service. There is no analytics, no telemetry, no licence check and no remote update server. The rokuyou and public holiday information is read from static tables bundled inside the plugin, so the calendar works on a site with no outbound network access at all.

Bookings are stored in two tables in your own database (wp_acsbcal_events and wp_acsbcal_bookings) and are removed together with the calendars when you delete the plugin from WordPress.

Shortcode

[acsbcal_calendar id="123"]
[acsbcal_calendar id="123" view="week"]
[acsbcal_calendar id="123" view="list"]

id is the ID of the calendar, shown in the Calendars list and on the calendar edit screen. `view` sets the view the calendar opens in and defaults to `month`.

Add-on

Bulk e-mail to the people booked on an event, a booking analytics dashboard and a detailed CSV export are sold separately as an add-on at ACS Developer. This plugin is complete on its own: nothing here is locked, limited or time-restricted.

Installation

Install the plugin through Plugins > Add New, or upload the folder to /wp-content/plugins/.
Activate it. A “Business Calendar” menu appears in the admin sidebar.
Go to Business Calendar > Calendars > Add New, give the calendar a name, choose the settings and publish it.
Go to Business Calendar > Events, pick the calendar and add your events.
Copy the shortcode shown on the calendar edit screen into a post, a page or a block widget.

Screenshots

The month view: one event per day, the rokuyou under each date, Japanese public holidays in red, today highlighted, and an availability mark on every event that has a capacity.
The week view: the same week as a strip of seven days, with the event times and the availability marks side by side.
The list view: the coming events one after another with date, time, place and availability, for pages where a grid is too wide.
An event opened from the calendar: the details panel with the date, time, place, description and remaining places, and the booking form underneath.
Business Calendar > Events in the admin: the events of the selected calendar with their dates, times, capacity and the number of bookings taken.
Business Calendar > Bookings in the admin: every booking with search, a status filter and a calendar filter, editable in place and exportable as CSV.

Faq

How many events can one day hold?

One. A calendar rejects a second event on a date that already has one, on both the add and the edit screen. If you need several things on the same day, create a second calendar and place both shortcodes on the page.

How is the availability mark decided?

Only events with a capacity above zero get a mark. The plugin counts the confirmed bookings of the event and compares them with the capacity: a cross when nothing is left, a triangle when 30% or less of the capacity remains (always at least one place), and a circled mark otherwise. An event with a capacity of 0 accepts bookings without a limit and shows no mark.

Is the rokuyou calculated correctly?

Rokuyou depends on the Japanese lunisolar calendar, so it cannot be worked out from the Gregorian date alone. The plugin ships a table of the first day of every lunar month from 22 November 2014 to 23 February 2066 and derives the rokuyou from it. Dates outside that range simply show no rokuyou rather than a wrong one.

Which public holidays are covered?

Japanese public holidays from 2016 to 2099, worked out from the Act on National Holidays: the fixed dates, the Happy Monday holidays, the two equinoxes, the substitute holiday after a holiday that falls on a Sunday, and the weekday sandwiched between two holidays. The years whose dates were moved by special legislation are included as bundled overrides. Nothing is fetched from a holiday API.

Does the plugin send anything to an external server?

No. There is no outbound HTTP request anywhere in the code, no tracking script, no external font and no remote update check. The only e-mails sent are the booking confirmation to the visitor and the notification to the address configured on the calendar, both through wp_mail().

What happens to my data if I delete the plugin?

Deleting the plugin from the Plugins screen drops both of its tables, removes its option and deletes the calendar posts it created. Deactivating the plugin changes nothing, so you can deactivate it safely while you test something else.

Can I use it on a site that is not in Japanese?

Yes. The interface is in English and the source strings are in English, so translations can be contributed at translate.wordpress.org. Rokuyou and the Japanese holiday marks can be turned off per calendar if they are not relevant to you.

Where do I get support?

Through the support forum at https://acs-developer.com/forum/ .

Reviews

Changelog

1.0.0

First release.
Month, week and list views with rokuyou, Japanese public holidays and a highlighted today.
One event per day per calendar, with times, place, description, capacity and up to five images.
Availability marks driven by the live confirmed booking count.
Front-end booking form, confirmation e-mail to the visitor and notification e-mail to the site.
Bookings screen with search, filters, editing, deleting and a CSV export.
Uninstall removes the plugin’s tables, option and calendar posts.