YITH Booking and Appointment:Premium version settings

Plugin calendar settings

Home > Premium version settings

From YITH > Booking > Settings > “Calendars” you are able to manage the settings for the calendars that are visible to you (admin) in the backend in Dashboard > Calendar.

Default time step in daily calendar: Decide to show the daily calendar in blocks of 1 hour, 30 minutes or 15 minutes.
Default start time in daily calendar: Decide the default start time of your calendar view.
Booking name in calendar will include: Decide which information is shown in the name of the booking in the calendar.

examples

Show booking ID and product name — Booking ID and product name

Show booking ID and user name — Booking ID and user name

Show booking ID, product and user name — Booking ID, product and user name

Show booking ID, user and product name — Booking ID, user and product name

External calendars

Home > Premium version settings

In YITH > Booking > Settings > “Calendars”, you can find these two options:

Calendar synchronization expires after: The minimum time for which the external sync is considered expired.
Show bookings of external calendars in plugin calendar: Enable to show external bookings in Dashboard > Calendar.

Example

If you set the first option to 30 minutes and synchronize a Booking product now (by contacting external services such as Airbnb or Booking.com), the loaded data will expire in 30 minutes.

So, if a customer checks the availability now, the plugin uses the loaded data as it is -still not expired-. After 30 minutes, the data will no longer be updated automatically, since it requires to be synchronized again.

If a customer checks the availability after 1 hour, the plugin will consider the data as expired and will update the external data to check the correct availability.

We recommend setting this option to a reasonable value to improve performance. Therefore, if you usually get a booking every 6 hours, you can set the “Calendar synchronization expires after” option, to 2 hours.
As a general rule, 30 minutes is a good sync expiration time for every Booking system.

Please note: Airbnb synchronizes external bookings every 2 hours.

For more information on synchronizing your calendars, please refer to this page here.

Google Calendar

Home > Premium version settings

Thanks to the integration with Google Calendar, the admin can view bookings on their own Google Calendar. The booking synchronization is one-way sync (from your site to Google Calendar).

You can configure the Google Calendar from YITH > Booking > Settings > “Calendars”.

First of all, you need to set Client ID and Client Secret as explained in the related section of the plugin.

After creating a project in https://console.developers.google.com/ and enabling Google Calendar API in Your Project -> Library, you need to create an OAuth Client ID for a Web application in Your Project and create your credentials.

When creating the client ID, select Web application in the Application type and enter a name. Then insert the link in the Authorized Redirect URLs.

After creat++ing your credentials, you need to copy the Client ID and Client Secret.

Now you need to add and save the credentials.

Now, you can have access to Google Calendar from the related plugin section.

You need to select the account that will be synchronized.

Click on the Allow button to proceed with the calendars management.

Now select the calendar on which you want to show all your bookings and save the options.

Google Calendar settings

In Google Calendar settings, you can find some new options:

Debug: when applying a debug, this will show in the plugin Logs section.
Synchronize: you can choose when synchronizing bookings for one or all of the following options:
- on booking creation
- on booking update
- on booking status update
- on booking deletion.
Add note on sync: if enabled, a private note will be added to the booking every time the synchronization with Google Calendar is applied.
Event name will include: Decide which information is shown in the name of the booking in the calendar. You can see some examples on this page here.

Actions

There are two kinds of actions that can be applied for booking synchronization:

Synchronize not synchronized bookings: this allows synchronizing those bookings that have never been synchronized.
Synchronize all bookings (Force): this allows forcing the synchronization of all the bookings available on the site.

Cart & Orders

Home > Premium version settings

From YITH > Booking > Settings > “Cart & Orders” you can manage the cart page and checkout page related to booking products.

Cart & Checkout

In this section, you can set up the following options:

Show “Booking of” text before product name on the Cart and Checkout pages: This can be useful in case you are booking an apartment or renting a car. Enabling this option prevents the doubt that you are actually buying an apartment or buying a car.

“Booking of” label: Decide the name of the label shown in the cart and on checkout.
Show totals in the cart and checkout: Enable to show a breakdown of the price in the cart and checkout page.

Orders

To show booking data in the order details both on the frontend and backend, in the order emails and wherever this data is used, you must enable the option Show booking data in order details.

Booking data on frontend — Booking data – Frontend

Booking data on backend — Booking data – Backend

The data is updated in real time when applying changes to the booking.

Price options

Home > Premium version settings

From YITH > Booking > Settings > “Customizations” you can set the booking form options.

The price shown will include: This manages how the price is shown on the shop page. You can decide to show:

Base price
Fixed base fee
Service costs (available if the Services module is enabled)
Extra costs (available if the Extra costs and discounts module is enabled)

You always have to select at least one option.

Base price example

Base price + Fixed base fee example

Base price + Extra costs example

Base price + Service costs example

As you can see in the examples above, when selecting either “Extra costs” or “Service costs” the option to show the price per day/week/month, is no longer available.

Show the price type: decide to show the price per day/month etc.

Replace ‘days’ with ‘weeks’: Decide to convert multiple of 7 days, as weeks.

Checkout page and read more button

Home > Premium version settings

From YITH > Booking > Settings > “Customizations” you can manage the colors and labels of the booking plugin.

Redirect users to checkout: Enable if you want to skip the cart, and redirect your users directly to the checkout page.
Hide “Read more” button in shop: Enable to hide the ‘read more’ button on the shop page.

Colors & font settings

Home > Premium version settings

From YITH > Booking > “Customizations” you can find the options to set the colors and the font size of the forms created by the booking plugin.

