If you are looking for how-to tutorials, refer to the documentation.
Booking Activities will always work on a clean installation (no plugin, WordPress default theme). We are also doing our best to make sure Booking Activities will be working, or at least can work in any circumstances. But WordPress has a lot of plugins and themes that may interfere and cause issues. Depending on their combination, the problems can come from anywhere. Here are some frequently asked questions and their answers to help you troubleshoot.
Booking Activities only works with PHP 5.3 or later, MySQL 5.6 or later, WordPress 3.6 or later (and WooCommerce 3.0 or later if you use it).
Make sure Booking Activities and its add-ons are up to date. You can check the add-ons’ version on their product page, and Booking Activities’ version on its wordpress.org page.
You have read the documentation, seen screenshots or watched a video of Booking Activities, and something doesn't work as intended.
This may be due to a conflict with a plugin or with your theme.
Here is how to know what plugin is causing the issue:
- Deactivate all plugins except Booking Activities and its add-ons (and except WooCommerce if you use it)
- Reproduce the problem
- See if it works
If it works:
- Reactivate your plugins one by one
- Between each activation, reproduce the problem
- If the problem occurs after you activate a specific plugin, the conflict come from this plugin
If it doesn't work:
- Download and activate Twenty Twenty-Three theme (WordPress basic theme)
- Reproduce the problem
- See if it works
If it works, the conflict come from your theme.
If it still doesn't work, please contact us and give use these information:
- The URL of the page where the problem occurs (if online and available)
- Your WordPress, Booking Activities, and PHP versions
This issue can have a lot of sources, you need to check them all until you find yours. First, let's make sure this is not a technical problem.
Do you have a javascript error?
- Open your browser's console
- Refresh the page where the your calendar is and go to a view where your events are supposed to appear (e.g.: from January 1st to January 7th)
- See if an error appears in the console
If this is the case, it may be due to a conflict with a plugin or with your theme. Please refer now to "Booking Activities doesn't work as it should" section in this FAQ.
Does your CSS hide events?
- Try to switch between view types (monthly, weekly, daily) and see if your events appear
- Go to a view where events should appear (e.g.: from January 1st to January 7th), open your browser's inspector (usually F12), search for "
a.fc-event
" in the html code (CTRL+F). Double check that your search is made in the page source code, not in the page itself. See if your events appear in code
If you can see your events during this check, then your theme is using a specific CSS that prevent the events to be displayed. You need to identify and fix it in your child theme.
Booking Activities has a lot of availability options, which is great when you mastered them all, but can cause you trouble if you don't understand why your events don't appear on your calendar. Let's reset these options one by one to understand where the problem come from.
Do the "Calendar" field filters contain your events?
When you create a form, it is empty by default. Or, if you create it from the calendar editor, it will include by default the events currently displayed on the current calendar. Then, if you add an activity, a group of events, or even a calendar, the form calendar WON'T be automatically updated. Each form calendar has its own settings, and its own sources of events.
- Go to Booking Activities > Booking Forms
- Select the desired form
- Click on "Calendar settings"
- Click "Show advanced options"
- In the "Filters" tab, make sure that the desired calendars and activities are correctly selected
- You can make a multiple selection with the "plus" icon next to the selectbox, then select the desired items with CTRL + Click
- Disable the "Groups only" option
- Disable the "Reserved only" option
- Validate the dialog
Are your events at a future date?
Booking Activities only display future events compare to your timezone.
- Go to Booking Activities settings, "General" tab
- Make sure you have set up your own timezone in "Calendars timezone" option
- Unckeck both "Are started events bookable?" and "Are started groups of events bookable?" options
- Go to the calendar editor and make sure your events are at a future date
- In you calendar settings, "General" tab, make sure your events are between your Opening and Closing dates
- Go to your booking form editor, in the calendar field settings, "Availability" tab, show the advanced options, make sure your events are between your Opening and Closing dates
- Refresh the page where the your calendar is and go to a view where your events are supposed to appear (e.g.: from January 1st to January 7th)
Are your events in the availability period?
Booking Activities features a rolling availability period.
- Go to your booking form editor, in the calendar field settings, "Availability" tab
- Empty both "At the latest" and "At the earliest" options
- Empty the "Opening" and "Closing" options
- Turn OFF the "Past events" option
- Validate the dialog with the "OK" button
- Refresh the page where the calendar is and go to a view where your events are supposed to appear (e.g.: from January 1st to January 7th)
- If it still doesn't work, try to validate the dialog with the "Reset" button
Are your activities restricted to certain user roles?
You can select which user roles are allowed to book your events. If you select at least one user role, no other user, including whom non logged in, will be able to see these events. Then, if you want to make your activity available for everybody, you need to select no role.
- Go to the calendar editor, in your activities settings, "Permission" tab, and unselect all roles (Use CTRL+Click)
- If you have grouped your events, also unselect all roles in your group categories settings
- Refresh the page where the your calendar is and go to a view where your events are supposed to appear (e.g.: from January 1st to January 7th)
Is your shortcode / WooCommerce integration correct?
- Go to your booking form editor, in the calendar field settings, "Filters" tab, and show the advanced options
- Select the desired calendar and activity
- In the "Group category" selectbox, choose "None"
- Turn off the "Groups only" option
- Turn off the "Booked only" option
If you are not using WooCommerce:
- Copy the shortcode in the "How to integrate this form" box in the form edition page and paste it in the "Text" tab of any post / page you like
- Make sure that all the quotation marks are straight
'
and replace them if they are not. You can also use double straight quotation marks"
instead
If you are using WooCommerce:
- In the "Product data" area, "Activity" tab, make sure you have selected the desired form. If you are using variations, check that you have selected the desired form in every variation.
Finally, refresh the page where the your calendar is and go to a view where your events are supposed to appear (e.g.: from January 1st to January 7th)
You have tried everything, and nothing works... Please follow the instructions under "Booking Activities doesn't work as it should" section in this FAQ.
If you need to contact us, you must include the following information in your email:
- An administrator access to you website (or a to a development website where the problem occurs)
- Make sure that the Plugins > Plugin Editor is working
- The URL of the page where the calendar is displayed
In posts or pages, you need to use the shortcode given in Booking Activities > Booking forms.
In WooCommerce product pages, you need to configure you WooCommerce product as mentionned in the documentation.
Your calendar must have an event available at a future date, else it will display an error message "No events available".
If nothing appears at all, it is probably because of a javascript error.
- Open your browser's console
- Refresh the page where the calendar should appear
- See if an error appears in the console
If this is the case, it may be due to a conflict with a plugin or with your theme.
- Deactivate all plugins except Booking Activities (and except WooCommerce if you use it)
- Refresh the page where the calendar should appear
- See if the calendar appears
If it works:
- Reactivate your plugins one by one
- Between each activation, refresh the page where the calendar appears
- If the calendar disappear after you activate a specific plugin, the conflict come from this plugin
If it doesn't work:
- Download and activate Twenty Twenty-Three theme (WordPress basic theme)
- Refresh the page where the calendar should appear
- See if the calendar appears
If it works, the conflict come from your theme.
If it still doesn't work, please contact us and give use these information:
- A screenshot of the error in the console
- The URL of the page where the calendar should appear (if online and available)
- Your WordPress, Booking Activities, and PHP versions
This is probably due to a conflict with another plugin or with your theme.
First, let's restore your WP admin access.
- Go to your WordPress installation directory
- Open
wp-content
directory - Rename
plugins
directory to_plugins
Now you can access your admin panel.
- Go to your admin panel
- Rename the
_plugins
folder back toplugins
- On you website admin panel, go to "Plugins" tab
You will seee that all your plugins are deactivated.
Now we need to know where the conflict come from.
- Activate Booking Activities first
- Refresh the current page
If you have still access to your admin panel:
- Reactivate your plugins one by one
- Between each activation, refresh the current page
- If you loose access to your admin panel while activating a specific plugin, the conflict come from this plugin
If you are ejected from your admin panel:
- Re-do the first operation to access it again.
- Download and activate Twenty Twenty-Three theme (WordPress basic theme)
- Activate Booking Activities
If you can access to your admin panel, the conflict come from your theme.
If you are still ejected from you admin panel, please contact us and provide us these information:
- Your WordPress, Booking Activities, and PHP versions
Booking Activities cannot be compatible with all themes and plugins.
If you encounter a problem with Booking Activities and if it happens to be a compatibility issue (see "Booking Activities doesn’t work as it should" FAQ), please tell us at contact@booking-activities.fr.
Here is a list of third party plugins having known compatibility issues with Booking Activities.
This list is based on users feedbacks, it has not been verified.
Plugin | Report date | Comment |
---|---|---|
Essential Addons for Elementor | 2019-01-14 | This plugin can be active but the sure must make sure that the following features are switched off: Twitter Feed & Facebook Feed |
Simple Calendar | 2018-12-01 | JS error when clicking an event on frontend |
Simple Calendar – Google Calendar Plugin | 2020-03-05 | JS error when clicking an event on frontend. You can try that workaround. |
WP Event Manager | 2019-05-15 | JS error on backend. Go to Event Listing > Settings > General, Uncheck the "Enable bootstrap for the backend" option. Save settings. Now it should work. |
Modern Event Calendar | 2022-09-01 | JS error on the frontend (calendar not loading). The plugin loads its own version of FullCalendar. Author contacted. |
Wp Hotel Booking | 2022-12-06 | JS error on the backend. The plugin loads its own version of Select2 and FullCalendar. |
WP Download Manager | 2021-06-01 | Prevents making multiple bookings |
Cache Enabler | 2019-03-27 | Doesn’t work with “Cache Minification” on “HTML & Inline JS”. Choose either “HTML” or “Disabled”. |
Flying Scripts by WP Speed Matters | 2020-08-28 | |
FlyingPress | 2022-09-05 | Calendar not displayed (js error). |
EasyTimetable | 2021-01-05 | |
Tutor LMS | 2021-05-11 | Error: No events selected. |
WooCommerce Deposits (by Webtomizer) | 2019-08-27 | Add this line of code in your child theme functions.php to make it work: add_action( 'woocommerce_order_status_pending_to_partially-paid', 'bookacti_wc_update_completed_order_bookings', 5, 2 ); |
Smart Coupons for WooCommerce (by WebToffee) | 2022-02-27 | PHP error when refunding a booking with a coupon. |
Conditional Discounts for WooCommerce (by Orion) | 2022-03-03 | Incorrect cart item price if the price is already set by Prices and Credits or Advanced Forms add-ons. |
WP Travel Engine | 2020-09-08 | Conflict with the select2 library |
LaunchFlows | 2022-09-10 | Not compatible with "Add a product to cart" form action. JS error when the booking form is sent (Setup: Unfinished Auction). |
OSM – OpenStreetMap | 2022-09-19 | AJAX error when clicking "Click here to create a booking form with this calendar" in the Calendar editor. |
Sydney (theme) | 2019-03-27 | Booking forms don't appear on WooCommerce variable products pages. Add do_action( 'woocommerce_before_add_to_cart_button' ); in wp-content/themes/sydney/inc/woocommerce.php line 92 to fix this issue. |
Jupiter X (theme) | 2019-04-20 | Booking forms don't appear on WooCommerce variable products pages. Add do_action( 'woocommerce_before_add_to_cart_button' ); in wp-content\themes\jupiterx\lib\templates\woocommerce\single-product\add-to-cart\variation-add-to-cart-button.php line 17 to fix this issue. |
SalesZone (theme) | 2019-06-07 | Doesn't work with variable products. |
Please report your plugins or themes conflicts (or how to solve them) at contact@booking-activities.fr
Booking Activities is fully translated into English and French. You can translate it into any another language, or customize an existing translation.
For multilingual sites, you can translate your custom texts with WPML or qTranslate-XT.
If you are using the Notification Pack add-on and the SMS or the Push notifications are not working, please follow the instructions in the documentation carefully (sms install, sms setup, push install, push setup). There are a lot of traps, so please take the time to follow each step and to double check your configuration.
If you are not receiving the e-mail notifications, the problem can have a lot of sources, you will need to make the following tests until you find yours:
Is the sender email address known by your SMTP server?
- In your admin panel, go to Booking Activities > Settings > Notifications
- In "From email" option, set a real email address, known by your SMTP server
- Put an email address that you have created at your webhost (except if you use a plugin to use another SMTP server)
- Save changes
If the sender is properly configured and it's still not working, proceed to the next test.
Do notifications work when they are not deferred?
In order to perform this test you need:
- To make a reservation with your account (your email address)
- To configure and activate the "Booking status turns to "Cancelled"" email notification sent to the customer
- In your admin panel, go to Booking Activities > Settings > Notifications
- Turn OFF the "Asynchronous notifications" option
- Save changes
- Go to Booking Activities > Bookings and find your booking
- Click on the "Edit" button () in the "Actions" column
- Change the "Booking state" to "Cancelled"
- Turn ON the "Send notifications" option
- Validate the dialog with the "OK" button
- Check your inbox and your spams and look for the cancellation notification email
If you have received that email, it means that the problem occurs at the WordPress Cron level. This may be due to a plugin conflict, follow the steps under "Booking Activities doesn't work as it should" section in this FAQ. Moreover, if your website is under HTTP Basic Authentication, the WordPress Cron cannot work, here is a workaround.
If you have not received that email, proceed to the next test.
Do other emails sent by WordPress work?
- In your admin panel, go to Users > Add new
- Set the username, and a real email address that you can check the inbox
- Tip: if you have a gmail address like myaddress@gmail.com, you can use myaddress+test@gmail.com (or
+anything
)
- Tip: if you have a gmail address like myaddress@gmail.com, you can use myaddress+test@gmail.com (or
- Check the box: "Send User Notification"
- validate with the button "Add new user"
- Check your inbox and your spams and look for the WordPress welcome email
If you have received that email, proceed to the next test.
If you haven't received that email, it probably means that the problem occurs at the SMTP server. You can try to use another SMTP server with a plugin like WP Mail SMTP. If it is working with another SMTP server, contact your webhost to report the problem. Moreover, some plugins may change the wp_mail function (used by both WordPress and Booking Activities to send emails). In order to make sure that the problem doesn't come from another plugin, follow the steps under "Booking Activities doesn't work as it should" section in this FAQ.
Are your notifications properly configured?
- In your admin panel, go to Booking Activities > Settings > Notifications
- In the table of available notifications, click on the desired notification to access its settings
- Turn ON the "Enabled" option
- With the Notification Pack add-on, you need to turn ON the "Enabled" option in the "Global notifications settings" AND in the "Email notifications settings"
- If the notification is sent to an administrator, set the "Recipient(s)" field to an existing email address that you can check the inbox
- Make sure the email notification "Subject" and "Email content" are not empty
- Save changes
- Go back to Booking Activities > Settings > Notifications, and make sure there is a green tick () in the "Active" column of the desired row
- With the Notification Pack add-on, check if there is a green tick () in the "Email" column too
If your notification is properly configured and it's still not working, proceed to the next test.
Do you exceed the sending limits?
Booking Activities limits the number of notifications sent to the same recipient to prevent your server from being identified as a spam mailer. Here are the limits not to be exceeded:
- An asynchronous notification cannot be sent twice exactly (strictly) in less than three minutes
- 20 emails per minute per recipient
- 200 emails per hour per recipient
- 2000 emails per day per recipient
If you do not exceed these restrictions, make the following test.
If you think you exceed these limits, you can add this code to your child theme functions.php
in order to remove these restrictions:
add_filter( 'bookacti_limit_email_per_minute_per_user', function() { return 999999999; } );
add_filter( 'bookacti_limit_email_per_hour_per_user', function() { return 999999999; } );
add_filter( 'bookacti_limit_email_per_day_per_user', function() { return 999999999; } );
You have tried everything, and nothing works... Please follow the instructions under "Booking Activities doesn't work as it should" section in this FAQ.
If you need to contact us, you must include the following information in your email:
- Your WordPress, Booking Activities and PHP versions
You have purchased a Booking Activities' add-on on this site but you are not correctly receiving its automatic updates.
Please follow all the instructions until the end, they necessarily lead to the resolution of the problem.
Prerequisites:
- You have installed the Licenses and Updates add-on,
- You have activated your add-on license key from your site (in Booking Activities > Settings > Licenses tab),
- Your license key is valid (it is not expired),
- You have verified your add-on latest version on its product page
If you still don't receive the updates, or if an error occurs during the update, it probably means that the license key is not correctly bound to your site. Follow each steps below to solve the issue:
- Deactivate your license key from your site
- Go to your site admin panel > Booking Activities > Settings > License tab
- Click on "Deactivate License"
- If it doesn't work, or if you don't have that button, click on the icon ( or ), a dialog will appear to offer you to check the license status, validate it with the OK button
- Refresh the page, and make sure that the license key is now deactivated, else click on "Deactivate License" again
- Deactivate your license key from booking-activities.fr
- Go to booking-activities.fr > My Account > License Keys
- Click on Manage Sites
- If a domain name is in the table, click on "Deactivate site"
- Refresh the page, make sure that the table is empty
- Activate your license key from your site
- Go to booking-activities.fr > My Account > License Keys
- Copy your license key
- Go to your site admin panel > Booking Activities > Settings > License tab
- Paste your license key in the corresponding add-on field
- Click on "Activate License"
- If it doesn't work, follow the instructions given in the error notice
Try to update the add-on again, if the update doesn't come up or if it fails again, go to the next step.
- Go to your site admin panel > Updates
- Click on the "Check Again" button
- Wait up to 5 minutes and try again
Try to update the add-on again, if the update doesn't come up or if it fails again, go to the next step.
We can fix the problem for sure by manually doing the same thing that Wordpress does automatically. There is no risk of losing your data and settings because they are stored in your database, not in the files.
- Go to booking-activities.fr > My Account > Downloads > Download your up to date add-on
- On your site admin panel, go to Plugins > Add new > Upload plugin > Choose file: select the .zip file you just downloaded > Install now > Replace current with uploaded
Your add-on is now up to date. Make sure to always update it at the same time as Booking Activities when updates are available. If you encounter the same problem with the next update, follow the same instructions above.