Skip to content Skip to main navigation Skip to footer

CRON Events Setup

CRON events allow Chauffeur Taxi Booking System to run scheduled tasks automatically, including customer and driver reminders, driver acceptance processing, and booking removal. This guide explains how to configure the commands provided by the plugin in cPanel and how to check that they are running.

Good to Know

Each supported event has its own CRON command in the plugin settings. Copy the command from your installation, including its unique chbs_run_code value, rather than copying a sample command from this article.

Available CRON Events

The plugin uses the following events. Enable and configure the corresponding feature before scheduling its command.

Event Purpose Configuration
1 Customer pre-arrival reminder ‘E-mail’ -> ‘Reminders’
2 Driver pre-arrival reminder ‘E-mail’ -> ‘Reminders’
3 Customer post-arrival message ‘E-mail’ -> ‘Reminders’
4 and 5 Driver acceptance processing ‘Bookings’ -> ‘Driver Acceptance’
6 Automatic removal of eligible bookings ‘Bookings’ -> ‘Auto Removal’

You can find these sections in ‘Settings’ -> ‘Chauffeur Booking System’. Each reminder uses its own timing settings. For driver acceptance, configure the available stages and their intervals. For automatic removal, carefully choose the booking statuses and the number of days.

Important

With ‘Auto Removal’, the number of days is counted from the date the booking was created, not the planned pickup date. Check the selected statuses before activating this task, especially if future bookings may have those statuses.

How to Add a CRON Command in cPanel

  1. Open ‘Settings’ -> ‘Chauffeur Booking System’ and locate the feature you want to automate, such as ‘E-mail’ -> ‘Reminders’.
  2. Enable and configure the feature, then copy the CRON command shown by the plugin.
  3. Log in to your hosting cPanel. Under ‘Advanced’, open ‘Cron Jobs’.
  4. Choose the schedule for the task. Use the frequency recommended by the plugin for the selected event, where provided.
  5. Paste the copied command into ‘Command’ and click ‘Add New Cron Job’.
  6. Repeat for each event you want to run. Each event needs its own scheduled job.

The exact location and labels in cPanel may vary slightly by hosting provider.

Understanding the CRON Command

The command generated by Chauffeur uses wget to request an event URL. The following is a sample showing the format only:

wget "https://yourdomain.com/?chbs_cron_event=1&chbs_run_code=YOUR_UNIQUE_RUN_CODE"
  • yourdomain.com is the website where Chauffeur is installed.
  • chbs_cron_event identifies the event to execute.
  • chbs_run_code contains the unique run code generated for your installation.

If your hosting panel has separate fields for the schedule and command, enter only the command into the ‘Command’ field. If you are editing a complete crontab entry, the five scheduling fields come before the command.

Good to Know

The run code is part of the event’s access credentials. Do not post your actual command in public tickets, screenshots, shared documents, or publicly accessible log files.

How to Set the CRON Execution Time

In cPanel, select a preset schedule or set the minute, hour, day, month, and weekday fields. Common examples are:

Frequency CRON expression
Every minute * * * * *
Every hour 0 * * * *
Daily at 3:00 AM 0 3 * * *

Use a schedule suitable for the feature. For example, frequent execution is appropriate for time-sensitive reminders and acceptance deadlines, whereas a daily schedule may be suitable for automatic booking removal. The scheduled time follows your hosting server’s CRON configuration.

How to Prevent wget from Saving Output Files

By default, wget may save a downloaded response as a file. Use the following format to discard the response and suppress routine output:

wget -q -O /dev/null "https://yourdomain.com/?chbs_cron_event=1&chbs_run_code=YOUR_UNIQUE_RUN_CODE" >/dev/null 2>&1
  • -q runs wget in quiet mode.
  • -O /dev/null discards the downloaded response instead of writing a file.
  • >/dev/null 2>&1 discards standard output and error messages from the command.

Replace the sample URL with the full event URL generated by your plugin. Output suppression is useful for routine operation, but remove it temporarily if you need to diagnose a problem.

How to Check If wget Is Available

On servers with command-line access, you can check the installed executable using:

command -v wget

For example, the command may return /usr/bin/wget. If the short command does not work in cPanel, use the full path shown by your server:

/usr/bin/wget -q -O /dev/null "https://yourdomain.com/?chbs_cron_event=1&chbs_run_code=YOUR_UNIQUE_RUN_CODE" >/dev/null 2>&1

If you only have cPanel access, ask your hosting provider for the correct path to wget if needed.

How to Debug a CRON Command

If a scheduled task does not appear to run, first confirm that the event is enabled in Chauffeur, the copied URL contains the correct event and run code, and the CRON schedule has been saved.

For temporary diagnostics, run the command without quiet mode and send its output to a log file in a private directory outside your website’s public document root. For example, on hosting accounts where ~/ points to a private home directory:

/usr/bin/wget --server-response -O /dev/null "https://yourdomain.com/?chbs_cron_event=1&chbs_run_code=YOUR_UNIQUE_RUN_CODE" >> ~/cron_wget_log.txt 2>&1
  1. Use the exact URL provided in your installation, and make sure the private log location is writable.
  2. Run the temporary task, then open cron_wget_log.txt using your hosting file manager or a secure server connection.
  3. Check the server response and any errors. An HTTP success response indicates that the request reached the server; it does not by itself prove that a reminder was sent or a booking was processed.
  4. For e-mail delivery problems, also check the relevant Chauffeur logs in ‘Settings’ -> ‘Chauffeur Booking System’ -> ‘Log Manager’.
  5. Once the issue is resolved, restore the normal command and remove the temporary diagnostic log.

Important

Diagnostic output may contain the full event URL and its private run code. Do not save CRON logs under public_html or another publicly accessible directory.

Conclusion

To configure scheduled tasks reliably, enable the required feature in Chauffeur, copy its individual CRON command into cPanel, and select an appropriate execution schedule. If a task does not work, check the hosting command path, the event settings, and the private diagnostic log.

Summary

Document version: 1.3
Last updated: November 19, 2026
Plugin version: 9.8+

Was This Article Helpful?