🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Booking Calendar Integration Premium Add-on Setup Guide

Updated 9 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What you need
  3. Install and activate
  4. Your first booking feed
  5. Visitor details
  6. The booking resource
  7. Days and times
  8. Status and e-mails
  9. Taken days and times
  10. Confirmations, e-mails and merge tags
  11. Bookings made in Booking Calendar
  12. Conditions, delayed payment and the license
  13. Good to know
  14. Frequently asked questions
  15. Do I need the paid version of Booking Calendar?
  16. Can two visitors book the same time?
  17. Where does the visitor see the free days?
  18. What happens if Booking Calendar is deactivated?
  19. Troubleshooting

Video walkthrough

Gravity Forms Booking Calendar: Turn Form Entries into Booking Calendar Bookings (Free Plugin)
Video tutorial: Gravity Forms Booking Calendar Integration Watch on YouTube

The Gravity Forms Booking Calendar Integration Premium Add-on turns a Gravity Forms submission into a real booking in the free Booking Calendar plugin. It reads the days and the time from your form, asks Booking Calendar whether they are still free, and then saves the booking through the plugin’s own save routine, together with the visitor’s name, e-mail address, phone number and notes. The booking appears in the Booking Calendar list, on its calendars and in its e-mails like any booking made with its own form.

Use it when you want the form builder in front of your calendar: extra questions, conditional logic, file uploads, payments through a Gravity Forms payment add-on, or simply a form that matches your site. Booking Calendar stays the one place that knows which days and hours are taken.

What you need

  • WordPress 6.5 or newer and PHP 7.4 or newer.
  • Gravity Forms 2.9 or newer. The add-on is tested with Gravity Forms 3.1.2 on PHP 8.3 and Gravity Forms 2.9.8 on PHP 7.4.
  • The free Booking Calendar plugin from WordPress.org, version 11.0 or newer. The add-on is tested with version 11.9.1.
  • An active license key for this add-on.

If Booking Calendar is missing or too old, the add-on tells you with a notice in the WordPress admin and on the feed list, and a feed does nothing until the plugin is back. Nothing breaks on the visitor’s side: the form is still sent and the entry gets a note that says why no booking was made.

Install and activate

  1. Install and activate the add-on like any plugin, after Gravity Forms and Booking Calendar.
  2. Open Forms → Settings → Booking Calendar and enter your license key.
  3. Open your booking form, go to Settings → Booking Calendar and press Add New.

Your first booking feed

A feed is one rule: when this form is sent, make this booking. Keep What this feed does on Create a Booking Calendar booking from each submission, map the visitor details, choose the Date field, and save. Send the form once and open Booking → Bookings: the booking is in the list.

Visitor details

The box Booking form fields lists the standard fields of the Booking Calendar booking form: first name, last name, email, phone, address, city, postal code, country, number of visitors, number of children and details. Choose the form field that holds each answer and leave the others empty. Whatever you map is saved in the booking, so it shows in the Booking Calendar list, in its e-mails and in its export.

If your own Booking Calendar form has more fields, use Extra booking form fields. Type the name you gave the field in Booking Calendar, using lowercase letters, digits and underscore, and choose a form field or a text with merge tags as the value. The names of the time fields and of the standard fields cannot be used here, because the add-on fills those itself.

Answers are saved as plain text on one line, with the two characters that Booking Calendar uses as separators removed. A long answer is cut to a safe length, and the notes field may be up to 2,000 characters.

The booking resource

The free Booking Calendar has one calendar, listed as resource 1. The paid versions of the plugin add more; the add-on lists the resources it finds in the plugin’s resource table by name, so you can fix one in the feed, or let the visitor choose with a drop-down or radio buttons. Use List the resources in this field to fill that field automatically, and Only these resources to keep some resources out of the list. The same rule fills the list and checks the answer, so a resource you did not allow is refused even if someone changes the form in their browser.

The resource list of the paid versions could not be tested with the paid plugins; it was tested with the table they use, and bookings were tested on the free plugin.

Days and times

Choose how many days a booking covers. One day uses one Date field. From a first day to a last day uses two Date fields, for stays and rentals; the last day belongs to the booking, and a booking can cover up to 120 days. A booking cannot start in the past or more than about three years ahead.

A Gravity Forms booking form named Reserve the cottage with first name, last name, email and phone, an arrival date, a departure date, a notes box and a guests number
A form with an arrival date and a departure date: the add-on turns them into the days of the booking.

Then choose the time:

  • No time books the whole day, or every day of the range.
  • A start time field and an end time field books only those hours. The end must be after the start on a single day. With a range of days, the start time belongs to the first day and the end time to the last day, which suits a stay with a check-in time and a check-out time. An end time of 12:00 am means the end of the day.
  • A start time field and a length in minutes takes the length from a fixed number in the feed, or from a field such as a drop-down with 30, 60 and 90. A booking that would pass midnight is refused.

