Configuration import of Google Calendar Events

01. To get Google Calendar API key please follow this instruction:

  1. Go to Google Developer Console: https://console.developers.google.com. And then click on Google Calendar API link.

    api-01

  2. Click "Create Project".

    api-02

  3. Give your project a name and click "Create".

    api-03

  4. Click on Enable button.

    api-04

  5. In the sidebar click on "Credentials".

    credentials-01

  6. Click on "Create credentials" to expand dropdown list and select "API Key".

    credentials-02

  7. On the popup click the button "Server Key".

    credentials-03

  8. Enter Name of your API Key and click on "Create" button

    credentials-04

  9. Copy "API Key" and paste it into Google API Key field at Booking > Settings > Import > Google Calendar Events Import page in your WP admin panel.

    credentials-05


02. Set Your Calendar to Public:

  1. Navigate to your Google calendars.

  2. Open the settings for the calendar.

    cal-1

  3. Click the "Share this Calendar" link.

    cal-2

  4. Click the checkbox to make calendar public. Do not check the other option.

    cal-3


03. Find Your Calendar ID:

  1. Navigate to your Google calendars.

  2. Open the settings for the calendar.

    cal-1

  3. Now copy the Calendar ID to use in the Booking > Settings > Import > Google Calendar Events Import page in your WP admin panel for "Calendar ID" field(s). Make sure to use the Calendar ID only, not the entire XML feed URL.

    cal-4


04. Test Import of Google Calendar Events:

  1. Open your WordPress admin panel and Navigate to Booking > Settings > Import > Google Calendar Events Import page.

  2. Paste your Google API Key and Google Calendar ID into specific fields. Important! Please be sure that you do not paste any white spaces at the beginning or ending of API Key or Google Calendar ID. Save the changes.
    In the paid versions of Booking Calendar you can assign at this page different Google Calendar ID for the different booking resources.

    wpbc-01

  3. Open Booking Listing page and switch to the "Actions toolbar", then click on "Import" button.

    wpbc-02

  4. In popup dialog configure your parameters (during first test import, please be sure that you selected time interval, where for sure exist your Google Calendar Events). And then click on Import button.

    wpbc-03

  5. You have to see your imported events. Reload the page to see them as bookings.

    wpbc-04

General instruction about usage of paid versions of Booking Calendar

1) You need to create the booking resources for the each of your properties or services on the Booking > Resources page.
You can read more info about the booking resources and how to configure them on this page.

2) Then you be able to insert the booking form for the specific resource (your property or service, which need to be booked) into the any posts or pages. You can check how to insert and configure booking shortcode into the posts or pages here. Also check how manually to configure Booking Calendar shortcodes here.

3) Finally you can reconfigure settings, form fields and email templates, if you need the different options, on the Booking > Settings pages.

Adding additional costs of some additional charges of selection in select boxes or check boxes in booking form (tax, cleaning, breakfast, visitors selection, excursion, etc…)

Please note, this configuration is possible at the Business Medium or higher versions.

Description
If you are need to add the additional costs, like tax or some other additional charges (cleaning,breakfast, excursion...), or just increase the cost depend from the visitor number selection at the selectbox, which is depend from the selection of the selectboxes or checkboxes in the booking form, so then you can make this configuration in the Business Medium or higher versions.

Configuration
1) You can insert into the Booking form, at the Booking > Settings > Fields page some checkbox, like this:

Tax: [checkbox* my_tax ""]

If you are need to have this checkbox invisible and checked by default in this way:

<div style="display:none;">[checkbox* my_cleaning ""]</div>
<p>

If you are need to have this checkbox checked by default so use it in this way:

Cleaning service: [checkbox* my_cleaning default:on ""]

For the selectbox, its can look like this:

<p>Visitors [select visitors "1" "2" "3" "4"]</p>
<p>

Please read more about the booking form fields configuration here

2) Then at the Booking > Resources > Advanced cost page at the advanced cost management section for the option my_tax or/and visitors, set some additional cost.

For example, for the tax 6% you need to set value 106% there.

Or if you want to add the fixed cost value, you can set this value to this "my_cleaning" option:

my_cleaning = 50

or for the visitors selections you can leave this configuration:

visitors:
1 = 100%
2 = 200%
3 = 300%
4 = 400%

etc....

How to activate the half booking days ?

It's possible at the Booking Calendar Business Small and Business Medium versions of Booking Calendar in update 4.1 or newer.

You can activate "Use check in/out time:" option at the General Booking Settings page.
Then in the sub-settings set the "Check in" time as 15:00 and "Check out" time as 10:00. (You can set the different times there, but be sure to set the "Check In" time older than "Check Out").
Save the settings page.

