*/ private array $services = []; /** * Enabled module instances only. * * @var array */ private array $modules = []; /** * Private constructor, use getInstance(). */ private function __construct() { } /** * Prevent cloning. */ private function __clone() { } /** * Prevent unserialization. */ public function __wakeup(): void { } /** * Get singleton instance. * * @return Plugin The result. */ public static function getInstance(): Plugin { if ( null === self::$instance ) { self::$instance = new self(); } return self::$instance; } /** * Register core services. * * Constructs SettingsStore, ModuleManager, and REST controllers. * Parses the module enable map ONCE, no module instantiation yet. */ public function registerCoreServices(): void { $settingsStore = new SettingsStore(); $enableMap = new ModuleEnableMap(); $moduleManager = new ModuleManager( $enableMap ); $settingsController = new SettingsController( $settingsStore ); $modulesController = new ModulesController(); $logController = new LogController(); $migrationRunner = new MigrationRunner(); /** * Baseline migration, establishes the module tables through the same * diff path every later version uses, so the schema can evolve. */ $migrationRunner->register( '0.1.0', static function (): void { MigrationRunner::baselineSchema(); } ); $this->services['settings'] = $settingsStore; $this->services['enable_map'] = $enableMap; $this->services['module_manager'] = $moduleManager; $this->services['settings_controller'] = $settingsController; $this->services['modules_controller'] = $modulesController; $this->services['log_controller'] = $logController; $this->services['migrations'] = $migrationRunner; // Admin UI, register only on admin screens. if ( function_exists( 'is_admin' ) && is_admin() ) { $adminMenu = new AdminMenu( $settingsStore, $enableMap ); $adminMenu->register(); $this->services['admin_menu'] = $adminMenu; add_action( 'admin_menu', [ $adminMenu, 'addGeneralPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addSchemaPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addRedirectsPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addMonitorPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addInstantIndexingPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addImporterPage' ] ); add_action( 'admin_menu', [ $adminMenu, 'addSupportPage' ] ); /* * AJAX handler for the redirect list partial refresh. * Only available to authenticated admins — wp_ajax_ not * wp_ajax_nopriv_ so unauthenticated requests are rejected * before our handler even runs. */ add_action( 'wp_ajax_rankkernel_redirects_list', static function () use ( $adminMenu ): void { $adminMenu->getRedirectsPage()->handleAjaxList(); } ); $schemaMetabox = new SchemaMetabox(); $schemaMetabox->register(); $this->services['schema_metabox'] = $schemaMetabox; // Metadata editor metabox and Gutenberg sidebar, hard gated on the // metadata module so a disabled module stays silent. if ( $enableMap->isEnabled( 'metadata' ) ) { $metadataBox = new MetadataBox( $settingsStore, null, null, null, $enableMap ); $metadataBox->register(); $this->services['metadata_box'] = $metadataBox; } } // Metadata module (optional, default-ON per activation seed). $metadataModule = new MetadataModule( $settingsStore, $enableMap ); $moduleManager->register( $metadataModule ); // Content Analysis module (optional, default-ON per activation seed). $analysisModule = new AnalysisModule( $enableMap ); $moduleManager->register( $analysisModule ); // Schema module (optional, default-ON per activation seed). $schemaModule = new SchemaModule( $settingsStore, $enableMap ); $moduleManager->register( $schemaModule ); // Breadcrumbs module (optional, default-ON per activation seed). $breadcrumbsModule = new BreadcrumbsModule( $enableMap ); $moduleManager->register( $breadcrumbsModule ); // Sitemaps module (optional, default-ON per activation seed). $sitemapsModule = new SitemapsModule( $enableMap ); $moduleManager->register( $sitemapsModule ); // Redirects module (optional, default off). $redirectsModule = new RedirectsModule( $enableMap ); $moduleManager->register( $redirectsModule ); // 404 Monitor module (optional, default off). $monitorModule = new MonitorModule( $enableMap ); $moduleManager->register( $monitorModule ); // Crawl Signals module (optional, default off). $robotsModule = new RobotsModule( $enableMap ); $moduleManager->register( $robotsModule ); // Instant Indexing module (optional, default off, and its auto // submit control defaults to off too, so two deliberate opt-ins // stand between an install and any outbound request). $instantIndexingModule = new InstantIndexingModule( $enableMap ); $moduleManager->register( $instantIndexingModule ); // Importer module (optional, default off, admin screen only). $importerModule = new ImporterModule( $enableMap ); $moduleManager->register( $importerModule ); add_action( 'init', [ $migrationRunner, 'maybeRun' ], 10 ); // Evaluate module enable map once. $moduleManager->evaluateAll(); // Register REST routes on rest_api_init (core service, always on). add_action( 'rest_api_init', function () use ( $settingsController, $modulesController, $logController ): void { $settingsController->registerRoutes(); $modulesController->registerRoutes(); $logController->registerRoutes(); } ); } /** * Boot enabled modules. * * Delegates to ModuleManager::bootEnabled() which instantiates + boots * only enabled modules, enforcing dependsOn(). */ public function bootModules(): void { $manager = $this->services['module_manager'] ?? null; if ( ! $manager instanceof ModuleManager ) { return; } $manager->bootEnabled(); $this->modules = $manager->enabledModules(); } /** * Get enabled module instances (after bootModules). * * @return array */ public function modules(): array { return $this->modules; } /** * Service locator. * * @param string $id Service id. * @return mixed Service instance. * @throws \RuntimeException If service not found. */ public function get( string $id ): mixed { if ( ! array_key_exists( $id, $this->services ) ) { // Exception text is not HTML output. Escaping it here would double escape it if a display site ever renders the message. // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped -- internal exception message, never echoed, escaping is applied at any display site. throw new \RuntimeException( sprintf( 'RankKernel service not found: %s', $id ) ); } return $this->services[ $id ]; } }