settings = SnagglySettings::get_instance(); $this->init_hooks(); } /** * Initialize hooks */ protected function init_hooks() { add_action('admin_menu', array($this, 'add_admin_menu'), 9); add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts')); add_action('admin_init', array($this, 'register_settings')); add_action('admin_post_snaggly_settings', array($this, 'handle_settings_submission')); add_action('admin_notices', array($this, 'add_admin_notices')); // Media Library integration: surface which attachments Snaggly // downloaded, and let admins filter the list down to just those. add_filter('manage_media_columns', array($this, 'add_media_column')); add_action('manage_media_custom_column', array($this, 'render_media_column'), 10, 2); add_action('restrict_manage_posts', array($this, 'render_media_filter_dropdown')); add_action('pre_get_posts', array($this, 'apply_media_filter_query')); } /** * Add a "Snaggly" column to the Media Library list table. * * @param array $columns * @return array */ public function add_media_column($columns) { $columns['snaggly'] = __('Snaggly', 'snaggly'); return $columns; } /** * Render the "Snaggly" column: the original remote URL an attachment * was downloaded from, if any. * * @param string $column_name * @param int $attachment_id */ public function render_media_column($column_name, $attachment_id) { if ($column_name !== 'snaggly') { return; } $original_url = get_post_meta($attachment_id, '_snaggly_original_url', true); if (empty($original_url)) { echo '—'; return; } $download_date = get_post_meta($attachment_id, '_snaggly_download_date', true); printf( '%2$s', esc_attr($original_url), esc_html__('Downloaded', 'snaggly') ); if (!empty($download_date)) { $timestamp = strtotime($download_date); if ($timestamp) { printf('
%s', esc_html(date_i18n(get_option('date_format'), $timestamp))); } } } /** * Add a "Downloaded by Snaggly" filter dropdown above the Media Library * list table. * * @param string $post_type */ public function render_media_filter_dropdown($post_type) { if ($post_type !== 'attachment') { return; } // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only Media Library display filter; no state changes or privileged action. $current = isset($_GET['snaggly_filter']) ? sanitize_text_field(wp_unslash($_GET['snaggly_filter'])) : ''; ?> is_main_query()) { return; } if ($query->get('post_type') !== 'attachment') { return; } // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only list filter, not a state-changing action if (!isset($_GET['snaggly_filter']) || $_GET['snaggly_filter'] !== 'downloaded') { return; } $meta_query = (array) $query->get('meta_query'); $meta_query[] = array( 'key' => '_snaggly_original_url', 'compare' => 'EXISTS', ); $query->set('meta_query', $meta_query); } /** * Get the capability required to manage Snaggly, honoring the * snaggly_required_capability filter. * * @return string */ protected function required_cap() { return function_exists('snaggly_required_cap') ? snaggly_required_cap() : 'manage_options'; } /** * Add admin menu items */ public function add_admin_menu() { add_management_page( __('Snaggly', 'snaggly'), __('Snaggly', 'snaggly'), $this->required_cap(), 'snaggly', array($this, 'render_main_page') ); add_options_page( __('Snaggly Settings', 'snaggly'), __('Snaggly', 'snaggly'), $this->required_cap(), 'snaggly-settings', array($this, 'render_settings_page') ); } /** * Enqueue admin scripts and styles * * @param string $hook */ public function enqueue_admin_scripts($hook) { if ($hook === 'upload.php') { wp_enqueue_style('snaggly-media', SNAGGLY_PLUGIN_URL . 'assets/css/media.css', array(), SNAGGLY_VERSION); } if (!in_array($hook, array('tools_page_snaggly', 'settings_page_snaggly-settings'), true)) { return; } wp_enqueue_script('jquery'); wp_enqueue_script('jquery-ui-progressbar'); wp_enqueue_script( 'snaggly-admin', apply_filters('snaggly_admin_script_url', SNAGGLY_PLUGIN_URL . 'assets/js/admin.js'), array('jquery', 'jquery-ui-progressbar'), SNAGGLY_VERSION, true ); wp_enqueue_style( 'snaggly-variables', SNAGGLY_PLUGIN_URL . 'assets/css/components/variables.css', array(), SNAGGLY_VERSION ); wp_enqueue_style( 'snaggly-buttons', SNAGGLY_PLUGIN_URL . 'assets/css/components/buttons.css', array('snaggly-variables'), SNAGGLY_VERSION ); wp_enqueue_style( 'snaggly-admin', SNAGGLY_PLUGIN_URL . 'assets/css/admin.css', array('wp-jquery-ui-dialog', 'snaggly-variables', 'snaggly-buttons'), SNAGGLY_VERSION ); wp_localize_script('snaggly-admin', 'snagglyAjax', array( 'ajax_url' => admin_url('admin-ajax.php'), 'nonce' => wp_create_nonce('snaggly_ajax_nonce'), 'strings' => $this->get_localized_strings(), )); } /** * Localized JS strings for admin.js. * * @return array */ protected function get_localized_strings() { return array( 'dismiss_failed' => __('Could not dismiss the callout. Please try again.', 'snaggly'), 'scanning' => __('Scanning...', 'snaggly'), 'downloading' => __('Downloading...', 'snaggly'), 'completed' => __('Completed', 'snaggly'), 'error' => __('Error', 'snaggly'), 'confirm_download' => __('Are you sure you want to download the selected files?', 'snaggly'), 'no_files_selected' => __('Please select at least one file to download.', 'snaggly'), 'scan_complete' => __('Scan completed!', 'snaggly'), 'download_complete' => __('Download completed!', 'snaggly'), 'invalid_extensions' => __('Extensions should contain only letters and numbers', 'snaggly'), 'invalid_file_size' => __('File size must be a valid number', 'snaggly'), 'invalid_timeout' => __('Timeout must be between 5 and 300 seconds', 'snaggly'), 'filter_cleared' => __('Filter cleared', 'snaggly'), 'filters_cleared' => __('Filters cleared', 'snaggly'), 'no_results_found' => __('No results found for your filter', 'snaggly'), 'starting_scan' => __('Starting scan for remote links...', 'snaggly'), // translators: %1$s is the minimum value, %2$s is the maximum value 'value_between' => __('Value must be between %1$s and %2$s', 'snaggly'), 'export_csv' => __('Export CSV', 'snaggly'), 'export_json' => __('Export JSON', 'snaggly'), // translators: %s is the error message 'scan_failed' => __('Scan failed: %s', 'snaggly'), 'scan_start_failed' => __('Failed to start scan. Please try again.', 'snaggly'), 'scan_cancelled' => __('Scan cancelled by user.', 'snaggly'), 'download_request_failed' => __('Download request failed. Please try again.', 'snaggly'), // translators: %s is the error message 'download_failed' => __('Download failed: %s', 'snaggly'), 'download_confirm_single' => __('Download this file?', 'snaggly'), 'loading' => __('Loading...', 'snaggly'), 'unknown' => __('Unknown', 'snaggly'), 'request_failed' => __('Request failed', 'snaggly'), 'info' => __('Info', 'snaggly'), 'download' => __('Download', 'snaggly'), 'run_diagnostic' => __('Run Diagnostic', 'snaggly'), 'download_cancelled' => __('Download cancelled', 'snaggly'), 'no_files_found' => __('No files to download', 'snaggly'), 'queued' => __('Queued', 'snaggly'), 'downloaded' => __('Downloaded', 'snaggly'), 'all_files_downloaded' => __('All files have already been downloaded', 'snaggly'), ); } /** * Register settings */ public function register_settings() { register_setting( 'snaggly_settings_group', 'snaggly_settings', array($this->settings, 'validate_settings') ); } /** * Handle settings form submission */ public function handle_settings_submission() { if (!current_user_can($this->required_cap())) { wp_die(esc_html__('You do not have sufficient permissions to access this page.', 'snaggly')); } $nonce = isset($_POST['snaggly_settings_nonce']) && is_string($_POST['snaggly_settings_nonce']) ? sanitize_text_field(wp_unslash($_POST['snaggly_settings_nonce'])) : ''; if (empty($nonce) || !wp_verify_nonce($nonce, 'snaggly_settings_action')) { wp_die(esc_html__('Security check failed.', 'snaggly')); } $input_settings = $this->sanitize_submitted_settings(); // Convert max_file_size from MB to bytes if submitted if (isset($input_settings['max_file_size_mb'])) { $input_settings['max_file_size'] = floatval($input_settings['max_file_size_mb']) * 1048576; unset($input_settings['max_file_size_mb']); } $validated_settings = $this->settings->validate_settings($input_settings); $current_settings = get_option('snaggly_settings', array()); $saved = update_option('snaggly_settings', $validated_settings); // update_option() returns false if the value is unchanged, so check // whether it actually failed vs. simply had nothing new to save. $settings_changed = ($current_settings !== $validated_settings); $save_successful = $saved || !$settings_changed; if ($save_successful) { $this->settings->reload_settings(); } $redirect_url = admin_url('options-general.php?page=snaggly-settings'); $redirect_url = add_query_arg( $save_successful ? 'snaggly_updated' : 'snaggly_error', wp_create_nonce($save_successful ? 'snaggly_settings_updated' : 'snaggly_settings_error'), $redirect_url ); wp_safe_redirect($redirect_url); exit; } /** * Sanitize the raw $_POST['snaggly_settings'] payload into a flat, * type-appropriate array ready for SnagglySettings::validate_settings(). * * @return array */ protected function sanitize_submitted_settings() { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Verified by handle_settings_submission() before this helper is called. return SnagglySettings::sanitize_input(isset($_POST['snaggly_settings']) ? map_deep(wp_unslash($_POST['snaggly_settings']), 'sanitize_text_field') : array()); } /** Render the optional, per-user Pro introduction on Snaggly screens only. */ protected function render_pro_callout() { if (defined('SNAGGLY_PRO_VERSION') || get_user_meta(get_current_user_id(), '_snaggly_pro_callout_dismissed', true)) { return; } ?>

v

render_pro_callout(); ?>

settings->get_all(); ?>

v

render_pro_callout(); ?>
render_general_settings_section($settings); $this->render_content_settings_section($settings); $this->render_scanning_settings_section($settings); $this->render_file_management_section($settings); ?>
render_advanced_tools_section(); ?>

MB

seconds

settings->get_user_agent()); ?>