Now, your visitors will be able to use the same date as check in/out date for the different bookings, its mean if the some booking is finished on the specific date, other visitor can start the new booking on the same specific date.
The check in/out days in calendar will be marked as half booked (diagonal line) and not by clock icon as for the usual timeslots.

Please note, this option will apply globally to the all booking resources and will overwrite any time slots, if you will use them in the booking form.

If you are need to use just time slots in the booking form, so you are need to deactivate this option and configure the time slot selection at the Booking > Settings > Fields page. Please read more about the booking form fields configuration here.

Capacity concept

Description
At the Booking Calendar Business Large (old Hotel Edition) and MultiUser versions are possible to set the capacity of the booking resources. It's mean that visitors of your site can make several bookings per same selected FULL (not a time slot) date in specific calendar (booking resource). It's usefull if you are have several rooms of the same type or several seats for some place or any other service or properties, where is need to have possibility to book several times for the same date. So at these versions are possible to set capacity of the booking resource, so date(s) in calendar will be available until number of reservations is less then capacity of the booking resource; but in these versions are possible to make reservation only for FULL date, not a time slots (time slots in this version only record data in DB, but not play any logic in reservation) for the booking resources with specific capacity.
Configuration
If you are need to configure the booking resource(s) with some capacity, so you are need to add the "child" resources to your "parent" resource at the top form of Booking > Resources admin page. 
Just create one resource, and then create several child resources (set parent resource for them as a first resource), so the capacity of the first resource will increase.
Capacity it's number of times, which is possible to reserve the same date in calendar, based on number of selected visitors in the booking form. Resource its more like room, where is possible to be several seats for the visitors. 

Here is examples of different configuration of capacity settings.

The availability (number of seats/maximum amount of people ) can be calculated only based on the "visitors" shortcode (shortcode

[select visitors "1" "2" "3" "4" "5"]
in the Booking > Settings > Fields page at top form ). Its can not calculate availability based on the adults or children shortcodes.

You need to activate "Set capacity based on number of visitors" option at the general booking settings page at advanced section. After that you will see the maximum number of visitors at the Resources page.

Also you can read more here: http://wpbookingcalendar.com/help/booking-resource/

Let say you are having booking resources like this:

test   (parent resource, capacity = 3)   Max. visitors = 2
- test 1
- test 2

A) If you are do not activate the "Set capacity based on number of visitors" so then, during reservation process you will book only ONE available booking resource, do not depend from the any number of visitors selections in the "visitors" select box. So it's mean if you are select 1 or 2 or 5 visitors in the select box at the booking form, you will reserve only one booking resource (firstly its will be parent resource "test", during the next new (second) reservation it's will be child resource "test 1" and during third reservation you will reserve "test 2" booking resource.
If the "Set capacity based on number of visitors" is not checked, the availability for the specific date will be 3 (based on capacity only) and during reservation process the selection number of visitors will not impact to the Availability and just will be saved as a any other field.

B) If you will set checked the "Set capacity based on number of visitors" option and activate first radio button in sub settings:

Add tooltip on calendar(s) to show availability based on the number of available booking resource items remaining for each day.
Note: Be sure to match the maximum number of visitors for the one booking resource with the number of visitors specified on the booking form.

Then the Availability in the mouse over tool-tip will be based on the capacity of the booking resource. So it's mean that for the free dates the availability will be show as 3, as in our previous example.

But during reservation process, you can not select more than 2 visitors in the select box. Because each booking resource, is support only 2 visitors per resource.

In other words, during reservation process you can reserve only 1 booking resource during one reservation, but the system is also check that the number of visitors, which you are selected in the booking form have to be not more then maximum number of visitors, which you are set at the Booking > Resource page. The availability in mouse over tooltip will be based on the capacity and in out example will be show as 3

C) And now last variant, if you had selected the bottom radios button option:

Display tooltip on calendar(s) to show availability based on total (fixed) number of visitors for the resource, which can be at free booking resource items.
Note: Be sure to match the maximum number of visitors for all booking resources with the number of visitors specified on the booking form.

So it's mean that availability over the specific date will be based on the capacity and number of maximum visitors per resource. In our example it's will be show as 6 ( 3 * 2 = 6 ).
During reservation process the system can book several booking resources, it's will calculate the visitors, which you are select in the booking form for the each booking resource (parent or child) and number of visitors per this resource.

So for example if you are select 3 visitors in the booking form. It's will reserve 2 booking resources. Because first resource is support 2 visitors and second is support also 2 but we are have only 1 ( 3 - 2 = 1 ), in other words one bed will be free in the second resource.