Booking Calendar lets other visitors book the rest of the day, and a booking that ends at 11:30 leaves 11:30 free for the next one.

Status and e-mails

Status either follows the Booking Calendar settings, which means pending unless the plugin is set to approve new bookings by itself, or approves the booking at once. Booking Calendar e-mails is off by default, because Gravity Forms notifications usually do that job; switch it on if you also want the e-mails you set up in Booking Calendar.

Taken days and times

When the form is sent, the add-on asks Booking Calendar whether the chosen days and times are free, using the plugin’s own availability function, and puts a message at the Date or Time field if they are not. The check covers bookings made with other forms, bookings you added in the admin, and days you blocked. It also refuses a past day, a day too far ahead, a last day before the first day, an end time before the start time and a length that does not fit in the day.

Two visitors can still send the form at the same moment. For that, Booking Calendar’s own save checks the days and times again under its own lock. The first booking is saved; the second entry gets a note that says no booking was made, and only one booking exists.

Confirmations, e-mails and merge tags

After the booking is saved, these merge tags work in confirmations and notifications: bkcal_booking_id, bkcal_start_date, bkcal_end_date, bkcal_dates, bkcal_start_time, bkcal_end_time, bkcal_time, bkcal_resource, bkcal_resource_id, bkcal_status and bkcal_admin_url, each written inside curly brackets. The dates and times follow your WordPress date and time formats. The admin link opens the booking in the Booking Calendar list, so use it in notifications to your team and not in e-mails to visitors.

Notification events are added to forms that have a feed: booking created, booking approved, booking status changed and booking cancelled. They let you send one e-mail to the visitor when the booking is made and another when you approve it in Booking Calendar.

Bookings made in Booking Calendar

Not every booking comes from your form. A second kind of feed does the opposite: set What this feed does to Make an entry for bookings made in Booking Calendar, map the fields you want filled, and every booking created with the plugin’s own form adds an entry to that form. You can limit it to one resource. Bookings made by a booking feed of this add-on do not make a second entry.

Entries made this way, and entries made by a booking feed, follow the booking afterwards: when the booking is approved, set back to pending, moved to the trash or deleted in Booking Calendar, the entry meta and the entry note are updated and the matching notification events are sent, once each.

The Booking Calendar booking box on a Gravity Forms entry screen with the booking number, status, resource, first day, last day, start time and end time and a button to open the booking in Booking Calendar
The entry screen shows the booking that was made, with its live status.

The entry screen of a booking has a Booking Calendar box with the booking number, the status, the resource, the days and the times, and a button that opens the booking in the plugin. The booking number and the status are also entry meta, so you can use them as columns and filters in the entry list.

The Booking Calendar bookings list in the WordPress admin showing a pending booking with a time slot, made from a Gravity Forms form
The booking is an ordinary Booking Calendar booking, listed in the plugin itself.

Conditions, delayed payment and the license

Conditional logic works as in any feed. The feed also offers the standard Gravity Forms option to create the booking only when a payment add-on reports that the payment is complete, so a time is not held for an unpaid form. Without an active license nothing is booked and the entry says so; the visitor is not blocked.

Good to know

  • Booking Calendar decides whether a pending booking holds its days. By default it does not show pending days as free, so a pending booking blocks the dates; check that setting in Booking Calendar if you changed it.
  • The time zone is the WordPress site time zone.
  • The add-on writes bookings with the developer function of Booking Calendar and reads the plugin’s tables; it never writes to them directly. If a future version of the plugin changes these, the add-on writes an error note instead of failing.
  • Costs, deposits and payments of the paid versions of Booking Calendar are not handled by this add-on; use a Gravity Forms payment add-on with the delayed option.
  • Changing a booking inside Booking Calendar does not change the Gravity Forms entry answers, only the status shown with the entry.
  • Nothing is sent to any outside service.

Frequently asked questions

Do I need the paid version of Booking Calendar?

No. The add-on works with the free plugin from WordPress.org. Resources of the paid versions are listed when they exist.

Can two visitors book the same time?

No. The time is checked when the form is sent and again by Booking Calendar when the booking is saved.

Where does the visitor see the free days?

This add-on books from your Gravity Forms form. It checks the days and times when the form is sent. If you want visitors to see a calendar of free days first, show the Booking Calendar calendar on the same page.

What happens if Booking Calendar is deactivated?

The form is still sent, the entry gets a note, and a notice in the admin tells you the plugin is missing.

Troubleshooting

  • The visitor sees that the time is not available although the calendar looks free: check blocked days and times, the working times of the plugin and pending bookings.
  • No booking is made and the entry says the license is not active: activate your key under Forms, Settings, Booking Calendar.
  • The entry note says the end time must be after the start time: check that the two time fields are the right way round, or use a length instead.
  • First name is empty in the booking list: map the first name row; the plugin’s own field name for it is firstname.

See the Booking Calendar add-on

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr