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;
}
?>
%2$s
'; echo esc_html__('Unable to initialize WordPress filesystem. File operations may not work correctly.', 'snaggly'); 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 '