| 1 |
<?php |
| 2 |
/** |
| 3 |
* Main plugin bootstrap. |
| 4 |
* |
| 5 |
* @package XSpeed |
| 6 |
*/ |
| 7 |
|
| 8 |
namespace XSpeed; |
| 9 |
|
| 10 |
defined( 'ABSPATH' ) || exit; |
| 11 |
|
| 12 |
class Plugin { |
| 13 |
|
| 14 |
/** |
| 15 |
* Data-schema version for one-time migrations, independent of the |
| 16 |
* plugin version header. Bump when adding a step to maybe_upgrade(). |
| 17 |
*/ |
| 18 |
public const DATA_VERSION = '1.1.4'; |
| 19 |
|
| 20 |
private static $instance = null; |
| 21 |
|
| 22 |
/** @var Usage_Tracker|null */ |
| 23 |
private $usage_tracker = null; |
| 24 |
|
| 25 |
public static function instance() { |
| 26 |
if ( null === self::$instance ) { |
| 27 |
self::$instance = new self(); |
| 28 |
} |
| 29 |
return self::$instance; |
| 30 |
} |
| 31 |
|
| 32 |
public function init() { |
| 33 |
// v1 services that are NOT yet wrapped as Modules (Admin, Rest_Api, |
| 34 |
// Cache, Onboarding) are instantiated directly. Minifier is now |
| 35 |
// instantiated by MinifyModule::boot(); Gzip is purely static. |
| 36 |
new Admin(); |
| 37 |
new Rest_Api(); |
| 38 |
new Cache(); |
| 39 |
new Rest_Cache(); |
| 40 |
new Onboarding(); |
| 41 |
|
| 42 |
// Optional deactivation feedback survey on the Plugins screen. Admin |
| 43 |
// context only (its hooks are admin_enqueue_scripts / admin_footer / |
| 44 |
// wp_ajax). Sends nothing unless the user clicks "Submit & Deactivate". |
| 45 |
if ( is_admin() ) { |
| 46 |
new Deactivation_Feedback(); |
| 47 |
} |
| 48 |
|
| 49 |
// Opt-in usage analytics. Instantiating + init() only registers the |
| 50 |
// cron callback; NOTHING is collected or sent until the admin opts in |
| 51 |
// from the setup wizard (Onboarding wires the consent toggle to |
| 52 |
// Usage_Tracker::opt_in()). See class-usage-tracker.php privacy contract. |
| 53 |
$this->start_plugin_tracking(); |
| 54 |
|
| 55 |
// Auto-heal the cache drop-in + WP_CACHE constant when state |
| 56 |
// drifts. Scoped to admin_init only: filesystem writes belong in |
| 57 |
// an authenticated admin context, never on anonymous front-end |
| 58 |
// requests. The user already opted in (cache_enabled=true) — |
| 59 |
// this is a consistency check, not a new install path. First |
| 60 |
// admin page load after a plugin upgrade restores the state; |
| 61 |
// front-end then serves from cache on the next request. |
| 62 |
add_action( 'admin_init', array( Cache::class, 'auto_heal' ) ); |
| 63 |
// Cheap: returns immediately unless the stored schema version is |
| 64 |
// behind. Covers updates and multisite, where activate() never runs. |
| 65 |
add_action( 'admin_init', array( Score_Store::class, 'maybe_install' ) ); |
| 66 |
|
| 67 |
// Secondary net: restore as soon as an update completes, for the |
| 68 |
// cases where activate() does not re-run (bulk updates, auto-updates, |
| 69 |
// some host updaters). Best-effort by nature — this callback is only |
| 70 |
// registered when we were loaded in the request performing the |
| 71 |
// update, which is not guaranteed while WE are the plugin being |
| 72 |
// replaced. The restore in activate() is the primary guarantee; |
| 73 |
// auto_heal() on admin_init remains the backstop. |
| 74 |
add_action( 'upgrader_process_complete', array( $this, 'maybe_restore_after_update' ), 10, 2 ); |
| 75 |
|
| 76 |
// Per-post cache rules (Phase 3.4) — registers postmeta with |
| 77 |
// REST + meta box on edit screens. |
| 78 |
Cache_Meta_Box::boot(); |
| 79 |
|
| 80 |
// Phase 0 architecture — managers + Free modules. v1 services |
| 81 |
// (Cache/Minifier/Gzip) are NOT yet Modules; they'll be refactored |
| 82 |
// in a follow-up PR with parity tests. |
| 83 |
Conflict_Registry::boot(); |
| 84 |
|
| 85 |
// Register Free modules via the same action xspeed-pro uses, so |
| 86 |
// the bootstrap path is symmetric across tiers. |
| 87 |
add_action( 'xspeed_register_modules', array( $this, 'register_free_modules' ) ); |
| 88 |
|
| 89 |
// Fire the registration action + boot the registry at a LATER |
| 90 |
// plugins_loaded priority so add-on plugins (xspeed-pro, in |
| 91 |
// alphabetical order so it runs at default priority 10 AFTER |
| 92 |
// us, but any add-on loaded at plugins_loaded(< 20)) have a |
| 93 |
// chance to register their `xspeed_register_modules` callback |
| 94 |
// before we fire the action. |
| 95 |
// |
| 96 |
// Bug history: previously this fired inline from init() at |
| 97 |
// priority 10. xspeed-pro's plugins_loaded(15) hook then added |
| 98 |
// its register_pro_modules callback AFTER the action had |
| 99 |
// already fired — Pro modules never appeared in the registry. |
| 100 |
// Caught by the ProStatus sentinel module's integration test. |
| 101 |
add_action( 'plugins_loaded', array( $this, 'fire_module_lifecycle' ), 20 ); |
| 102 |
|
| 103 |
// One-time data migrations keyed on the stored version. Runs in |
| 104 |
// admin only — nothing here needs to touch a front-end request. |
| 105 |
if ( is_admin() ) { |
| 106 |
add_action( 'plugins_loaded', array( $this, 'maybe_upgrade' ), 21 ); |
| 107 |
} |
| 108 |
} |
| 109 |
|
| 110 |
/** |
| 111 |
* Run version-gated data migrations exactly once per upgrade. |
| 112 |
* |
| 113 |
* Keyed on `xspeed_data_version` rather than the plugin version header |
| 114 |
* so a migration can be added without forcing a release bump. |
| 115 |
*/ |
| 116 |
public function maybe_upgrade(): void { |
| 117 |
$current = (string) get_option( 'xspeed_data_version', '0' ); |
| 118 |
if ( version_compare( $current, self::DATA_VERSION, '>=' ) ) { |
| 119 |
return; |
| 120 |
} |
| 121 |
|
| 122 |
// 1.1.2 — strip credential values recorded by earlier versions' |
| 123 |
// settings change annotations (they're served by the trend endpoints). |
| 124 |
Activity_Log::redact_legacy_secrets(); |
| 125 |
|
| 126 |
// 1.1.4 — earlier versions cached a failed loopback as "gzip is not |
| 127 |
// active" for an hour, which showed up as a bogus server-config |
| 128 |
// warning. Drop the stale answer so the fixed probe re-runs instead |
| 129 |
// of the wrong verdict living on past the update (issue #18). |
| 130 |
delete_transient( 'xspeed_gzip_active' ); |
| 131 |
|
| 132 |
update_option( 'xspeed_data_version', self::DATA_VERSION, false ); |
| 133 |
} |
| 134 |
|
| 135 |
/** |
| 136 |
* Phase 2 of plugin init: fire the registration action (collecting |
| 137 |
* Free + Pro + any third-party modules hooked into |
| 138 |
* `xspeed_register_modules`) and boot the registry. |
| 139 |
* |
| 140 |
* Runs at plugins_loaded(20) so every add-on that hooks at any |
| 141 |
* priority < 20 has time to register first. |
| 142 |
*/ |
| 143 |
public function fire_module_lifecycle(): void { |
| 144 |
/** |
| 145 |
* Action: xspeed_register_modules |
| 146 |
* |
| 147 |
* Free modules register at priority 10; xspeed-pro at priority |
| 148 |
* 20; site code can hook in between to inject custom modules. |
| 149 |
* Fires exactly once per request. |
| 150 |
*/ |
| 151 |
do_action( 'xspeed_register_modules' ); |
| 152 |
|
| 153 |
Module_Registry::boot_all(); |
| 154 |
} |
| 155 |
|
| 156 |
/** |
| 157 |
* Register the Free Modules shipped in this plugin. Add new module |
| 158 |
* registrations here. Pro plugin hooks the same action separately. |
| 159 |
*/ |
| 160 |
public function register_free_modules(): void { |
| 161 |
Module_Registry::register( new \XSpeed\Modules\Cache\CacheModule() ); |
| 162 |
Module_Registry::register( new \XSpeed\Modules\Health\HealthModule() ); |
| 163 |
// Settings — owns no settings itself; it's the CLI/MCP surface over |
| 164 |
// Settings_Manager. Registering it is what makes `xspeed settings` |
| 165 |
// exist, which is what keeps the curated get_settings/update_settings |
| 166 |
// tools in the MCP catalog. (#149/#153) |
| 167 |
Module_Registry::register( new \XSpeed\Modules\Settings\SettingsModule() ); |
| 168 |
// External performance scores (PSI / GTmetrix) — Free, off by |
| 169 |
// default. Rendered inside the Health host page's PageSpeed tab, so |
| 170 |
// it has no sidebar row of its own. |
| 171 |
Module_Registry::register( new \XSpeed\Modules\Score\ScoreModule() ); |
| 172 |
Module_Registry::register( new \XSpeed\Modules\Preloader\PreloaderModule() ); |
| 173 |
Module_Registry::register( new \XSpeed\Modules\Heartbeat\HeartbeatModule() ); |
| 174 |
Module_Registry::register( new \XSpeed\Modules\Minify\MinifyModule() ); |
| 175 |
Module_Registry::register( new \XSpeed\Modules\Gzip\GzipModule() ); |
| 176 |
Module_Registry::register( new \XSpeed\Modules\Lazy\LazyModule() ); |
| 177 |
Module_Registry::register( new \XSpeed\Modules\Bloat\BloatModule() ); |
| 178 |
Module_Registry::register( new \XSpeed\Modules\Database\DatabaseModule() ); |
| 179 |
Module_Registry::register( new \XSpeed\Modules\Cdn\CdnModule() ); |
| 180 |
Module_Registry::register( new \XSpeed\Modules\Cloudflare\CloudflareModule() ); |
| 181 |
Module_Registry::register( new \XSpeed\Modules\ObjectCache\ObjectCacheModule() ); |
| 182 |
Module_Registry::register( new \XSpeed\Modules\BrowserCache\BrowserCacheModule() ); |
| 183 |
// Advanced Cache — a Free container row that gathers the Pro |
| 184 |
// cache-coverage features (404 / search / feed / REST / rules / |
| 185 |
// maintenance) into one sidebar sub-item (FBS-83633). |
| 186 |
Module_Registry::register( new \XSpeed\Modules\CacheCoverage\CacheCoverageModule() ); |
| 187 |
Module_Registry::register( new \XSpeed\Modules\Fonts\FontsModule() ); |
| 188 |
Module_Registry::register( new \XSpeed\Modules\ResourceHints\ResourceHintsModule() ); |
| 189 |
// AI Privacy (GDPR off-switch) ships in Free even though every AI |
| 190 |
// *feature* is Pro — privacy is a right, not a paid tier. FEATURES.md |
| 191 |
// §AI row 6 mandates it. Without this registration the module was dead |
| 192 |
// code: no REST/settings surface, the promised off-switch unreachable |
| 193 |
// (FBS-83633 Bug 1). It carries its own cli_commands() so it satisfies |
| 194 |
// the CLI/MCP coverage guard once registered. |
| 195 |
Module_Registry::register( new \XSpeed\Modules\AIPrivacy\AIPrivacyModule() ); |
| 196 |
// Migration moved Pro → Free: it's an acquisition/onboarding feature |
| 197 |
// (detect a competing caching plugin, import its settings, switch over), |
| 198 |
// so it must work without a Pro license. Agency-scale extras (profiles, |
| 199 |
// bulk multisite, host presets) remain Pro. |
| 200 |
Module_Registry::register( new \XSpeed\Modules\Migration\MigrationModule() ); |
| 201 |
// Help & Support moved Pro → Free: a ticket link + read-only system |
| 202 |
// snapshot is onboarding/diagnostics, not a paid value-add, so every |
| 203 |
// user gets it. The snapshot degrades gracefully without Pro (Pro |
| 204 |
// version/license fields fall back to defaults via defined()/get_option). |
| 205 |
Module_Registry::register( new \XSpeed\Modules\Support\SupportModule() ); |
| 206 |
// MCP remote control (AI assistants) — Free. The plugin serves the |
| 207 |
// MCP protocol at the site's own /xspeed/mcp URL; the only gate is |
| 208 |
// the per-site connection token an admin mints via Connect. No |
| 209 |
// license, no hosted infra. See IMPLEMENTATION.md §17. |
| 210 |
Module_Registry::register( new \XSpeed\Modules\Mcp\McpModule() ); |
| 211 |
} |
| 212 |
|
| 213 |
/** |
| 214 |
* Boot the opt-in usage tracker. Registers the cron sender only; the send |
| 215 |
* itself is consent-gated inside Usage_Tracker. The instance is held so the |
| 216 |
* onboarding REST handler can flip consent via usage_tracker()->opt_in(). |
| 217 |
*/ |
| 218 |
public function start_plugin_tracking(): void { |
| 219 |
$this->usage_tracker = Usage_Tracker::get_instance( |
| 220 |
XSPEED_FILE, |
| 221 |
array( |
| 222 |
'opt_in' => true, |
| 223 |
'item_id' => defined( 'XSPEED_INSIGHTS_ITEM_ID' ) ? XSPEED_INSIGHTS_ITEM_ID : false, |
| 224 |
) |
| 225 |
); |
| 226 |
$this->usage_tracker->init(); |
| 227 |
} |
| 228 |
|
| 229 |
/** |
| 230 |
* The shared Usage_Tracker singleton (or null if tracking wasn't booted, |
| 231 |
* e.g. on the activation hook before init() runs). |
| 232 |
*/ |
| 233 |
public function usage_tracker(): ?Usage_Tracker { |
| 234 |
return $this->usage_tracker; |
| 235 |
} |
| 236 |
|
| 237 |
public static function activate() { |
| 238 |
Settings::set_defaults(); |
| 239 |
|
| 240 |
// Score history table. Also called on admin_init (see init()) because |
| 241 |
// activation does not fire for a site added to a multisite network |
| 242 |
// later, nor after an update that ships a new schema version. |
| 243 |
Score_Store::maybe_install(); |
| 244 |
|
| 245 |
if ( ! file_exists( XSPEED_CACHE_DIR ) ) { |
| 246 |
wp_mkdir_p( XSPEED_CACHE_DIR ); |
| 247 |
} |
| 248 |
Cache::write_silence( XSPEED_CACHE_DIR ); |
| 249 |
|
| 250 |
// Caching is only ever ENABLED from the admin UI — see Cache::toggle() |
| 251 |
// and Rest_Api::toggle_cache(). A fresh install therefore gets no |
| 252 |
// drop-in and no wp-config.php edit here: cache_enabled is unset, so |
| 253 |
// the call below is a no-op. |
| 254 |
// |
| 255 |
// It is NOT a no-op during an upgrade. WordPress runs an update as |
| 256 |
// deactivate → wipe files → install → activate, which deletes |
| 257 |
// advanced-cache.php while cache_enabled stays true. Restoring it |
| 258 |
// here closes the window in which the site silently serves uncached |
| 259 |
// (auto_heal() alone only fires on the next wp-admin page load). |
| 260 |
Cache::restore_dropin_if_enabled(); |
| 261 |
|
| 262 |
// First-run wizard: flag a one-time redirect for the activating user. |
| 263 |
// Suppressed for bulk activations / already-completed sites in |
| 264 |
// Onboarding::maybe_redirect(). |
| 265 |
Onboarding::flag_redirect(); |
| 266 |
|
| 267 |
// Propagate activation to every registered Module. Activation |
| 268 |
// happens after plugins_loaded → modules are already registered. |
| 269 |
Module_Registry::activate_all(); |
| 270 |
} |
| 271 |
|
| 272 |
/** |
| 273 |
* Restore the cache drop-in right after THIS plugin is updated. |
| 274 |
* |
| 275 |
* Bound to upgrader_process_complete. Bulk updates, auto-updates and |
| 276 |
* host-level updaters finish without re-running activate(), so this is |
| 277 |
* the only hook that repairs the drop-in before the next wp-admin page |
| 278 |
* load. Narrow by design: bails unless the completed action was a |
| 279 |
* plugin update whose payload actually includes xspeed. |
| 280 |
* |
| 281 |
* @param \WP_Upgrader $upgrader Upgrader instance (unused). |
| 282 |
* @param array $hook_extra Contextual data about the update. |
| 283 |
* @return void |
| 284 |
*/ |
| 285 |
public function maybe_restore_after_update( $upgrader, $hook_extra ) { |
| 286 |
unset( $upgrader ); |
| 287 |
|
| 288 |
if ( ! is_array( $hook_extra ) ) { |
| 289 |
return; |
| 290 |
} |
| 291 |
if ( ! isset( $hook_extra['type'], $hook_extra['action'] ) ) { |
| 292 |
return; |
| 293 |
} |
| 294 |
if ( 'plugin' !== $hook_extra['type'] || 'update' !== $hook_extra['action'] ) { |
| 295 |
return; |
| 296 |
} |
| 297 |
|
| 298 |
// Single update uses 'plugin'; bulk uses 'plugins'. |
| 299 |
$updated = array(); |
| 300 |
if ( isset( $hook_extra['plugins'] ) && is_array( $hook_extra['plugins'] ) ) { |
| 301 |
$updated = $hook_extra['plugins']; |
| 302 |
} elseif ( isset( $hook_extra['plugin'] ) && is_string( $hook_extra['plugin'] ) ) { |
| 303 |
$updated = array( $hook_extra['plugin'] ); |
| 304 |
} |
| 305 |
|
| 306 |
$ours = plugin_basename( XSPEED_FILE ); |
| 307 |
if ( ! in_array( $ours, $updated, true ) ) { |
| 308 |
return; |
| 309 |
} |
| 310 |
|
| 311 |
Cache::restore_dropin_if_enabled(); |
| 312 |
} |
| 313 |
|
| 314 |
public static function deactivate() { |
| 315 |
// Drop-in + WP_CACHE constant are NOT touched here. WordPress |
| 316 |
// upgrades run as deactivate → wipe files → install → activate, |
| 317 |
// so removing those artifacts on every deactivate would silently |
| 318 |
// disable caching after each plugin update. uninstall.php |
| 319 |
// handles full teardown when the user actually removes the |
| 320 |
// plugin; auto_heal() restores state on the next admin_init if |
| 321 |
// the drop-in or WP_CACHE went missing for any other reason. |
| 322 |
Cache::purge_all(); |
| 323 |
Minifier::purge_minified(); |
| 324 |
Gzip::apply( false ); |
| 325 |
|
| 326 |
Module_Registry::deactivate_all(); |
| 327 |
} |
| 328 |
} |
| 329 |
|
