Bookings - Frontend Submissions Integration

Administrators

1) Setting Up

The first step is to add the Bookings field to your FES Download Submission form. This field allows the vendors on your site to enable bookings for a specific Download and also configure its options. This applies to both new submissions as well as existing ones.

To add the Bookings field, navigate to your WordPress Admin, hover over the EDD FES menu and choose Submission Form. Expand the Add Extension Created Fields section found on the right hand side of the screen and click the Bookings button. The following should be added to your form:

Click the Save button at the top-right hand side of the screen to save your changes.

2) Configuring the Field

The Bookings field has all of the basic settings you would expect from more fields on the Submission Form.

The field also gives you control over which options vendors have access to and label texts. Each option that is hidden will have no saved value except for "Enable Bookings" and "Use Customer Timezone" which can have their defaults set. Each option can be shown or hidden from the Submission Form on the front end, depending on what level of configuration you wish to provide to your vendors.

Below is a description of how each Bookings field section will display on the Submission Form for vendors.

i) Enable Bookings Option

This option shows a checkbox on the form which, when ticked by vendors, enables bookings for the Download being submitted.

The label text can be configured and the option can be hidden from the form.

If the “Hide other options when disabled” checkbox is ticked, all other options will be hidden from the form and will only be shown if vendors choose to enable bookings.

You can also choose to make the checkbock checked by default. If you choose to hide the option while also making it ticked by default, submitted Downloads will still have bookings enabled. This can be useful if you only want bookable Downloads to be submitted.

ii) Session Length Option

This options shows an input field and a dropdown menu through which vendors can configure the session length for their Downloads.

The label text can be configured and the option can be hidden from the form.

iii) Min/Max Sessions Option

This option shows two input fields through which vendors can enter the minimum and maximum number of sessions that can be booked in a single booking.

The label text can be configured and the option can be hidden from the form.

iv) Session Cost Option

This option shows a single input field which allows vendors to enter the cost of a single session.

The label text can be configured and the option can be hidden from the form.

v) Availability Option

This option shows the Availability Builder on the submissions page which vendors can use to specify their availability for bookings. The builder works in exactly the same way as it does on the admin side.

The label text can be configured and the option can be hidden from the form.

vi) Use Customer Timezone Option

This option shows a checkbox on the submission form which allows vendors to choose whether booking dates and times are relative to their customers' timezones or using the site's timezone.

The label text can be configured and the option can be hidden from the form.

Furthermore, you can specify whether the checkbox is ticked by default. If you choose to hide this option, the default value will still be saved for submitted Downloads. This can be useful if you do not wish to allow vendors to change this option and enforce a specific setting.

Vendors

1) Bookings Page

The Bookings page can be accessed from the Vendor Dashboard menu.

This page will list all of your past and future bookings in a table-list form. You can click the View Details link to navigate to the Booking Details Page which shows more detailed information about that booking.

2) Calendar Page

The Calendar page can be accessed from the Vendor Dashboard menu.

This page shows a calendar that contains all of your bookings. The calendar supports three different views: month, week and day, which can be selected from the top-right corner of the calendar.

When in week or month view, selecting a day will highlight it. Selecting the highlighted day again will take you to the “day” view for that day.

Clicking on a booking on the calendar will bring up a details popup which will show some basic information about that booking.

Clicking the “View more details” link in the popup will take you to the Booking Details page.

3) Booking Details Page

This page shows all the information related to a specific booking.

This page can be accessed for any booking either from the Bookings page or the Calendar page.

FES + Commissions

When also using the Commissions extension, you can add booking information to the New Sale email that the Commissions extension sends to vendors.

To set up booking information in the email you need to navigate to your WordPress Admin, hover over the Downloads menu, choose Settings, then click on the Emails tab at the top of the page.

Under the Commission Notifications section, find the Email Body option. The {booking} template tag is available for you to put into the editor. This will be replaced with the date, time and duration of the booking in the actual email.