Next File Manager 6.1.0: share links, Trash, a phone app and a Health check Next Exams 6.3.0: exam parts, scaled scores, listening and speaking tests Next Restaurant 6.1.0: move your data in, run payroll, and connect other systems Next Inventory 6.2.0: a REST API and webhooks for your other systems Next DB 6.1: Auto-Updating Tables, Printing, Phone Layout and SEO Next Task 6.0.0: a task manager for Joomla
NextSoftware

Scheduled tasks

Much of what Next Self-Catering does happens in the background: freeing unpaid holds, sending emails, charging balances, reading channel calendars, running automations. This work is done by Joomla's own Scheduled Tasks, through the Task - Next Self-Catering plugin that comes with the package.

If emails never arrive, holds never expire or balances are not charged, the cause is nearly always here.


The tasks

The installer creates 14 tasks. Open System > Manage > Scheduled Tasks to see them.

Joomla's Scheduled Tasks list filtered to the Next Self-Catering tasks, with their type, last run and next run

Task Runs Does
Expire booking holds Every 5 minutes Expires unpaid bookings past their hold, and booking requests nobody answered in time, and frees their nights
Send queued emails Every 5 minutes Sends queued emails, text messages, cleaner notices and webhooks, and retries failed ones
Sync channel calendars (iCal) Every 15 minutes Reads the Airbnb, Booking.com, Vrbo and other calendars set on each property and blocks their dates. Each calendar is read at most every 10 minutes
Automations Every 15 minutes Runs the automations whose moment has come
Automatic balance charges Hourly Takes balances that have fallen due from the cards their guests agreed to save
Damage deposit card holds Hourly Places the card holds guests agreed to near the end of their stay, and lets them go once the inspection is over
Arrival details for guests Hourly Emails each guest their booking page when its arrival details open
Housekeeping schedule Hourly Keeps cleaning jobs in step with bookings and imported calendars for the next 90 days, emails housekeepers about new and changed jobs, and deletes inspection photos never filed within 24 hours
Make image sizes Hourly Makes the smaller AVIF, WebP and JPEG/PNG copies of property photos still waiting (up to 50 per run), and removes copies no longer used
Balance reminders Every 6 hours Reminds guests of a balance falling due, once per booking
Refresh the search index Every 6 hours Rebuilds and rolls forward the availability the property search reads
Owner statements Daily Drafts last month's owner statements from the statement day of the month on, and refreshes them until they are finalised
Exchange rates for display currencies Daily Reads the European Central Bank's reference rates. A failed read keeps the last rates
Privacy retention Daily Clears guest details once the retention period has passed. Does nothing while the period is 0

Each task's title starts with "Next Self-Catering - ". Bookings and changes in the admin update the search index and the housekeeping schedule straight away; those tasks repair anything missed.

The tasks of the Guest portal, iCal sync, Housekeeping, Owners and Multi-currency apps do nothing while their app is switched off. A public demo site also has a Reset demo data task; it does nothing on any other site.

If a task is missing, reinstall the package over the top: the installer creates the missing Next Self-Catering tasks again. Uninstalling the package removes them.


Making sure the scheduler runs

Creating the tasks is not enough: something has to start Joomla's scheduler. There are two ways, set under System > Manage > Scheduled Tasks > Options.

Method How it works Good for
Lazy scheduler Visits to the site start the tasks. On by default in Joomla Sites with steady traffic. On a quiet site, tasks run late or not at all at night
Web cron or a server cron job The server calls the scheduler on a timer, visitors or not Reliable timing. Recommended, so a balance due at night is still charged

A server cron job that runs every minute looks like this:

* * * * * php /path/to/your/site/cli/joomla.php scheduler:run

Use the PHP binary your site runs on (8.1 or newer), and the real path to your site.


Checking that it works

  • In the Scheduled Tasks list, the Last Run of each Next Self-Catering task should be recent.
  • To run a task at once, select it and use Joomla's Run Test button.
  • Configure > Emails > Sent and queued shows whether emails leave the outbox.

The other plugins

The package also installs and enables these plugins. Keep them enabled.

Plugin Purpose
Privacy - Next Self-Catering Adds guest data to Joomla's Privacy export and removal requests
Smart Search - Next Self-Catering Indexes properties for Joomla Smart Search
User - Next Self-Catering Keeps guest, owner and housekeeper links right when a Joomla account's email changes or the account is deleted
Payment and SMS plugins Stripe, PayPal, Bank transfer, Twilio and HTTP gateway. Switch them off in the App Manager, not in Joomla's plugin manager

See also

All Extensions