This article is to help assist when classes aren't appearing available using the aXcelerate WordPress Integration Plugin on your WordPress Website.
A Workshop Isn't Appearing Online
For a workshop instance to display, there are a number of items it must adhere to:
- Confirm a filter has not been applied to exclude the specific workshop from display
- The workshop start date/time is not in the past. A workshop with a past start time will appear within the Past tab rather than the Current/Future tab. This includes the first day of a multi-session workshop.
- The Workshop Type has both Web Outline accessible and Display in Bookings Calendar ticked.
- The list is filtered by a specific domain, which the workshop hasn't been assigned.
- The list is filtered by a specific training category, which the workshop type isn't part of.
- There's no value set in the Close Days field that makes the enrolment closure in the past.
- Website Caching (See below)
A Class Isn't Appearing Online
For a class instance to display, there are a number of items it must adhere to:
- The Class end date is not in past. Classes will still allow enrolments past the start date, as long as the end date isn't in the past.
- The Qualification of the class has Display Web Outline ticked.
- The class has the Scheduled activity start and end dates apply to all Learners unticked. When this option is ticked, it will enforce the students enrolment to start and end on these dates, so when the date is in the past, it won't be available for enrolment.
- There's no value set in the Close Days field that makes the enrolment closure in the past.
- The list is filtered by a specific domain, which the class hasn't been assigned.
- The list is filtered by a specific training category, which the workshop type isn't part of.
- The Program - Newer than setting found within the WordPress plugin is greater than the age of the class. To locate this setting, login to your WordPress site, aXcelerate Integration Plugin, Course Instances, Program - Newer than. By default, this option is set to 6 months. Classes older than 6 months will not show for enrolment.
- Website Caching (See below)
A Workshop Type or Qualification Isn't Appearing Online in a Course List
If you are finding that you course list isn't displaying a particular Qualification or Workshop Type, here are some things to look for:
- On a Qualification, check to see if the "Display Web Outline" box is ticked.
- On a Shortcourse Type, check to see if the "Web Outline Accessible" and "Display in Bookings Calendar" are both ticked.
- If you are finding that only Qualifications or Workshops Types are showing, but not both, it could mean the shortcode on the page has a filter to only show one and not the other. Finding the shortcode on the WordPress website may show that the course_type=w (for workshops) or course_type=p (for programs/qualifications) when it could be course_type=all.
- If one or more are missing from your course list, it could also mean a Training Category filter is applied. Try add the Workshop Type or Qualifications to the training category filtered on the page.
Website Caching
Website caching is a technique used to store copies of web pages, images, and other content temporarily so that they can be accessed more quickly by users. The main purpose of caching is to reduce server load, speed up page load times, and improve the overall user experience by delivering content faster. When a user visits a website, cached versions of the content are served instead of generating it from scratch each time, which saves time and resources. This can cause issues for when you want to show the course availability in real-time. Because each website is unique, it can make it difficult to troubleshoot and can require logging into your website to diagnose.
Warning:We strongly recommend reaching out to your web developer to assist in this to avoid site disruption.
- Look for caching plugins. Some notable plugins that can cause courses to not display instantly are WP Rocket, Litespeed Cache, WP-Optimise. The plugin usually has an option to purge the data which would result in a temporary fix. For a long-term fix, ensure that the course pages is marked non-cachable or consider removing the plugin.
- Server-side Caching. Beyond plugins, caching can also occur at the server level, before a visitor even reaches your website. This type of caching is highly effective for performance but can also prevent real-time information from displaying correctly. We would recommend reaching out to your web developer for assistance as this would require a higher level of access.
Troubleshoot the Events Calendar integration
The plugin can add workshops and classes from aXcelerate as events in The Events Calendar plugin. It doesn’t do this in real time: scheduled WordPress tasks (cron jobs) fetch course instances from aXcelerate every hour, then create, update and remove events in batches. Most cases of missing events come down to timing, the scheduled tasks not running, or a setting that filters the course out.
Axcelerate Integration Plugin
The Events Calendar
Regular updates
Workshops and classes are each fetched from aXcelerate once an hour. A new or changed course instance can take up to an hour to appear in the calendar.
After turning the integration on
Workshops are first fetched after 10 minutes and classes after 20 minutes, then every hour after that.
Large calendars
By default, events are created 20 at a time, one batch a minute. For example, 200 new events take around 10 minutes to appear after each fetch.
Removed or closed instances
Events for instances that are no longer returned from aXcelerate are removed about 20 minutes after each fetch.
Tip: If you’ve just created or updated a workshop or class, wait at least an hour before troubleshooting.
Note: If The Events Calendar option doesn’t appear under the Axcelerate Integration Plugin menu, The Events Calendar plugin isn’t active. The integration only runs while that plugin is active.
Check why an event isn’t appearing
If an hour has passed and an event still isn’t in the calendar, check the course instance against the conditions below. The checks earlier in this article for workshops and classes also apply.
Integration turned off
Events Calendar Workshops and Events Calendar Programs are set separately. Check the relevant one is set to Event Calendar Integration Enabled.
Enrolment closed
Only instances that are open for enrolment are imported.
Dates out of range
Instances that have already finished aren’t imported. Workshops must have started no more than 1 month ago, and classes no more than 6 months ago.
Training category filter
If Workshop Training Category Filter or Qualification Training Category Filter is set, only courses in those training categories are imported. Add the Workshop Type or Qualification to the category, or clear the filter.
Full workshops
If Skip Full Workshops is set to Skip Full, workshops with no vacancies aren’t imported.
E-learning
E-learning courses aren’t added to the calendar. Only workshops and classes are.
Changes not showing on an existing event
By default, events aren’t updated once they’ve been created. To pick up changes to location, cost or time, set Update Existing Events to Update Events. This adds extra processing on your server, so only turn it on if these details change often.
Note: Website caching can also stop new events from showing. See the Website Caching section of this article.
Re-import all events
Turning the integration off and on again clears out the imported events and fetches them fresh from aXcelerate. Use this if events are missing, duplicated or out of date. Workshops and programs (classes) are set separately, so you can re-import one without touching the other.
- Set Events Calendar Workshops or Events Calendar Programs to Event Calendar Integration Disabled
- Click Save Changes
- Set the same option back to Event Calendar Integration Enabled
- Click Save Changes
- Wait for the events to be re-imported: about 10 minutes for workshops or 20 minutes for classes, plus time to create the events in batches
Note: This must be done in the Events Calendar settings. Deactivating and reactivating the aXcelerate plugin from the WordPress Plugins page doesn’t clear or re-import events.
Warning: Disabling the integration deletes every event it imported for that course type, including any manual edits made to those events. The calendar will have no workshop or class events until the re-import finishes.
Check the scheduled tasks with WP Crontrol
The WP Crontrol plugin lists the scheduled tasks on your website, so you can check the Events Calendar tasks are set up and run one straight away.
- Install and activate the WP Crontrol plugin
- Go to Tools > Cron Events
- Search for event_cal
- Check that the tasks below are listed, with a next run time
- To fetch events straight away, click Run now on event_cal_update_w or event_cal_update_p
event_cal_update_w
Fetches workshops from aXcelerate. Runs hourly while Events Calendar Workshops is enabled.
event_cal_update_p
Fetches classes from aXcelerate. Runs hourly while Events Calendar Programs is enabled.
event_cal_fetch_venues_v, event_cal_fetch_venues_l and event_cal_fetch_venues_dl
Fetch venues, locations and delivery locations. Run daily.
event_cal_process_instances_w and event_cal_process_instances_p
Process the fetched instances. Appear for about a minute after each fetch.
event_cal_create_instances
Creates events in batches of 20. Repeats every minute until all new events are created.
cleanup_invalid_events_w and cleanup_invalid_events_p
Remove events that are no longer valid or are duplicates. Run about 20 minutes after each fetch.
Tip: If event_cal_update_w or event_cal_update_p is missing, open The Events Calendar settings page and click Save Changes. Loading the page clears and recreates the scheduled tasks.
Note: WordPress only runs scheduled tasks when someone visits the website. On a site with little traffic, or where WordPress cron is turned off and replaced by a server cron job, tasks can run late or not at all.
Warning: Don’t delete or edit the plugin’s scheduled tasks in WP Crontrol. If tasks are overdue and not running, contact your web developer, as this usually needs server-level access to fix.