true), 'objects'); $selected_types = $settings['scan_post_types']; foreach ($post_types as $post_type) { $checked = in_array($post_type->name, $selected_types, true) ? 'checked' : ''; ?>

render_toggle( 'auto_update_content', $settings['auto_update_content'], __('Auto-update Content', 'snaggly'), __('Automatically replace remote URLs with local URLs after download', 'snaggly') ); $this->render_toggle( 'preserve_original_urls', $settings['preserve_original_urls'], __('Preserve Original URLs', 'snaggly'), __('Add original URLs as HTML comments when updating content', 'snaggly') ); $this->render_toggle( 'group_duplicate_urls', $settings['group_duplicate_urls'], __('Group Duplicate URLs', 'snaggly'), __('Download each unique remote file only once, even if it appears in multiple posts. This improves efficiency and reduces bandwidth usage.', 'snaggly') ); ?>

render_toggle( 'scan_private_posts', $settings['scan_private_posts'], __('Scan Private Posts', 'snaggly'), __('Include private posts/pages when scanning, in addition to published content.', 'snaggly') ); ?>

render_toggle( 'rate_limiting_enabled', $settings['rate_limiting_enabled'], __('Rate Limiting', 'snaggly'), __('Throttle repeated scan/download AJAX requests per user to protect the server from abuse or accidental overload.', 'snaggly') ); ?>

since these act immediately via AJAX rather than on * settings-form submit). */ protected function render_advanced_tools_section() { ?>

๐Ÿ”„

๐Ÿ“‹

๐Ÿ“

๐Ÿงน

โฑ๏ธ

โ†ฉ๏ธ

id, $snaggly_pages, true)) { return; } $this->maybe_render_settings_notice('snaggly_updated', 'snaggly_settings_updated', 'success', __('Settings saved successfully!', 'snaggly')); $this->maybe_render_settings_notice('snaggly_error', 'snaggly_settings_error', 'error', __('Error saving settings. Please try again.', 'snaggly')); $this->maybe_render_filesystem_notice(); } /** * Render a settings-saved/error admin notice if the query arg carries a * valid nonce for the given action. * * Note: the query arg's *value* is itself the nonce (see * handle_settings_submission()) โ€” it is never the literal string * "true", so this checks isset() + wp_verify_nonce() only. * * @param string $query_arg * @param string $nonce_action * @param string $notice_type 'success' or 'error' * @param string $message */ protected function maybe_render_settings_notice($query_arg, $nonce_action, $notice_type, $message) { if (!isset($_GET[$query_arg])) { return; } $nonce = sanitize_text_field(wp_unslash($_GET[$query_arg])); if (!wp_verify_nonce($nonce, $nonce_action)) { return; } printf( '

%2$s

', esc_attr($notice_type), esc_html($message) ); } /** * Warn if the uploads directory isn't writable (downloads will fail). */ protected function maybe_render_filesystem_notice() { $upload_dir = wp_upload_dir(); if (!WP_Filesystem()) { echo '

'; echo esc_html__('Unable to initialize WordPress filesystem. File operations may not work correctly.', 'snaggly'); echo '

'; return; } global $wp_filesystem; if (!$wp_filesystem->is_writable($upload_dir['basedir'])) { echo '

'; printf( /* translators: %s is the upload directory path */ esc_html__('Upload directory is not writable: %s. Downloads may fail.', 'snaggly'), esc_html($upload_dir['basedir']) ); echo '

'; } } }