Schedule the recurring scripts
- Version
- 3.x
- Updated
Audience: store owners and whoever administers the site's server · Scope: the scheduled jobs a CBX store needs · Last reviewed: 2026-07-29
Almost everything in CBX takes care of itself: routine cleanup runs during normal visits, and nothing needs a nightly job just to keep the store selling. One script is the exception — it only works when someone schedules it on the server.
The AI assistant's journal sweep
If you use the AI Configurator Assistant, one command needs to run on a schedule:
php cli/joomla.php configbox:chatadvisor:analyze
Every run does two jobs:
- It enforces the journal retention. Conversations older than the retention period set in Settings → AI Configurator Assistant are deleted. That retention is a promise about visitor data — without the scheduled run, nothing deletes old conversations.
- It writes the lessons-learned reviews. Conversations that have gone quiet get their AI-written review (visible on each conversation in the journal). This part respects the "Analyze conversations automatically" setting; the retention part runs regardless.
- It maintains the recommendations. After the reviews, everything newly analysed is folded into the Recommendations backlog — new evidence joins what is already known, genuinely new problems open new entries, and a fixed problem that visitors hit again is flagged as regressed. Without the scheduled run, the backlog only moves when someone presses "Fold them in now" on the screen.
Ask whoever administers your server to schedule it — once per hour is a good rhythm. A conversation is considered finished after it has been quiet for half an hour, so an hourly run reviews conversations while they are still fresh.
If the store does not use the AI assistant, the command does nothing and nothing needs scheduling.
How to tell that it is running
Open AI Assistant → Conversation Journal in the CBX menu and look at the Analyzed column: with the sweep in place, conversations get their check mark on their own within an hour or two of ending. If older conversations pile up unanalyzed (and never disappear after the retention period), the schedule is not running — the Analyze button on each conversation still works by hand in the meantime.