Description
kanenas — Minor/Patch Auto-Updates gives you granular control over automatic updates. While WordPress allows you to enable or disable auto-updates entirely, this adds a third option: auto-update only minor and patch versions while keeping major versions at bay.
Why Use This?
Major version updates often introduce significant changes that may:
- Break compatibility with other extensions
- Introduce new features that require testing
- Change the behavior of existing functionality
- Require database migrations or manual intervention
With this, you can:
- Receive security patches automatically – Minor and patch versions typically contain security fixes
- Get bug fixes without intervention – Patch versions are generally safe to apply automatically
- Control major updates manually – Review major version changes before applying them
- Maintain site stability – Reduce the risk of unexpected breaking changes
How It Works
It uses semantic versioning (MAJOR.MINOR.PATCH) to determine update types:
- Major update (e.g., 1.0.0 2.0.0): Blocked from auto-update
- Minor update (e.g., 1.0.0 1.1.0): Allowed to auto-update
- Patch update (e.g., 1.0.0 1.0.1): Allowed to auto-update
Internally, this plugin runs only on WordPress auto-update decision filters:
auto_update_pluginauto_update_theme
When you enable minor/patch mode for a plugin or theme, it also adds that item to WordPress core’s auto_update_plugins / auto_update_themes site options so the automatic updater treats it as opted-in the same way as the Plugins/Themes screen toggle.
It does not rewrite update API responses (plugins_api) and does not modify updater transients (pre_set_site_transient_update_plugins). Premium update discovery and license validation remain managed by each vendor updater.
Features
- Per-item control – Enable minor/patch auto-updates for specific items
- Easy toggle – Simple links in the admin pages
- Non-intrusive – Works alongside WordPress’s native auto-update system
- Clean uninstall – Removes all data when uninstalled
- Translation ready – Fully prepared for localization
Usage
- Go to Plugins Installed Plugins
- Look for the “Enable auto-updates minor/patch” link below each plugin’s auto-update setting
- Click to enable/disable minor/patch auto-updates for that plugin
For themes:
1. Go to Appearance Themes
2. Click on a theme to view its details
3. Look for the “Enable auto-updates minor/patch” option in the theme details overlay
Privacy Policy
This plugin does not collect, store, or transmit any personal data. It only stores plugin/theme preferences in your WordPress database.
Installation
From WordPress Admin
- Go to Add New in your admin
- Search for “kanenas — Minor/Patch Auto-Updates”
- Click Install Now and then Activate
Manual Installation
- Download the ZIP file
- Go to Add New Upload
- Choose the ZIP file and click Install Now
- Activate it
Via FTP
- Download and unzip
- Upload the plugin folder (for example
kanenas-minor-patch-auto-updates) to/wp-content/plugins/ - Activate through the admin menu
FAQ
-
Yes, for automatic-update decisions. This plugin can only allow/block the final auto-update decision after an update has already been discovered by the vendor updater.
If a premium update is not detected at all, the cause is usually in that vendor’s update/auth stack and not in this plugin.
-
What if an extension doesn’t follow semantic versioning?
-
The plugin classifies versions as
minor_or_patch,major, orunknown.If a version cannot be categorized safely, it now defers to WordPress’s existing auto-update decision instead of forcing allow/deny.
-
Can I use this alongside WordPress’s native auto-updates?
-
Yes. If you enable both the native “Enable auto-updates” and “Enable auto-updates minor/patch” options, the minor/patch setting will take precedence and block major version updates.
-
Yes.
eaump_bypass_plugin_update_gate– bypass this plugin’s gate for a specific plugin update object.eaump_bypass_theme_update_gate– bypass this plugin’s gate for a specific theme update object.eaump_debug_log_updates– enable JSON decision logs (defaults toWP_DEBUG).
If your premium updater has custom version formats or non-standard metadata, use a bypass filter to defer to core/vendor logic for that item.
-
- Confirm the premium updater detects an available update first.
- Check whether your item is opted into “auto-updates minor/patch”.
- Enable debug logging with
eaump_debug_log_updatesand inspect decision reason codes. - If needed, add a targeted bypass via
eaump_bypass_plugin_update_gateoreaump_bypass_theme_update_gate.
-
Why do debug logs show the same current and new version?
-
On the Plugins screen, WordPress may invoke
auto_update_pluginfor every row using metadata where the offered version equals the installed version (no pending upgrade). In that case you will seereason: defer_same_version_no_pending_upgrade— it does not mean an update failed; it means there was nothing to upgrade in that pass. -
Does disabling minor/patch remove WordPress auto-updates for that item?
-
Yes. Disabling minor/patch removes that plugin/theme from core
auto_update_plugins/auto_update_themes, matching the enable action which opted it in. -
Will this work on multisite?
-
Yes, it supports WordPress multisite installations.
-
How do I report a bug or request a feature?
-
Please visit kanenas.net or use the ww.wp.xz.cn support forum.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“kanenas — Minor/Patch Auto-Updates” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “kanenas — Minor/Patch Auto-Updates” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.3
- Sync EAUMP-enabled plugins/themes with core
auto_update_plugins/auto_update_themesso background updates align with WordPress’s opted-in list. - When installed version equals the offered version (no pending upgrade), defer instead of logging a false “allow” decision.
- One-time migration merges existing EAUMP selections into core auto-update lists.
1.0.2
- Added conservative update classification (
minor_or_patch,major,unknown) for safer handling of vendor-specific version formats. - Changed ambiguous version behavior to defer to WordPress/core decision instead of hard blocking.
- Added premium compatibility bypass filters:
eaump_bypass_plugin_update_gate,eaump_bypass_theme_update_gate. - Added optional structured debug logging via
eaump_debug_log_updates.
1.0.1
- Renamed plugin for ww.wp.xz.cn distinctiveness; text domain is now
kanenas-minor-patch-auto-updates. - Plugin directory and bootstrap file are
kanenas-minor-patch-auto-updates/kanenas-minor-patch-auto-updates.php(matches SVN slug).
1.0.0
- Initial release
