Description
KODENZO Commerce Health is for WooCommerce store owners and the people who look after their stores. Run a scan and it checks the setup that checkout depends on: the checkout and cart pages and what is on them, checkout address fields, enabled payment gateways and whether they are in test mode, recent failed orders, shipping and tax configuration, WP-Cron and Action Scheduler health, the database, and WordPress and plugin update status.
You get a 0–100 health score and, for each problem, a plain-language explanation of why it matters and what to do about it. Results appear in wp-admin, on the Site Health screen, and as a CSV or PDF report you can share.
All 35 checks are read-only: they change nothing and send nothing to Kodenzo or anyone else. They read your store’s configuration and recent order counts, never customer details. A scan makes a few requests from your site to itself: its homepage, and the cart and checkout pages once each.
Beyond scans, the plugin shows your store’s last 7 days of orders, revenue, average order and failed payments next to your health score, sends a regular store health email (weekly by default) that reminds you to scan, and warns you by email when a steady store stops getting orders. These only read order counts, totals and dates, never customer details, and each can be turned off in Settings.
The optional Test order tool is different, and it only does anything when an administrator presses its button. It creates one private test product, then places one clearly marked, cancelled test order through your own checkout by making requests from your site to itself. It does not test your real payment methods, it blocks the site’s emails while it runs, and the test orders stay in WooCommerce until you delete them with the “Delete all test orders” button. Nothing is sent to Kodenzo or any other server.
This free plugin works on its own. All 35 checks, the health score, the store figures, the reminder and quiet-period emails, and the exports are included, and nothing is locked. The one deliberate limit is the Test order tool: in the free plugin it is manual (you press the button, one test order at a time) and checks the basic checkout only. If you also want continuous monitoring and fuller checkout testing, a separate, optional paid add-on, KODENZO Commerce Health PRO, needs this plugin and adds background monitoring of payments, checkout JavaScript errors, plugin changes and checkout speed, scheduled test orders, and email alerts.
Features
- 35 diagnostic checks across seven categories — Commerce, Reliability, Performance, Database, Configuration, Security, and Integrations — covering WooCommerce setup and configuration, storefront, cart and checkout page reachability, shipping and tax configuration, WP-Cron and Action Scheduler health, object cache and autoloaded options size, database connectivity and required tables, PHP version and memory limits, SSL and URL consistency, search engine visibility, WordPress core and plugin update status, and payment gateway configuration.
- Checkout checks — confirms the checkout and cart pages actually contain the WooCommerce checkout and cart, requests the cart and checkout pages once when you scan and reports a server error, a missing page or a redirect loop, reports removed checkout address fields, compares recent failed orders with finished orders (order counts only), and flags an enabled Stripe, PayPal or Braintree gateway left in test mode. These read only the on/off test-mode setting, never keys or credentials.
- A clear health score — every scan produces an overall 0-100 score, a Healthy/Attention/Unhealthy/Critical status, and a per-category breakdown, plus a score trend chart across recent scans.
- Store activity — orders, revenue, average order and failed payments for the last 7 days, compared with the 7 days before, on the Overview screen and in the Dashboard widget. It reads order counts, totals and dates only, never customer details, and test orders are never counted.
- Store health email — a regular email with your latest scan result, your store figures and a reminder to scan. Choose daily, weekly (the default) or monthly under Settings, or turn it off. It does not run a scan by itself. It is switched off when the PRO add-on is active, because PRO sends its own weekly summary.
- Orders gone quiet warning — once a day the plugin looks at the dates of your recent orders. If a steady store (at least 14 orders in the week before its last order) goes quiet for much longer than usual (5 times the usual gap between orders, never less than 12 hours), you get one email asking you to check your checkout and payments, and another when orders resume. A quiet period is not always a problem, but it is often the first sign that customers cannot check out. The warning also shows on the Overview screen and can be turned off in Settings. Because it runs once a day, the email can arrive up to a day after orders stop.
- Issue tracking — findings are deduplicated into persistent issues with a Detected/Active/Resolved/Reopened lifecycle, so the same underlying problem is tracked across scans instead of being reported as new every time. Each issue explains why it matters, what was found, and what to do about it.
- A full admin dashboard — Overview, Diagnostics (filterable by category), Issues (filterable by severity), Scan history and Settings, all under a single “KODENZO Commerce Health” menu in wp-admin.
- WordPress Site Health integration — your latest scan results also appear as a dedicated tab on the built-in Site Health screen (Tools → Site Health), alongside a summary card on the main wp-admin Dashboard.
- Export scan reports — download any scan as a CSV or a branded PDF report, from the Overview screen or from Scan history, for sharing or record-keeping outside wp-admin.
- Works with or without WooCommerce — WooCommerce-dependent checks report “Not applicable” rather than failing if WooCommerce isn’t installed or active; every other check still runs normally.
- Configurable Settings — scan-history retention, how often the store health email is sent (or off), the orders-gone-quiet warning on or off, a critical-issue email alert (on by default, sent when a scan you run finds a new critical issue) with a test-email button, To and CC recipients for alert emails, and an opt-in “delete data on uninstall” toggle (off by default, so nothing is removed unless you explicitly turn it on).
- WooCommerce HPOS compatible — the plugin declares compatibility with WooCommerce high-performance order storage and reads order counts in a way that works with it turned on or off.
- WP-CLI — run a scan from the command line with
wp kodenzo-ch scan. - REST API — scans, results and settings are available under
/wp-json/kodenzo-ch/v1/to logged-in administrators (themanage_optionscapability), for custom dashboards or tooling. - Developer hooks —
kodenzo_ch_register_diagnostics(add your own checks),kodenzo_ch_issue_changed(runs when an issue is new, reopened or changes severity) andkodenzo_ch_alert_recipients(adjust who receives alert emails). - Optional PRO add-on — an “Upgrade to PRO” screen and Plugins-screen link explain what the separate paid add-on adds. Both are hidden when PRO is active. The free Test order tool is manual and limited to the basic checkout.
- Test order (manual) — create a private, hidden test product, then place one clearly marked test order through your real checkout (block or classic) to see that the basic checkout flow works. Administrators only, and only when you press the button. It uses a hidden test payment method, so it does not test your real payment methods, and it does not test shipping, tax or coupons. While it runs, the site’s emails are blocked and WooCommerce webhooks are held back. The order is cancelled at once and kept until you remove it with “Delete all test orders”.
- Diagnostics are read-only — the 35 checks only read your site’s configuration and recent order counts and never modify settings, content or WooCommerce data. The Test order tool creates an order only when you press its button.
- No telemetry — no data is sent to Kodenzo or anyone else. The emails the plugin sends (critical issues, the store health email and the quiet-period warning) go only to the addresses you set, through your own site’s mail. The plugin only makes requests to your own site: the homepage, cart and checkout page checks during a scan, and, when you press Run test order, a few requests to your own cart, checkout and WooCommerce APIs.
- Translation-ready — every user-facing string is wrapped for translation.
Installation
- Upload the plugin files to the
/wp-content/plugins/kodenzo-commerce-healthdirectory, or install the plugin through the WordPress Plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Look for the new “KODENZO Commerce Health” menu item in your wp-admin sidebar, and click “Scan store” on the Overview screen to run your first scan.
FAQ
Does KODENZO Commerce Health require WooCommerce?
No. KODENZO Commerce Health works on any WordPress site. Checks that specifically depend on WooCommerce (payment gateways, checkout configuration, WooCommerce database tables, etc.) report as “Not applicable” if WooCommerce isn’t installed or active, rather than failing — the rest of the checks (WordPress version, PHP configuration, SSL, WP-Cron, database connectivity, and more) still run normally.
What does a scan actually check?
35 diagnostics across seven categories: Commerce (WooCommerce setup and configuration, checkout page content, checkout address fields, recent failed orders, storefront reachability, cart and checkout page reachability, shipping and tax configuration), Reliability (WP-Cron and Action Scheduler health), Performance (object cache, autoloaded options size), Database (connectivity and required tables), Configuration (PHP version, memory limit, SSL, debug settings, URL consistency, search engine visibility), Security (WordPress core and plugin update status), and Integrations (payment gateway configuration and test mode). Each finding comes with a plain-language explanation and a recommended next step.
Does running a scan change anything on my site?
No. Every diagnostic is read-only. A scan only reads your site’s configuration and recent order counts (never customer details) to report findings, and it never places orders or payments. The separate Test order tool creates a test product and a cancelled test order, but only when an administrator presses its button. See the next question.
What exactly does the Test order tool do?
On the Test order screen you press “Create a test product for me”, which creates one private, hidden, virtual product priced at 1.00. You cannot choose an existing product. Pressing “Run test order” then makes a few requests from your site to itself: it puts the test product in a guest cart, opens your checkout page, and submits the checkout through a hidden test payment method that only exists during that run. The order is cancelled immediately and marked as a test.
What to know before you use it:
- It does not test your real payment methods. It never contacts Stripe, PayPal or any other provider, so a pass says nothing about your real gateways.
- It creates a real order that uses up an order number and stays in WooCommerce → Orders until you press “Delete all test orders”.
- While it runs, emails from WordPress and WooCommerce are blocked and counted, and WooCommerce’s own webhooks are held back. Other plugins can still react to a new order (accounting, ERP, warehouse, shipping, loyalty, analytics or messaging tools), and this plugin cannot stop or undo that.
- WooCommerce reports leave out cancelled orders by default, but other plugins and custom reports may count it.
- It checks the basic checkout only: shipping, tax and coupons are not tested in the free plugin.
- Some hosts and firewalls stop a site from requesting itself. If so, the test says it could not run.
- Only administrators can use it, and nothing is sent to Kodenzo or anyone else.
Does it scan automatically, and will it email me?
No scans run by themselves. Scans start only when you run one, from the “Scan store” button on the Overview screen or with WP-CLI (wp kodenzo-ch scan). The plugin has three small scheduled tasks and none of them scans your store: a daily cleanup of old scan history (based on your retention setting), the store health email (daily, weekly or monthly, your choice) and a once-a-day check of recent order dates for the quiet-period warning. The last two only send emails and can be turned off in Settings.
If a scan you run finds a new critical issue, or one that had been resolved comes back, the plugin emails the alert recipients. This is on by default and can be turned off on the Settings screen, which also has a test-email button. By default the email goes to the site admin address; under Alert recipients on the same screen you can enter several To addresses and CC addresses (up to 5 in each), for example a shop owner and a developer. Developers can also add recipients in code with the kodenzo_ch_alert_recipients filter.
What does the “orders gone quiet” warning mean?
It tells you when a steady store has stopped getting orders for much longer than usual. The plugin works out how often your store normally gets an order from the week before the latest one, and warns when the gap is 5 times that (and at least 12 hours). It needs at least 14 orders in that week, so small or new stores are never warned. It reads only order dates, runs once a day, and emails once when the quiet starts and once when orders return. A quiet period is not always a problem (a slow day or a finished sale), but it can mean customers cannot check out or pay, so place a test order and check your payment provider. Turn it off in Settings.
What is in the store health email?
Your latest scan score and open issues, your orders, revenue, average order and failed payments for the last 7 days against the 7 days before, a warning if orders have gone quiet, and a link to run a scan. Choose daily, weekly (default) or monthly under Settings, or turn it off. “Send me this report now” sends one straight away so you can see it. It never runs a scan on its own and it goes only to your alert recipients.
Does KODENZO Commerce Health send any data to Kodenzo or anyone else?
No Kodenzo telemetry, ever. All scan results, issues, and settings are stored only in your own WordPress database, and KODENZO Commerce Health never collects or transmits your site or user data to Kodenzo or anyone else.
That’s a different question from whether the plugin makes any network request at all. It only ever makes requests to your own site, and they are diagnostic, not telemetry. The “Storefront Reachable” check requests your own site’s homepage during a scan to confirm it’s actually responding to visitors, the “Cart and Checkout Pages Reachable” check requests your cart and checkout pages once each, and the Test order tool, when you press its button, sends a few requests from your site to itself. The plugin never contacts a third-party destination, and nothing about the results is sent anywhere outside your own database. The emails it sends go only to the addresses you set, through your own site’s mail. Separately, WordPress core runs its own routine version and plugin update checks on its own schedule — that’s native WordPress behavior that happens whether or not KODENZO Commerce Health is installed, not something this plugin initiates.
The links on the “Upgrade to PRO” screen and in the small footer strip on the plugin’s own screens (Kodenzo logo, Support, Documentation) simply open kodenzo.com, WordPress.org or the KODENZO documentation in a new browser tab when clicked — nothing is sent when you click them.
Does KODENZO Commerce Health show up anywhere else in wp-admin?
Yes. Your most recent scan also appears as a “Commerce Health” tab on the built-in WordPress Site Health screen (Tools → Site Health), and as a summary widget on the main wp-admin Dashboard — so you don’t have to visit the plugin’s own screens to see your current score and top issues.
Can I export or share my scan results?
Yes. From the Overview screen or from any entry in Scan history, you can download a scan as a CSV file or as a branded PDF report — useful for sharing with a client, a developer, or for your own records outside wp-admin.
What happens to my scan history and settings if I uninstall the plugin?
By default, nothing is deleted. Your scan history, issues, and settings remain in the database even after uninstalling, in case you reinstall later. Data is only removed on uninstall if you’ve explicitly turned on “Delete KODENZO Commerce Health data when uninstalling” on the Settings screen first — off by default.
How is the health score calculated?
Every scan starts at 100 and subtracts points for each warning or failure by severity: Critical 25, High 12, Medium 6 and Low 2 (Info findings subtract nothing). The score is shown as Healthy (75 and above), Attention (60 to 74), Unhealthy (40 to 59) or Critical (below 40). Any Critical finding sets the status to Critical, whatever the number. Each category also gets its own 0-100 score.
My score dropped after updating to 1.4.0. Why?
Version 1.4.0 adds four checks: Checkout Page Content, Checkout Address Fields, Recent Failed Orders and Payment Gateway Test Mode. If one of them finds something on your store, the score drops by that finding’s weight. Open Diagnostics to see which check it is and what to do about it.
What do the new checkout checks look at?
Checkout Page Content confirms the checkout page contains the WooCommerce checkout (block or shortcode) and the cart page contains the cart. A page built with a page builder or a reusable block is reported as “could not confirm”, not as a failure. Checkout Address Fields reports address fields removed from the classic checkout while the store uses shipping or tax. Recent Failed Orders compares failed with finished orders over the last seven days, using counts only, and judges only after at least ten finished orders. Payment Gateway Test Mode flags an enabled Stripe, PayPal or Braintree gateway still in test mode; it reads only the on/off setting, never keys or credentials.
Does a scan visit my cart and checkout pages?
Yes, once each, and only while a scan that you started is running. The Cart and Checkout Pages Reachable check asks your own site for the checkout page, and the cart page if one is set, the way WordPress calls itself, and reports a server error (such as a 500), a missing page or a redirect that never ends. It sees what your server returns, not what a browser draws, so it cannot find JavaScript or styling problems, and it cannot prove a customer can complete checkout. If a firewall, a rate limit or your host stops the request, the check says it could not tell and does not count against your score. When the PRO add-on is active, PRO checks these pages itself every few minutes and this one-time check steps aside. Nothing is sent outside your site.
Does it work with WooCommerce HPOS and the block checkout?
Yes. The plugin declares compatibility with high-performance order storage, and the checkout checks recognise both the Checkout block and the classic [woocommerce_checkout] shortcode. The address-fields check applies to the classic checkout.
How do I send alert emails to a developer or several people?
Open Commerce Health → Settings → Alert recipients. Enter up to 5 addresses in To and up to 5 in CC, separated by commas. Leave To empty to use the site admin address. Use Send test email to confirm every address receives it. Developers can also add recipients in code with the kodenzo_ch_alert_recipients filter.
Who can see the plugin’s screens and data?
Only users with the manage_options capability, normally administrators. The same applies to the REST API and the Dashboard widget.
Can developers extend it?
Yes. Add your own checks on the kodenzo_ch_register_diagnostics action, react to new, reopened or escalated issues on kodenzo_ch_issue_changed, and adjust alert recipients with kodenzo_ch_alert_recipients. Results for checks namespaced pro. are hidden from the results endpoint unless the plugin that owns that namespace is active.
Is there a paid or Pro version?
Yes. KODENZO Commerce Health PRO is a separate, paid add-on that requires this plugin and adds background monitoring, for example of checkout and payment gateway outcomes, checkout JavaScript errors and plugin changes. This Free plugin has no trial or expiry and no locked screens: the checks, score, store figures, emails and exports described above are fully included. The one deliberate limit is the Test order tool, which in Free is manual and checks the basic checkout only. PRO adds ongoing background monitoring and scheduled test orders. A short “Upgrade to PRO” screen in the plugin menu explains what PRO adds, and a single dismissible note on the Overview mentions it after your first scan.
Who can help me fix what a scan finds?
If a scan finds something you’d rather not fix yourself, you can contact KODENZO at https://kodenzo.com/contact/.
Screenshots









