2.Core settings

2.1Google Project data

Once configured as per paragraph 1.3, the Google Project data in the Core settings should never be modified.


2.2.1Roles allowed to be Coworkers

As already seen in the Getting Started section, here you can configure which WordPress roles are allowed to be Service Providers (Coworkers).

Administrators are always allowed.

The non-allowed roles won't see any TeamBooking tab in their dashboards.

2.2.2Autofill reservation form fields for registered users

Depending on your WordPress membership configuration, it is possible that a registered user already provided some information in his profile, like e-mail address, first and last name, and so on.

If those fields are present in the reservation form, you can choose to pre-fill the data with the information fetched from the logged user profile, for customer's convenience.

You can also chose to pre-fill and hide those fields, so the customer is not able to modify the values.

2.2.3Load the frontend calendar at the closest month with available slots

If selected, the frontend calendar will be automatically loaded at the nearest month with at least one free slot. Please note: the first page loading can be a little bit slower.

This setting is global and it will be applied to all the calendar instances.

2.2.4Allow customers to download ICAL file after a reservation

By activating that option, a button to download an *.ICS (ICAL) file will be shown immediately after the reservation. You can also add the ICS link hook in the confirmation e-mail, so the customer can download the file from there.

2.2.5Registration and Login URL

When a guest tries to book a member-only service, a registration button and a login button will be shown. Here you can override the default WordPress registration and login URLs.

2.2.6Redirect the customers back to the calendar page after login/registration

Choose if the customer must be redirect back to the reservation page after login/registration process (when asked by those services allowed to registered users only)

Note: an eventual login redirect plugin may interfere with that.

2.2.7Keep reservations in database for

The reservations older than this timespan (relative to the reservation's starting date) will be deleted from the database.

2.2.8Max pending time

If the payment is not made within this timeframe, the reservation will be released. It affects only the services for which the payment must be done immediately.

Note: Values too low could, in extreme cases, lead to payments after reservation is released. Furthermore, in order to process an IPN confirmation from off-site payment gateways (like PayPal), your server must be up and running. PayPal example: if your server is down, IPN will be resent by PayPal for up to four days, with a maximum of 15 retries. The interval will increase after each fail attempt.

2.2.9Google Maps API key

If you have a Google Maps API key*, put it there. This is mandatory in order to use Google Maps for installations made after 22nd of June, 2016.

*The API key must have those API libraries enabled:

  • Google Maps JavaScript API
  • Google Maps Geocoding API
  • Google Places API Web Service
  • Google Maps Directions API (if you want the address autocomplete and the real-time directions feature)

Don't you have a Google Maps API key already? Just keep reading:

How to obtain a Google Maps API key

  1. Remember the Google Project you created for the Core configuration? Well, go back to the Google API console and open it.

  2. Click to Credentials and press the Create credentials button. Then choose API key.

  3. Click on Browser key.

  4. Choose a name for the key (e.g. "My Maps Key") in the first field, and insert the referrer in the second field.

    So, if your site is http://www.mysite.com, you should insert *.mysite.com/*.

    Then, press Create.

  5. Copy the key and press OK.

  6. Go to Overview and click on Google Maps JavaScript API.

  7. Press Enable.

  8. Repeat the last step for the Google Maps Geocoding API and Google Places API Web Service too.

    If you need the address autocomplete and the real-time directions features, repeat the last step also for the Google Maps Directions API too.

  9. Once the APIs are enabled, go back to TeamBooking's Core settings and paste in the Google Maps API key field the API key you copied before.

2.2.10Skip Google Maps library loading

Activate this option only if you know what you're doing.

If you have issues about double loading of Google Maps JavaScript library because of other maps library calls by your theme or by another plugin, you can bypass the TeamBooking's library loading.

By doing that, TeamBooking skips the Google Maps library loading, but every Google Maps eventual issue on the reservation form will be responsibility of the third-party theme/plugin which calls the Maps library first.

2.2.11Restrict continents in frontend timezone selectors

You can restrict the continents shown in the calendar's timezone selector. By default, all the continents will be shown. Uncheck the continents you want to hide.

The continents are:

  • Africa
  • America
  • Antarctica
  • Arctic
  • Asia
  • Atlantic
  • Australia
  • Europe
  • Indian
  • Pacific


2.3.1Import/Export of settings

You can import/export the TeamBooking settings in the relative panel.

Note: This is meant to pass the settings from one installation to another (e.g. going in production) or to restore the settings after a plugin uninstall/reinstall.

This is not meant to pass the settings between different versions of the plugin.

You do not need to do that after a plugin's upgrading.

You do not need to do that during a plugin's deactivation/reactivation.

2.3.2Repair database

If something doesn't behave as it should, especially after an update, try to hit that button. It performs a repair of the plugin's database.