init_hooks(); } /** * Initialize WordPress hooks */ private function init_hooks() { add_action('init', array($this, 'init')); add_action('plugins_loaded', array($this, 'load_textdomain')); add_action('snaggly_cleanup_expired_sessions', array('SnagglyScanner', 'cleanup_expired_sessions')); // Provide default SSL verify behavior for AJAX helpers add_filter('snaggly_ajax_sslverify', array($this, 'default_ajax_sslverify')); // "Settings" link on the Plugins list page add_filter('plugin_action_links_' . SNAGGLY_PLUGIN_BASENAME, array($this, 'add_settings_link')); // Activation and deactivation hooks register_activation_hook(SNAGGLY_PLUGIN_FILE, array($this, 'activate')); register_deactivation_hook(SNAGGLY_PLUGIN_FILE, array($this, 'deactivate')); } /** * Initialize plugin functionality * * @since 1.0.0 * @return void */ public function init(): void { try { $this->load_dependencies(); do_action('snaggly_dependencies_loaded'); $this->init_components(); $this->check_for_updates(); do_action('snaggly_initialized'); } catch (Exception $e) { if (class_exists('SnagglyLogger')) { SnagglyLogger::get_instance()->error('Error during initialization', ['exception' => $e->getMessage()]); } } } /** * Load plugin dependencies */ private function load_dependencies(): void { // Core classes, in dependency order: shared utilities first, // then classes that use them. $core_files = [ 'includes/class-free-edition.php', 'includes/class-settings.php', 'includes/class-logger.php', 'includes/class-rate-limiter.php', 'includes/class-url-validator.php', 'includes/class-memory-utils.php', 'includes/class-db-optimizer.php', 'includes/class-scanner.php', 'includes/class-downloader.php', 'includes/class-ajax-handler.php', ]; foreach ($core_files as $file) { $file_path = SNAGGLY_PLUGIN_DIR . $file; if (file_exists($file_path)) { require_once $file_path; } elseif (class_exists('SnagglyLogger')) { SnagglyLogger::get_instance()->warning('Required file not found', ['file_path' => $file_path]); } } // Admin interface (only in admin) if (is_admin()) { $admin_file = SNAGGLY_PLUGIN_DIR . 'includes/class-admin.php'; if (file_exists($admin_file)) { require_once $admin_file; } elseif (class_exists('SnagglyLogger')) { SnagglyLogger::get_instance()->warning('Admin file not found', ['file_path' => $admin_file]); } } } /** * Initialize plugin components */ private function init_components(): void { try { if (class_exists('SnagglySettings')) { SnagglySettings::get_instance(); } if (class_exists('SnagglyAjaxHandler')) { SnagglyAjaxHandler::get_instance(); } if (is_admin() && class_exists('SnagglyAdmin')) { SnagglyAdmin::get_instance(); } // Free uses WordPress updates and does not require a license. } catch (Exception $e) { if (class_exists('SnagglyLogger')) { SnagglyLogger::get_instance()->error('Error initializing components', ['exception' => $e->getMessage()]); } } } /** * Load plugin text domain for translations * * @since 1.0.0 * @deprecated Since WordPress 4.6, this is handled automatically for plugins hosted on WordPress.org */ public function load_textdomain(): void { // WordPress 4.6+ automatically loads plugin textdomains for plugins hosted on WordPress.org. // Kept for backward compatibility; intentionally a no-op. } /** * Default SSL verification behavior for AJAX requests * * @param bool $sslverify Current SSL verify setting * @return bool Modified SSL verify setting */ public function default_ajax_sslverify(bool $sslverify): bool { return $sslverify && SnagglyUrlValidator::should_verify_ssl(); } /** * Add a "Settings" link to the plugin's row on the Plugins list page. * * @param array $links * @return array */ public function add_settings_link(array $links): array { $settings_link = sprintf( '%s', esc_url(admin_url('options-general.php?page=snaggly-settings')), esc_html__('Settings', 'snaggly') ); array_unshift($links, $settings_link); return $links; } /** * Plugin activation * * @since 1.0.0 * @return void */ public function activate(): void { register_uninstall_hook(SNAGGLY_PLUGIN_FILE, array(__CLASS__, 'uninstall')); // Load dependencies first so we can pull defaults from // SnagglySettings rather than keeping a second, separately // maintained copy of the defaults array here. $this->load_dependencies(); $default_settings = class_exists('SnagglySettings') ? SnagglySettings::get_instance()->get_defaults() : array(); add_option('snaggly_settings', $default_settings); add_option('snaggly_version', SNAGGLY_VERSION); if (!wp_next_scheduled('snaggly_cleanup_expired_sessions')) { wp_schedule_event(time(), 'daily', 'snaggly_cleanup_expired_sessions'); } wp_cache_flush(); // Use WordPress's existing indexes; activation must not alter core tables. } /** * Plugin deactivation * * @since 1.0.0 * @return void */ public function deactivate(): void { wp_clear_scheduled_hook('snaggly_cleanup_expired_sessions'); wp_cache_flush(); } /** * Get plugin version */ public static function get_version(): string { return SNAGGLY_VERSION; } /** * Get plugin directory path */ public static function get_plugin_dir(): string { return SNAGGLY_PLUGIN_DIR; } /** * Get plugin URL */ public static function get_plugin_url(): string { return SNAGGLY_PLUGIN_URL; } /** * Check for plugin updates and run upgrade routines * * @since 1.0.0 */ private function check_for_updates(): void { $current_version = get_option('snaggly_version', '0.0.0'); if (version_compare($current_version, SNAGGLY_VERSION, '<')) { $this->upgrade_routine($current_version); update_option('snaggly_version', SNAGGLY_VERSION); wp_cache_flush(); } } /** * Run upgrade routines for different versions * * @since 1.0.0 * @param string $from_version Version upgrading from */ private function upgrade_routine(string $from_version): void { if (class_exists('SnagglyLogger')) { SnagglyLogger::get_instance()->info('Plugin upgrade', [ 'from_version' => $from_version, 'to_version' => SNAGGLY_VERSION, ]); } // Future upgrade routines can be added here, e.g.: // if (version_compare($from_version, '1.8.0', '<')) { // $this->upgrade_to_1_7_0(); // } $this->clear_plugin_caches(); } /** * Clear plugin-specific caches * * @since 1.0.0 */ private function clear_plugin_caches(): void { $cache_key = 'snaggly_clear_caches_' . md5('transients'); $cached_result = wp_cache_get($cache_key, 'snaggly'); if (false === $cached_result) { $this->clear_snaggly_transients(); wp_cache_set($cache_key, true, 'snaggly', 300); } } /** * Clear Snaggly transients using WordPress functions * * @since 1.0.0 */ private function clear_snaggly_transients(): void { foreach ($this->get_snaggly_transients() as $transient) { delete_transient($transient); } } /** * Get all Snaggly transients * * @since 1.0.0 * @return array List of transient names */ private function get_snaggly_transients(): array { return self::get_snaggly_transients_for_cleanup(); } /** * Plugin uninstall * * @since 1.0.0 * @return void */ public static function uninstall(): void { if (!current_user_can('manage_options')) { return; } delete_option('snaggly_settings'); delete_option('snaggly_version'); delete_option('snaggly_diagnostic_logs'); $cleanup_cache_key = 'snaggly_uninstall_cleanup_' . md5('transients_meta'); $recent_cleanup = wp_cache_get($cleanup_cache_key, 'snaggly'); if (false === $recent_cleanup) { try { self::cleanup_snaggly_transients(); self::cleanup_snaggly_post_meta(); wp_cache_set($cleanup_cache_key, time(), 'snaggly', 3600); } catch (\Throwable $e) { // Silently fail - don't block uninstall if cleanup fails } } wp_clear_scheduled_hook('snaggly_cleanup_expired_sessions'); wp_cache_flush(); } /** * Clean up Snaggly transients using WordPress functions * * @since 1.0.0 */ private static function cleanup_snaggly_transients(): void { foreach (self::get_snaggly_transients_for_cleanup() as $transient) { delete_transient($transient); } } /** * Get all Snaggly transients for cleanup * * @since 1.0.0 * @return array List of transient names */ private static function get_snaggly_transients_for_cleanup(): array { global $wpdb; // Expiring transients are not autoloaded, so query their names explicitly. // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching -- One-time upgrade/uninstall cleanup must include non-autoloaded transient records. $option_names = $wpdb->get_col($wpdb->prepare( "SELECT option_name FROM {$wpdb->options} WHERE option_name LIKE %s", $wpdb->esc_like('_transient_snaggly_') . '%' )); return array_map(static function ($name) { return substr($name, strlen('_transient_')); }, $option_names); } /** * Clean up Snaggly post meta using WordPress functions * * @since 1.0.0 */ private static function cleanup_snaggly_post_meta(): void { foreach (self::get_posts_with_snaggly_meta() as $post_id) { $post_id = (int) $post_id; foreach (self::get_snaggly_meta_keys_for_post($post_id) as $meta_key) { delete_post_meta($post_id, $meta_key); } } } /** * Get posts that have Snaggly meta data * * @since 1.0.0 * @return array List of post IDs */ private static function get_posts_with_snaggly_meta(): array { $cache_key = 'snaggly_posts_with_meta'; $post_ids = wp_cache_get($cache_key, 'snaggly'); if (false !== $post_ids) { return $post_ids; } global $wpdb; /* phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery -- Performance optimization: meta_query with LIKE is too slow */ $post_ids = $wpdb->get_col($wpdb->prepare(" SELECT DISTINCT p.ID FROM {$wpdb->posts} p INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id WHERE pm.meta_key LIKE %s ORDER BY p.ID ASC ", $wpdb->esc_like('_snaggly_') . '%')); wp_cache_set($cache_key, $post_ids, 'snaggly', 600); return $post_ids; } /** * Get Snaggly meta keys for a specific post * * @since 1.0.0 * @param int $post_id Post ID * @return array List of meta keys */ private static function get_snaggly_meta_keys_for_post(int $post_id): array { $cache_key = 'snaggly_meta_keys_post_' . $post_id; $meta_keys = wp_cache_get($cache_key, 'snaggly'); if (false !== $meta_keys) { return $meta_keys; } $all_meta = get_post_meta($post_id); $snaggly_meta_keys = array(); foreach ($all_meta as $meta_key => $meta_value) { if (strpos($meta_key, '_snaggly_') === 0) { $snaggly_meta_keys[] = $meta_key; } } wp_cache_set($cache_key, $snaggly_meta_keys, 'snaggly', 600); return $snaggly_meta_keys; } } } // Initialize the plugin Snaggly::get_instance();