Setup on wt-modules

Requirements

Mon, 01 Jan 0001 00:00:00 +0000

webtrees 2.2.x (PHP 8.3+)
PHP CLI with proc_open available (standard)
A trigger: classic cron, a systemd timer, a Windows Task Scheduler task, or the built-in watch daemon (no OS timer needed — see “Trigger installation”)

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Copy the module folder to modules_v4/cronjob/ (ZIP install works too). The cron library ships inside the module — nothing to fetch.
Open webtrees once (any page as an admin) so the module’s boot() creates its tables.
Install the trigger (classic cron, systemd timer, or Windows Task Scheduler — the module’s admin page generates the block for your OS with the paths of this installation already filled in).
Trigger installation (once) — see below.
Create your first job in the admin UI or configure and activate registered jobs.

Trigger installation (once)

Admin settings

Mon, 01 Jan 0001 00:00:00 +0000

Since this is a service module, the only way to access its functions is through the module settings page. Strictly speaking, the only settings available are:

the optional path to the PHP CLI binary (if it is not automatically detected) and
the option to enable additional debug logging in the error log.

Event catalog

The admin page (Events section) and the job form’s event-name suggestions are fed by an event inventory (cj_event_catalog, synced by the tick like the job registry). It merges, in this priority order: