Skip to content

Powered by Grav CMS + Helios Theme

Health, drift and previews

The store health check, the template drift report, and the admin's document previews.

The checks an operator runs against a live store, and the previews the admin screens render. check is the same set of tests as bin/plugin kahunacart check. See Troubleshooting.

Run the installation check

GET /api/v1/kahunacart/check Permission kahunacart.settings

Run every going-live check — database, migrations, scheduler, mail transport, download roots, trusted proxies, provider credentials, webhook reachability, template drift, the report rollup — and answer each finding with its status, detail, suggested fix and docs anchor, the overall verdict, and the redacted support report as text. Safe to run repeatedly; offline: true skips the two network probes.

Parameters

Name Type Description
offline optional boolean Skip provider connection checks and subscription pings

Template drift report

GET /api/v1/kahunacart/template-drift Permission kahunacart.settings

Every template the plugin ships with the state of its theme override: current, behind (the override's @version is lower than the shipped one), ahead, unstamped, or none. The drifted rows are listed on their own with both versions, which is the list to work through after a plugin update.

List what the previews can render

GET /api/v1/kahunacart/previews Permission kahunacart.settings

The last ten completed orders, the email kinds and the documents the previews can render. No tool: a picker for a screen

Preview an order email

GET /api/v1/kahunacart/previews/email/{kind} Permission kahunacart.settings

One order email rendered against ?order= or ?number=, never sent, as HTML, ?format=text or ?format=json. no-store. No tool: a document to look at

Preview an order document

GET /api/v1/kahunacart/previews/pdf/{document} Permission kahunacart.settings

The invoice, packing slip or credit note for one order as a PDF, or ?format=html. no-store. No tool, like every other PDF

The template drift report names every KahunaCart template a theme has overridden and how far behind the plugin's own copy it has fallen, so an upgrade that changed a template is noticed before a customer sees it.