How all this capacity concept is working for search availability in search form at front-end side ?

You can test search form in action at the live demo of Booking Calendar Business Large version.

During searching availability in search form, number of selected visitors (shortcode [search_visitors] in the search form at Booking > Settings > Search page), can work in several ways. It's depend from selected or do not selected option: "Set capacity based on number of visitors" at the General Booking Settings page in advanced section and selected additional parameters.

A) If "Set capacity based on number of visitors" option UNCHECKED (not selected), then search availability form will search for available booking resources only based on the Check In/Out dates and possible some other parameters, but its will not depend from the selected number of visitors.

You can select any number of visitors and its will show items in search results, if other parameters (check in/out dates and possible some other parameters fit to selected options in search form).

B) If "Set capacity based on number of visitors" option CHECKED and you activated this sub option:

Add tooltip on calendar(s) to show availability based on the number of available booking resource items remaining for each day.
Note: Be sure to match the maximum number of visitors for the one booking resource with the number of visitors specified on the booking form.

Then during search process, the number of visitors (selected in the search form) must be equal or less then maximum number of visitors per booking resources (that you set at the Booking > Resources page). Its does not depend from the number of available "child booking resources", if the booking resource was configured with specific capacity (have child booking resources) and this booking resources (or at least one child booking resource) have available dates that you are searching.

C) If "Set capacity based on number of visitors" option CHECKED and you activated this sub option:

Display tooltip on calendar(s) to show availability based on total (fixed) number of visitors for the resource, which can be at free booking resource items.
Note: Be sure to match the maximum number of visitors for all booking resources with the number of visitors specified on the booking form.

Then during search process, the number of visitors (selected in the search form) must match the maximum number of visitors for all booking resource. Its means that availability per booking resource calculated as number of maximum visitors per resource multiply on capacity of booking resources (number of child booking resources). If we are having booking resource with capacity 3 (2 child booking resources), and maximum number of visitors as 2. Then maximum availability = 2 * 3 = 6 And its means that, if we selected 6 visitors in the search form we fit to get this booking resource in search results. If we select more than 6 visitors, then we do not match this criteria and this booking resource will not show in the search results.

How to configure for visitors editing / canceling their exist bookings or receiving link to payment form?

1) Firstly, create a new post or page, and insert into content of the page this shortcode:

[bookingedit]

You can just click at the booking button at edit toolbar and then at popup dialog select second tab for inserting this shortcode or just write manually it. Publish or update page and COPY the URL to this page.

Important! Please note, if you open this page directly, you will see this warning "You do not set any parameters for booking editing". It's because system allow to open this page only from link(s) in email templates, which your website visitor had to received, after he/she made the booking (inside of that link will be specific parameter (secret HASH) for the identification of the booking).

2) Now, open the general booking settings page and at the "Advanced section" for field: "URL to edit bookings" write (paste) the URL to the page from point #1. Save the changes of this settings page.

3) Open Booking > Settings > Emails page and inside of email template(s), where it's possible (you can check it at help section under the each email template), you can use these shortcodes (for the inserting links into the email templates), which are sending to the visitors:

[visitorbookingediturl]
- inserting link of booking editing by visitor at client side of site,
[visitorbookingcancelurl]
- inserting link for booking cancellation by visitor at client side of site,
[visitorbookingpayurl]
- inserting link to payment page for visitor at client side of site.

4) You can test it for a new bookings.

Initial configuration of MultiUser version

The Booking Calendar MultiUser version have 2 types of the users: super booking admin and usual user.

The "first" WordPress admin user by default is "super booking admin" user.

So, firstly after activation of the plugin you have to see the booking panel for that user.

Then you are need to open the "general booking settings" page (this page is available only for the super booking admin users), then expand the User settings section at the right side and set the correct permissions (user roles) for the pages of the booking admin panel. Its required for the new wordpress users possibility to open the admin booking admin panel.

Now, you can create new wordpress user (the role of this user have to be higher or equal to the roles, which you are set at the previous step).

Now, you are need to open the Booking > Settings > Users page (you are have to be logged in as booking super admin user) and make activation of the booking admin panel for the new wordpress user.

Finally, you can log in as new wordpress user, and you will see own booking admin panel for this user. You can create new booking resource(s), configure the settings and insert the booking form(s) of this user into posts or pages, which is created by this user.

Where to change the currency at the settings ?

At the Business Small and higher versions of Booking Calendar are supported several payment systems integrations.
Each payment system support own list of currencies.
So you can change and check the list of the currency at the Booking > Settings > Payment page at the each section of payment system integrations.