Colors: Choose the colors of all forms created by the YITH Booking plugin.

The “Primary” color, is the color most used (price, labels, quantity, button, checks, etc.) With the “Primary Light” color, you can select the color of the active selector in the calendar. The “Primary contrast” color refers to the contrast color of the Primary color selection, white in this case.

Fields’ font size: choose the font size for all fields included in the booking and search forms.

Labels options

Home > Premium version settings

In YITH > Booking > Settings > “Customizations” you can find all the labels you can edit.

Add to cart: Choose the text of the “Add to cart” label for bookable products.
Additional Services: Choose the text of the “Additional Services” label for bookable products.
Bookable: Choose the text of the “Bookable” label for bookable products.
Booking Services: Choose the text of the “Booking Services” label for bookable products.
Check-in: Choose the text of the “Check-in” label for bookable products.
Check-out: Choose the text of the “Check-out” label for bookable products.
Dates: Choose the text of the “Dates” label for bookable products.
Distance (Km): Choose the text of the “Distance (Km)” label for bookable products.
Duration: Choose the text of the “Duration” label for bookable products.
End date: Choose the text of the “End date” label for bookable products.
From: Choose the text of the “From” label for bookable products.
Included Services: Choose the text of the “Included Services” label for bookable products.
Location: Choose the text of the “Location” label for bookable products.
Not-bookable: Choose the text of the “Not-bookable” label for bookable products.
People: Choose the text of the “People” label for bookable products.
Read more: Choose the text of the “Read more” label for bookable products.
Request Confirmation: Choose the text of the “Request Confirmation” label for bookable products.
Services: Choose the text of the “Services” label for bookable products.
Start date: Choose the text of the “Start date” label for bookable products.
Time: Choose the text of the “Time” label for bookable products.
To: Choose the text of “To” label for bookable products.
Total people: Choose the text of “Total people” label for bookable products.

Please, note: some of the options, like the ones related to services or people, are automatically hidden if the related module is disabled. Make sure you enable the module from YITH > Bookings > Add-ons > Module.

Availability rules

Home > Premium version settings

From YITH > Booking > Configuration > “Availability rules”.

This section only needs to be used for ‘special rules‘ when you are not using default product rules.

We recommend using these rules as little as possible, instead, use the default rules on the product edit page. You can learn how to do so, here.

We explain the 2 availability rules that you can use, by using examples:

Specific date rule
Generic date rule

Specific date

Let’s say we want to close the store for the month of August in the summer of 2023. We will set that month as ‘not bookable’, except for Sunday mornings, that time we will accept bookings.

Rule name: Name for internal use only, we call it “Summer holidays 2023″.
Rule type – Specific date: We choose this option, because we want to set the dates only for a specific year (not every year).
Apply rule: Here we set the time period on which the rules will apply, August 2023 in this case.
Availability: All days during this period are not bookable, except for Sunday mornings, so we add an extra rule. We select Sunday and set it to ‘bookable’. Now we add hours because only during the morning our products are bookable. The lower rule always overrides the upper rule.
Exclude products: Enable this option if you want one or more bookable products to be excluded from the rule.

Generic date

Let’s say we want to make it impossible to rent our products during certain bank holidays, like during Christmas and some other days.

Rule name: Name for internal use only, so we call it “Bank holidays”.
Rule type – Generic dates: We choose this option because we want to disable the rent of our booking products each year.
Apply rule: Here we set the dates on which the rules will apply, in this case, it is the entire Christmas period and some separate days during the year.
Availability: During these days, it is not possible for customers to rent our products, we, therefore, set All days to ‘not bookable’.

Note: When setting rules for specific hours, this will not affect the daily bookings, these rules will only apply to booking products with time.

From the “Availability rules” overview page, you can see all your created rules, and you have the option to enable or disable them in 1 click.

You can override the rules you created on this page, per product on the product level.

Price rules

Home > Premium version settings

From YITH > Booking > Configuration > “Price rules” you can manage the global price rules of your store.

This section only needs to be used for ‘special rules‘ when not using default product rules.

We recommend using these rules as little as possible, instead, use the default rules on the product edit page. You can learn how to do so, here.

Setting a price rule

Rule name: Name for internal use only, we call it.
Conditions: Based on what you want to apply price rules:
- Custom date range
- range of months
- range of year’s weeks
- range of days
- people count
- duration unit
- time range
- people (kids, adults etc.).
  - from-to is a range of values, the “meaning” depends on the “Type” selection
    “Adult” -> from-to is a range of number of Adults (from 1 Adult to 5 Adults)
    “Custom date rage” -> from-to is a range of dates (from 1st Jan to 5th Jan)
    “Duration unit” -> from-to is a range of duration ( from 1 day to 5 days)
Rule changes the base price: The base price of the products is affected by the rule
Rule changes the fixed base fee: The rules affect the fixed base fee of the products.
When enabling any of the 2 above options, you can change the price
– increase the price by
– decrease the price by
– multiply the price by
– divide the price by
– set the price to
– increase the price as a percentage by
– decrease the price as a percentage by
Exclude products: Enable this option if you want one or more bookable products to be excluded from the rule.

You can override the rules you created on this page, per product on the product level.

Summer promo example

For our ‘Summer promo’ we have decided to give the customers a discount of 10% during the summer. We selected “Range of months” to indicate the summer season, and used the “decrease the base price as a percentage by” (- 10 %).

The product’s base price is set to $100 per day, and as you can see in the example below, the price has been discounted by 10% for the booking in July (summer season).