Plugin Directory

Changeset 3816049


Ignore:
Timestamp:
11/22/2026 02:40:05 AM (3 hours ago)
Author:
upaccn
Message:

Update to version 1.0.1 from GitHub

Location:
modelgain-queue-health-for-action-scheduler
Files:
9 added
12 edited
1 copied

Legend:

Unmodified
Added
Removed
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/assets/admin.css

    r3745336 r3816049  
    163163        }
    164164}
     165
     166.ashc-pro {
     167        margin: 24px 0 8px;
     168        padding: 12px 16px;
     169        max-width: 760px;
     170        background: #fff;
     171        border: 1px solid #c3c4c7;
     172        border-left: 4px solid #2271b1;
     173}
     174
     175.ashc-pro h2 {
     176        margin: 4px 0 8px;
     177        font-size: 14px;
     178}
     179
     180.ashc-pro ul {
     181        margin: 0 0 8px 18px;
     182        list-style: disc;
     183}
     184
     185.ashc-pro-actions {
     186        display: flex;
     187        gap: 16px;
     188        align-items: center;
     189}
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/modelgain-queue-health-for-action-scheduler.php

    r3815435 r3816049  
    11<?php
    22/**
    3  * Plugin Name:       ModelGain Queue Health for Action Scheduler
     3 * Plugin Name:       ModelGain Queue Health for Action Scheduler – Scheduled Actions Monitor
    44 * Description:       Diagnose failed, overdue, and stuck Action Scheduler jobs and identify likely causes before taking action.
    5  * Version:           1.0.0
     5 * Version:           1.0.1
    66 * Requires at least: 6.9
    77 * Requires PHP:      7.4
    … …  
    1919
    2020define( 'MODELGAIN_AS_QUEUE_HEALTH_FILE', __FILE__ );
    21 define( 'MODELGAIN_AS_QUEUE_HEALTH_VERSION', '1.0.0' );
     21define( 'MODELGAIN_AS_QUEUE_HEALTH_VERSION', '1.0.1' );
    2222define( 'MODELGAIN_AS_QUEUE_HEALTH_DIR', plugin_dir_path( __FILE__ ) );
    2323
    2424require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-owner-resolver.php';
    2525require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-health-checker.php';
     26require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-pro-notice.php';
    2627require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-admin-page.php';
    2728require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-site-health.php';
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/readme.txt

    r3815435 r3816049  
    1 === ModelGain Queue Health for Action Scheduler ===
     1=== ModelGain Queue Health for Action Scheduler – Scheduled Actions Monitor ===
    22Contributors: upaccn
    3 Tags: action scheduler, woocommerce, cron, scheduled actions, site health
     3Tags: action scheduler, woocommerce, scheduled actions, cron, site health
    44Requires at least: 6.9
    55Tested up to: 7.1
    66Requires PHP: 7.4
    7 Stable tag: 1.0.0
     7Stable tag: 1.0.1
    88License: GPLv2 or later
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Find overdue and failed Action Scheduler jobs, identify the dominant hooks, and see which plugin likely owns them before changing the queue.
     11See why WooCommerce scheduled actions are past due or failing, which hook causes it and which plugin likely owns it. Read-only, no cleanup risk.
    1212
    1313== Description ==
    1414
    15 Action Scheduler powers background work for WooCommerce and many other WordPress plugins. When Scheduled Actions begin to fail or become past due, the built-in queue tells you what exists but can still leave the most important questions unanswered: Is the backlog abnormal? Which hook is causing most of it? Which plugin probably owns that hook? Is the default runner available?
     15Action Scheduler runs the background work behind WooCommerce, subscription renewals, emails, webhooks, imports and many other plugins. When the queue stalls, orders and emails are late, and **Tools → Scheduled Actions** shows thousands of rows without telling you what is actually wrong.
    1616
    17 ModelGain Queue Health for Action Scheduler adds a read-only diagnostic screen under **Tools → Action Scheduler Health**.
     17ModelGain Queue Health for Action Scheduler adds one diagnostic screen under **Tools → Action Scheduler Health** that answers the questions you ask during an incident:
    1818
    19 The first release focuses on diagnosis rather than cleanup:
     19* **Is the backlog abnormal?** Pending, Past Due, recent Failed and long-running action counts, plus the age of the oldest overdue action.
     20* **Is the runner working?** Checks WP-Cron, the default Action Scheduler runner hook and the next scheduled queue run.
     21* **Which hook is the problem?** Ranks the hooks with the strongest overdue or failure signal.
     22* **Which plugin owns it?** Maps currently registered callbacks back to a likely plugin, must-use plugin, theme or WordPress core file.
     23* **What failed?** Recent failure evidence, without exposing Action Scheduler arguments.
     24* **Need help from a developer or host?** Copy a privacy-conscious support report.
     25* **See it in Site Health.** A Critical queue shows up in **Tools → Site Health** next to other site problems.
    2026
    21 * See Pending, Past Due, recent Failed, and long-running action counts.
    22 * See the age of the oldest overdue action.
    23 * Check WP-Cron, the default Action Scheduler runner hook, and the next scheduled queue run.
    24 * Rank the hooks contributing the strongest overdue or failure signal.
    25 * Map currently registered callbacks back to a likely plugin, must-use plugin, theme, or WordPress core file.
    26 * Review recent failure evidence without exposing Action Scheduler arguments.
    27 * Copy a privacy-conscious support report for troubleshooting.
    28 * See the queue state in **Tools → Site Health**, so a Critical queue shows up next to other site problems without opening the dashboard.
     27States are **Healthy**, **Review** and **Critical**. A small transient backlog can be normal, and ownership evidence does not prove that a plugin is the root cause, so the plugin gives conservative guidance instead of alarms.
    2928
    30 The dashboard uses **Healthy**, **Review**, and **Critical** states as troubleshooting guidance. A small transient backlog can be normal, and ownership evidence does not prove that a plugin is the root cause.
     29= Safe by design =
    3130
    32 The plugin does not cancel, delete, rerun, reschedule, or edit third-party actions. It makes no external API calls and does not send telemetry.
     31The plugin is read-only. It does not cancel, delete, rerun, reschedule or edit any action, so it is safe to install on a live store during an incident. It makes no external API calls and does not send telemetry.
     32
     33It works with any active Action Scheduler runtime, whether it comes from WooCommerce, WooCommerce Subscriptions, a marketing or SEO plugin, or a theme.
     34
     35= Pro add-on: get warned before customers notice =
     36
     37The free plugin is complete for diagnosing the queue and stays free, with no locked features or license prompts. If you want the queue watched for you, the optional [Pro add-on](https://modelgain.com/products/queue-health/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=qh-pro) adds:
     38
     39* Scheduled background checks: hourly, twice a day or daily.
     40* One email when the queue becomes Critical (or Review, if you choose), not on every check.
     41* A failure-spike email when many actions failed since the previous check, and an optional "healthy again" email.
     42* History of the last 48 checks with state, past due, failures, long-running actions, the top hook and its likely owner.
     43* CSV export of the history.
     44* WP-CLI: `wp modelgain-queue-health check --fail-on=critical` exits with code 1 when the queue is Critical, for server cron, uptime tools and deploy checks.
     45
     46Pro is $19.99 per year or $29.99 once for lifetime use, per site, sold through Freemius. Like the free plugin, it never changes scheduled actions.
    3347
    3448== Installation ==
    3549
    36 1. Upload the plugin or install it from WordPress.org when available.
    37 2. Activate **ModelGain Queue Health for Action Scheduler** from the Plugins screen.
     501. Install the plugin from **Plugins → Add New** by searching for "ModelGain Queue Health", or upload the ZIP.
     512. Activate it.
    38523. Open **Tools → Action Scheduler Health**.
    3953
    … …  
    4155
    4256== Frequently Asked Questions ==
     57
     58= Why are my WooCommerce scheduled actions past due? =
     59
     60Common causes are WP-Cron not running (low traffic or `DISABLE_WP_CRON` without a server cron), one plugin's hook failing or running very long, or a large backlog after an import. This plugin shows which of these signals is present and which hook and plugin are most involved.
    4361
    4462= Does this plugin delete or repair scheduled actions? =
    … …  
    6482= Is there a Pro version? =
    6583
    66 Yes. The free plugin is complete for diagnosing the queue and will stay free. The separate ModelGain Queue Health Pro add-on checks the queue on a schedule, keeps a history of checks, emails you when the queue becomes Critical or failures spike, exports the history as CSV and adds WP-CLI commands for monitoring. See https://modelgain.com/products/queue-health/ for details. The free plugin never asks for a license and has no locked features.
     84Yes. The free plugin is complete for diagnosing the queue and will stay free. The separate Pro add-on checks the queue on a schedule, keeps a history of checks, emails you when the queue becomes Critical or failures spike, exports the history as CSV and adds WP-CLI commands for monitoring. The small Pro card on the health screen can be hidden with one click, and the free plugin never asks for a license.
     85
     86== Screenshots ==
     87
     881. Queue health state with Pending, Past Due, Failed and long-running counts.
     892. Likely causes: hooks ranked by overdue and failure signal, with the likely owning plugin and the recent failure message.
     903. Runner diagnostics and the recommended next step.
    6791
    6892== Changelog ==
     93
     94= 1.0.1 =
     95* Clearer plugin name, description and FAQ for people troubleshooting past-due WooCommerce scheduled actions.
     96* A small, dismissible card on the health screen describes the optional Pro add-on. It is hidden when Pro is active. No feature of the free plugin changed or became limited.
     97* Uninstall also removes the per-user "hide Pro card" preference.
     98
    6999
    70100= 1.0.0 =
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/src/class-admin-page.php

    r3815435 r3816049  
    3636
    3737        /**
     38         * Optional Pro add-on information card.
     39         *
     40         * @var Pro_Notice
     41         */
     42        private Pro_Notice $pro_notice;
     43
     44        /**
    3845         * Constructor.
    3946         *
    40          * @param Health_Checker $checker Queue checker.
    41          */
    42         public function __construct( Health_Checker $checker ) {
    43                 $this->checker = $checker;
     47         * @param Health_Checker  $checker    Queue checker.
     48         * @param Pro_Notice|null $pro_notice Pro add-on information card.
     49         */
     50        public function __construct( Health_Checker $checker, ?Pro_Notice $pro_notice = null ) {
     51                $this->checker    = $checker;
     52                $this->pro_notice = $pro_notice ?? new Pro_Notice();
    4453        }
    4554
    … …  
    230239                                <p class="ashc-copy-status" aria-live="polite"></p>
    231240                        </section>
     241                        <?php $this->pro_notice->render(); ?>
    232242                </div>
    233243                <?php
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/src/class-plugin.php

    r3815435 r3816049  
    5151                $checker       = new Health_Checker( new Owner_Resolver() );
    5252                $this->checker = $checker;
    53                 $page          = new Admin_Page( $checker );
     53                $pro_notice    = new Pro_Notice();
     54                $page          = new Admin_Page( $checker, $pro_notice );
    5455                $page->register();
     56                $pro_notice->register();
    5557                ( new Site_Health( $checker ) )->register();
    5658
  • modelgain-queue-health-for-action-scheduler/tags/1.0.1/uninstall.php

    r3815435 r3816049  
    33 * Uninstall handler for ModelGain Queue Health for Action Scheduler.
    44 *
    5  * The plugin stores no settings. It only removes its short-lived Site Health cache.
     5 * The plugin stores no settings. It removes its short-lived Site Health cache
     6 * and the per-user "hide Pro card" preference.
    67 *
    78 * @package ModelGainQueueHealth
    … …  
    1314
    1415delete_transient( 'modelgain_as_queue_health_site_health' );
     16delete_metadata( 'user', 0, 'modelgain_as_queue_health_pro_card_dismissed', '', true );
  • modelgain-queue-health-for-action-scheduler/trunk/assets/admin.css

    r3745336 r3816049  
    163163        }
    164164}
     165
     166.ashc-pro {
     167        margin: 24px 0 8px;
     168        padding: 12px 16px;
     169        max-width: 760px;
     170        background: #fff;
     171        border: 1px solid #c3c4c7;
     172        border-left: 4px solid #2271b1;
     173}
     174
     175.ashc-pro h2 {
     176        margin: 4px 0 8px;
     177        font-size: 14px;
     178}
     179
     180.ashc-pro ul {
     181        margin: 0 0 8px 18px;
     182        list-style: disc;
     183}
     184
     185.ashc-pro-actions {
     186        display: flex;
     187        gap: 16px;
     188        align-items: center;
     189}
  • modelgain-queue-health-for-action-scheduler/trunk/modelgain-queue-health-for-action-scheduler.php

    r3815435 r3816049  
    11<?php
    22/**
    3  * Plugin Name:       ModelGain Queue Health for Action Scheduler
     3 * Plugin Name:       ModelGain Queue Health for Action Scheduler – Scheduled Actions Monitor
    44 * Description:       Diagnose failed, overdue, and stuck Action Scheduler jobs and identify likely causes before taking action.
    5  * Version:           1.0.0
     5 * Version:           1.0.1
    66 * Requires at least: 6.9
    77 * Requires PHP:      7.4
    … …  
    1919
    2020define( 'MODELGAIN_AS_QUEUE_HEALTH_FILE', __FILE__ );
    21 define( 'MODELGAIN_AS_QUEUE_HEALTH_VERSION', '1.0.0' );
     21define( 'MODELGAIN_AS_QUEUE_HEALTH_VERSION', '1.0.1' );
    2222define( 'MODELGAIN_AS_QUEUE_HEALTH_DIR', plugin_dir_path( __FILE__ ) );
    2323
    2424require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-owner-resolver.php';
    2525require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-health-checker.php';
     26require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-pro-notice.php';
    2627require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-admin-page.php';
    2728require_once MODELGAIN_AS_QUEUE_HEALTH_DIR . 'src/class-site-health.php';
  • modelgain-queue-health-for-action-scheduler/trunk/readme.txt

    r3815435 r3816049  
    1 === ModelGain Queue Health for Action Scheduler ===
     1=== ModelGain Queue Health for Action Scheduler – Scheduled Actions Monitor ===
    22Contributors: upaccn
    3 Tags: action scheduler, woocommerce, cron, scheduled actions, site health
     3Tags: action scheduler, woocommerce, scheduled actions, cron, site health
    44Requires at least: 6.9
    55Tested up to: 7.1
    66Requires PHP: 7.4
    7 Stable tag: 1.0.0
     7Stable tag: 1.0.1
    88License: GPLv2 or later
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Find overdue and failed Action Scheduler jobs, identify the dominant hooks, and see which plugin likely owns them before changing the queue.
     11See why WooCommerce scheduled actions are past due or failing, which hook causes it and which plugin likely owns it. Read-only, no cleanup risk.
    1212
    1313== Description ==
    1414
    15 Action Scheduler powers background work for WooCommerce and many other WordPress plugins. When Scheduled Actions begin to fail or become past due, the built-in queue tells you what exists but can still leave the most important questions unanswered: Is the backlog abnormal? Which hook is causing most of it? Which plugin probably owns that hook? Is the default runner available?
     15Action Scheduler runs the background work behind WooCommerce, subscription renewals, emails, webhooks, imports and many other plugins. When the queue stalls, orders and emails are late, and **Tools → Scheduled Actions** shows thousands of rows without telling you what is actually wrong.
    1616
    17 ModelGain Queue Health for Action Scheduler adds a read-only diagnostic screen under **Tools → Action Scheduler Health**.
     17ModelGain Queue Health for Action Scheduler adds one diagnostic screen under **Tools → Action Scheduler Health** that answers the questions you ask during an incident:
    1818
    19 The first release focuses on diagnosis rather than cleanup:
     19* **Is the backlog abnormal?** Pending, Past Due, recent Failed and long-running action counts, plus the age of the oldest overdue action.
     20* **Is the runner working?** Checks WP-Cron, the default Action Scheduler runner hook and the next scheduled queue run.
     21* **Which hook is the problem?** Ranks the hooks with the strongest overdue or failure signal.
     22* **Which plugin owns it?** Maps currently registered callbacks back to a likely plugin, must-use plugin, theme or WordPress core file.
     23* **What failed?** Recent failure evidence, without exposing Action Scheduler arguments.
     24* **Need help from a developer or host?** Copy a privacy-conscious support report.
     25* **See it in Site Health.** A Critical queue shows up in **Tools → Site Health** next to other site problems.
    2026
    21 * See Pending, Past Due, recent Failed, and long-running action counts.
    22 * See the age of the oldest overdue action.
    23 * Check WP-Cron, the default Action Scheduler runner hook, and the next scheduled queue run.
    24 * Rank the hooks contributing the strongest overdue or failure signal.
    25 * Map currently registered callbacks back to a likely plugin, must-use plugin, theme, or WordPress core file.
    26 * Review recent failure evidence without exposing Action Scheduler arguments.
    27 * Copy a privacy-conscious support report for troubleshooting.
    28 * See the queue state in **Tools → Site Health**, so a Critical queue shows up next to other site problems without opening the dashboard.
     27States are **Healthy**, **Review** and **Critical**. A small transient backlog can be normal, and ownership evidence does not prove that a plugin is the root cause, so the plugin gives conservative guidance instead of alarms.
    2928
    30 The dashboard uses **Healthy**, **Review**, and **Critical** states as troubleshooting guidance. A small transient backlog can be normal, and ownership evidence does not prove that a plugin is the root cause.
     29= Safe by design =
    3130
    32 The plugin does not cancel, delete, rerun, reschedule, or edit third-party actions. It makes no external API calls and does not send telemetry.
     31The plugin is read-only. It does not cancel, delete, rerun, reschedule or edit any action, so it is safe to install on a live store during an incident. It makes no external API calls and does not send telemetry.
     32
     33It works with any active Action Scheduler runtime, whether it comes from WooCommerce, WooCommerce Subscriptions, a marketing or SEO plugin, or a theme.
     34
     35= Pro add-on: get warned before customers notice =
     36
     37The free plugin is complete for diagnosing the queue and stays free, with no locked features or license prompts. If you want the queue watched for you, the optional [Pro add-on](https://modelgain.com/products/queue-health/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=qh-pro) adds:
     38
     39* Scheduled background checks: hourly, twice a day or daily.
     40* One email when the queue becomes Critical (or Review, if you choose), not on every check.
     41* A failure-spike email when many actions failed since the previous check, and an optional "healthy again" email.
     42* History of the last 48 checks with state, past due, failures, long-running actions, the top hook and its likely owner.
     43* CSV export of the history.
     44* WP-CLI: `wp modelgain-queue-health check --fail-on=critical` exits with code 1 when the queue is Critical, for server cron, uptime tools and deploy checks.
     45
     46Pro is $19.99 per year or $29.99 once for lifetime use, per site, sold through Freemius. Like the free plugin, it never changes scheduled actions.
    3347
    3448== Installation ==
    3549
    36 1. Upload the plugin or install it from WordPress.org when available.
    37 2. Activate **ModelGain Queue Health for Action Scheduler** from the Plugins screen.
     501. Install the plugin from **Plugins → Add New** by searching for "ModelGain Queue Health", or upload the ZIP.
     512. Activate it.
    38523. Open **Tools → Action Scheduler Health**.
    3953
    … …  
    4155
    4256== Frequently Asked Questions ==
     57
     58= Why are my WooCommerce scheduled actions past due? =
     59
     60Common causes are WP-Cron not running (low traffic or `DISABLE_WP_CRON` without a server cron), one plugin's hook failing or running very long, or a large backlog after an import. This plugin shows which of these signals is present and which hook and plugin are most involved.
    4361
    4462= Does this plugin delete or repair scheduled actions? =
    … …  
    6482= Is there a Pro version? =
    6583
    66 Yes. The free plugin is complete for diagnosing the queue and will stay free. The separate ModelGain Queue Health Pro add-on checks the queue on a schedule, keeps a history of checks, emails you when the queue becomes Critical or failures spike, exports the history as CSV and adds WP-CLI commands for monitoring. See https://modelgain.com/products/queue-health/ for details. The free plugin never asks for a license and has no locked features.
     84Yes. The free plugin is complete for diagnosing the queue and will stay free. The separate Pro add-on checks the queue on a schedule, keeps a history of checks, emails you when the queue becomes Critical or failures spike, exports the history as CSV and adds WP-CLI commands for monitoring. The small Pro card on the health screen can be hidden with one click, and the free plugin never asks for a license.
     85
     86== Screenshots ==
     87
     881. Queue health state with Pending, Past Due, Failed and long-running counts.
     892. Likely causes: hooks ranked by overdue and failure signal, with the likely owning plugin and the recent failure message.
     903. Runner diagnostics and the recommended next step.
    6791
    6892== Changelog ==
     93
     94= 1.0.1 =
     95* Clearer plugin name, description and FAQ for people troubleshooting past-due WooCommerce scheduled actions.
     96* A small, dismissible card on the health screen describes the optional Pro add-on. It is hidden when Pro is active. No feature of the free plugin changed or became limited.
     97* Uninstall also removes the per-user "hide Pro card" preference.
     98
    6999
    70100= 1.0.0 =
  • modelgain-queue-health-for-action-scheduler/trunk/src/class-admin-page.php

    r3815435 r3816049  
    3636
    3737        /**
     38         * Optional Pro add-on information card.
     39         *
     40         * @var Pro_Notice
     41         */
     42        private Pro_Notice $pro_notice;
     43
     44        /**
    3845         * Constructor.
    3946         *
    40          * @param Health_Checker $checker Queue checker.
    41          */
    42         public function __construct( Health_Checker $checker ) {
    43                 $this->checker = $checker;
     47         * @param Health_Checker  $checker    Queue checker.
     48         * @param Pro_Notice|null $pro_notice Pro add-on information card.
     49         */
     50        public function __construct( Health_Checker $checker, ?Pro_Notice $pro_notice = null ) {
     51                $this->checker    = $checker;
     52                $this->pro_notice = $pro_notice ?? new Pro_Notice();
    4453        }
    4554
    … …  
    230239                                <p class="ashc-copy-status" aria-live="polite"></p>
    231240                        </section>
     241                        <?php $this->pro_notice->render(); ?>
    232242                </div>
    233243                <?php
  • modelgain-queue-health-for-action-scheduler/trunk/src/class-plugin.php

    r3815435 r3816049  
    5151                $checker       = new Health_Checker( new Owner_Resolver() );
    5252                $this->checker = $checker;
    53                 $page          = new Admin_Page( $checker );
     53                $pro_notice    = new Pro_Notice();
     54                $page          = new Admin_Page( $checker, $pro_notice );
    5455                $page->register();
     56                $pro_notice->register();
    5557                ( new Site_Health( $checker ) )->register();
    5658
  • modelgain-queue-health-for-action-scheduler/trunk/uninstall.php

    r3815435 r3816049  
    33 * Uninstall handler for ModelGain Queue Health for Action Scheduler.
    44 *
    5  * The plugin stores no settings. It only removes its short-lived Site Health cache.
     5 * The plugin stores no settings. It removes its short-lived Site Health cache
     6 * and the per-user "hide Pro card" preference.
    67 *
    78 * @package ModelGainQueueHealth
    … …  
    1314
    1415delete_transient( 'modelgain_as_queue_health_site_health' );
     16delete_metadata( 'user', 0, 'modelgain_as_queue_health_pro_card_dismissed', '', true );
Note: See TracChangeset for help on using the changeset viewer.