By name: atlantis-autoupdates description: Guides Autoupdates module work including schedule windows, rollout delays, per-plugin filter toggles, and legacy Plugin Autoupdate Filter compatibility. Use when changing autoupdate behavior or related admin UI.
Skill: Atlantis Autoupdates
When to Use
Use this skill when:
- Working in
src/Modules/Autoupdates/*. - Updating
auto_update_plugin/auto_update_corebehavior. - Changing per-plugin PAF toggle behavior in wp-admin.
- Adjusting centralized settings or delay cleanup logic.
Main Components
| File | Responsibility |
|---|---|
AutoUpdatePluginsFilter.php |
Core hooks and autoupdate decision pipeline. |
PluginFilterAdminUI.php |
Plugins-screen UI for per-plugin enable/disable of Atlantis filter rules. |
PluginFilterRules.php |
Shared source of truth for disabled plugin list and external callback checks. |
Helpers.php |
Delay tracking and cleanup helpers. |
Key Behaviors
- Uses time/day windows to determine update eligibility.
- Supports temporary no-update holiday windows.
- Adds staged delay behavior per plugin version.
- Supports per-plugin bypass via site option
plugin_autoupdate_filter_disabled_plugins. - If external
disable_autoupdate_specific_pluginsexists, Atlantis respects it in UI messaging.
Guardrails
- Preserve hook priorities and accepted arg counts.
- Keep shared logic centralized in
PluginFilterRules(avoid duplicate methods). - Make user-facing admin text translatable and escaped.
- Do not register autoupdate hooks when module is disabled.
Procedure: Changing Filter Logic
- Update shared rule helpers first (
PluginFilterRules) when logic is cross-class. - Update runtime class (
AutoUpdatePluginsFilter) behavior. - Update admin UI class for visibility/toggle behavior if user-facing behavior changes.
- Update integration tests (
AutoupdatesTestCest) and restore mutated options infinally.
Verification
composer run lint:php:phpstancomposer run tests:run:integration- Manual test on Plugins screen: toggle PAF updates and verify admin notice + setting HTML.