Changelog
1.6.0
- Added: a Cart and Checkout Pages Reachable check. When you run a scan, it requests the cart and checkout pages once each and reports a server error, a missing page or a redirect loop. A request that is blocked or gets no answer is shown as “could not determine” and never lowers your score. It steps aside when PRO is active, because PRO checks these pages continuously.
- Changed: the plugin now has 35 checks. A store where the new check finds a problem may see a lower health score than before.
- Changed: every email the plugin sends now uses one layout: the store health email, the orders-gone-quiet and orders-are-back emails, the critical-issue email and the test email. Each says why you received it and links to the setting that controls it.
- Changed: the critical-issue email and the test email are now HTML, where they were plain text. Their subjects, recipients and settings are unchanged.
- Added: the layout is available to the PRO add-on, so PRO’s emails look the same as the free plugin’s.
1.5.0
- Added: Store activity on the Overview screen and in the Dashboard widget — orders, revenue, average order and failed payments for the last 7 days against the 7 days before. Order counts, totals and dates only; test orders are never counted.
- Added: a store health email with your latest scan result, your store figures and a reminder to scan. Choose daily, weekly (default) or monthly under Settings, or turn it off. “Send me this report now” sends one straight away. It is switched off when the PRO add-on is active, because PRO sends its own weekly summary.
- Added: an orders-gone-quiet warning. When a steady store (at least 14 orders in the week before its last order) has no orders for 5 times its usual gap, and at least 12 hours, it shows on the Overview screen and you get one email, and another when orders return. It reads order dates once a day and can be turned off in Settings. It keeps working when PRO is active.
- Added: Test order. On the new Commerce Health → Test order screen, create a private, hidden, virtual test product and place one clearly marked, cancelled test order through your real checkout (block or classic) to see that the basic checkout flow works. Administrators only, and only when you press the button. It does not test your real payment methods, shipping, tax or coupons. While it runs, the site’s emails are blocked and WooCommerce webhooks are held back. Test orders stay in WooCommerce until you press “Delete all test orders”. The risks are listed on the screen and in the FAQ.
- Changed: the “read-only” wording now says the 34 diagnostics are read-only, and that the Test order tool creates an order only when you press its button.
1.4.0
- Added: Alert recipients on the Settings screen. Enter one or more To addresses and, optionally, CC addresses (up to 5 in each) so the critical-issue email and the test email reach the right people. CC is applied to every email the plugin sends, and the PRO add-on’s emails use the same addresses. To defaults to the site admin address. Invalid addresses are not saved. A
kodenzo_ch_alert_recipientsfilter lets code adjust recipients. - Added: Checkout Page Content check — confirms the checkout page actually contains the WooCommerce checkout (block or shortcode) and the cart page the cart. Pages built with a page builder or a reusable block are reported as “could not confirm”, not as a failure.
- Added: Checkout Address Fields check — on the classic checkout, reports address fields that have been removed while the store uses shipping or tax.
- Added: Recent Failed Orders check — compares failed orders with finished orders over the last seven days, using order counts only. It needs at least ten finished orders before it judges.
- Added: Payment Gateway Test Mode check — flags an enabled Stripe, PayPal or Braintree gateway that is still in test mode on a production site. It reads only the on/off test-mode setting, never keys or credentials.
- Added: the plugin now declares compatibility with WooCommerce high-performance order storage (HPOS).
- Added: a
kodenzo_ch_issue_changedaction that runs when an issue is new, reopened or changes severity, so add-ons can react to scan findings. - Changed: the critical-issue email and the “Send test email” button now go to the alert recipients instead of always the site admin address.
- Changed: the PHP Version check now says plainly when the PHP version has reached the end of its support (PHP 8.1 and older) and no longer receives security fixes, instead of calling it “approaching the end of its support window”. PHP 8.2 keeps that wording, and PHP 8.3 and newer pass.
- Changed: the plugin now has 34 checks. Stores where one of the new checks finds something may see a lower health score than before.
1.3.0
- Added: an “Upgrade to PRO” screen that explains what the separate KODENZO Commerce Health PRO add-on adds, and a single dismissible note on the Overview after a scan. Neither appears when PRO is active, and nothing in the free plugin is locked or limited.
- Added: “Documentation” and “Upgrade to PRO” links on the plugin’s row of the Plugins screen (the upgrade link is hidden when PRO is active).
- Added: a small footer strip on the plugin’s own screens with the Kodenzo logo, the plugin version, and Support (the WordPress.org support forum) and Documentation links. It is not shown when PRO is active, because PRO shows the same strip.
- Changed: replaced the previous feature-preview screen and its banner on the Overview with the two items above.
1.2.0
- Added: WordPress Site Health integration — the latest scan’s results appear as a dedicated tab on Tools → Site Health, plus a summary widget on the main wp-admin Dashboard.
- Added: Export scan reports as CSV or PDF, from the Overview screen or from any entry in Scan history. The PDF export uses KODENZO’s own branding and colors, with a repeating header/footer, a score summary, and category/issue/diagnostic tables.
- Added: the scan results REST endpoint (GET /kodenzo-ch/v1/scans/{scan_id}/results) omits any diagnostic or issue namespaced “pro.” unless the plugin owning that namespace is active, so third-party add-ons can register their own checks without those results appearing on sites that don’t have the add-on installed.
1.0.0
- Initial release. 30 diagnostic checks across seven categories (Commerce, Reliability, Performance, Database, Configuration, Security, Integrations), an overall health score with per-category breakdown, persistent issue tracking, scan history, and configurable settings.
