cloudProviderFactory = $cloudProviderFactory ?: new CloudProviderFactory(); // Get available providers from the factory $this->cloud_providers = $this->cloudProviderFactory::getAvailableProviders(); // Register hooks $this->register_hooks(); } public static function getInstance(?CloudProviderFactory $cloudProviderFactory = null): self { if (self::$instance === null) { self::$instance = new self($cloudProviderFactory); } return self::$instance; } public static function create(CloudProviderFactory $cloudProviderFactory): self { return new self($cloudProviderFactory); } /** * Create an instance of the selected cloud provider. * * @param string $provider_key The cloud provider key. * @return \Advanced_Media_Offloader\Abstracts\S3_Provider|null */ protected function createCloudProvider(string $provider_key) { try { return $this->cloudProviderFactory::create($provider_key); } catch (\Exception $e) { error_log('ADVMO Error: ' . $e->getMessage()); return null; } } private function register_hooks() { add_action('admin_menu', [$this, 'add_settings_page']); add_action('admin_init', [$this, 'initialize']); add_action('admin_enqueue_scripts', [$this, 'enqueue_scripts']); add_action('wp_ajax_advmo_test_connection', [$this, 'check_connection_ajax']); add_action('wp_ajax_advmo_save_general_settings', [$this, 'save_general_settings_ajax']); add_action('wp_ajax_advmo_save_credentials', [$this, 'save_credentials_ajax']); add_action('wp_ajax_advmo_get_provider_credentials', [$this, 'get_provider_credentials_html_ajax']); } public function initialize() { register_setting('advmo', 'advmo_settings', [ 'sanitize_callback' => [$this, 'sanitize'] ]); register_setting('advmo', 'advmo_credentials', [ 'sanitize_callback' => [$this, 'sanitize_credentials'] ]); $this->add_settings_section(); $this->add_provider_field(); $this->add_credentials_field(); $this->add_auto_offload_field(); $this->add_retention_policy_field(); $this->add_path_prefix_field(); $this->add_object_versioning_field(); $this->add_mirror_delete_field(); } private function add_settings_section() { add_settings_section( 'cloud_provider', __('Cloud Provider', 'advanced-media-offloader'), function () { echo '

' . esc_attr__('Select a cloud storage provider and provide the necessary credentials.', 'advanced-media-offloader') . '

'; }, 'advmo', [ 'before_section' => '
', 'after_section' => '
', ] ); add_settings_section( 'general_settings', __('General Settings', 'advanced-media-offloader'), function () { echo '

' . esc_attr__('Configure the core options for managing and offloading your media files to cloud storage.', 'advanced-media-offloader') . '

'; }, 'advmo', [ 'before_section' => '
', 'after_section' => '
', ] ); } private function add_provider_field() { add_settings_field( 'cloud_provider', __('Cloud Provider', 'advanced-media-offloader'), [$this, 'cloud_provider_field'], 'advmo', 'cloud_provider', [ 'class' => 'advmo-field advmo-cloud-provider', ] ); } private function add_credentials_field() { add_settings_field( 'advmo_cloud_provider_credentials', __('Credentials', 'advanced-media-offloader'), [$this, 'cloud_provider_credentials_field'], 'advmo', 'cloud_provider', [ 'class' => 'advmo-field advmo-cloud-provider-credentials', ] ); } private function add_retention_policy_field() { add_settings_field( 'retention_policy', __('Retention Policy', 'advanced-media-offloader'), [$this, 'retention_policy_field'], 'advmo', 'general_settings', [ 'class' => 'advmo-field advmo-retention_policy', ] ); } private function add_mirror_delete_field() { add_settings_field( 'mirror_delete', __('Mirror Delete', 'advanced-media-offloader'), [$this, 'mirror_delete_field'], 'advmo', 'general_settings', [ 'class' => 'advmo-field advmo-mirror-delete', ] ); } private function add_auto_offload_field() { add_settings_field( 'auto_offload_uploads', __('Auto-Offload Media', 'advanced-media-offloader'), [$this, 'auto_offload_field'], 'advmo', 'general_settings', [ 'class' => 'advmo-field advmo-auto-offload', ] ); } private function add_object_versioning_field() { add_settings_field( 'object_versioning', __('File Versioning', 'advanced-media-offloader'), [$this, 'object_versioning_field'], 'advmo', 'general_settings', [ 'class' => 'advmo-field advmo-object-versioning', ] ); } private function add_path_prefix_field() { add_settings_field( 'path_prefix', __('Custom Path Prefix', 'advanced-media-offloader'), [$this, 'path_prefix_field'], 'advmo', 'general_settings', [ 'class' => 'advmo-field advmo-path-prefix', ] ); } public function path_prefix_field() { $options = get_option('advmo_settings'); $path_prefix = isset($options['path_prefix']) ? $options['path_prefix'] : "wp-content/uploads/"; $path_prefix_Active = isset($options['path_prefix_active']) ? $options['path_prefix_active'] : 0; echo '
'; echo ''; echo ''; echo '

' . '' . '

'; echo '

' . esc_html__('Add a common prefix to organize offloaded media files from this site in your cloud storage bucket.', 'advanced-media-offloader') . '

'; echo '
'; } public function object_versioning_field() { $options = get_option('advmo_settings'); $object_versioning = isset($options['object_versioning']) ? $options['object_versioning'] : 0; echo '
'; echo ''; echo ''; echo '

' . esc_html__('Automatically add unique timestamps to your media file paths to ensure the latest versions are always delivered. This prevents outdated content from being served due to CDN caching, even when you replace files with the same name. Eliminate manual cache invalidation and guarantee your visitors always see the most up-to-date media.', 'advanced-media-offloader') . '

'; echo '
'; } public function mirror_delete_field() { $options = get_option('advmo_settings'); $mirror_delete = isset($options['mirror_delete']) ? intval($options['mirror_delete']) : 0; echo '
'; echo ''; echo ''; echo '

' . esc_html__('When enabled, deleting a media file in WordPress will also remove it from your cloud storage.', 'advanced-media-offloader') . '

'; echo '
'; } public function auto_offload_field() { $options = get_option('advmo_settings'); $auto_offload_uploads = isset($options['auto_offload_uploads']) ? intval($options['auto_offload_uploads']) : 1; echo '
'; echo ''; echo ''; echo '

' . esc_html__('Automatically send new uploads to cloud storage. Note: Existing offloaded files will always load from the cloud, even if this is disabled.', 'advanced-media-offloader') . '

'; echo '
'; } public function retention_policy_field() { $options = get_option('advmo_settings'); $retention_policy = isset($options['retention_policy']) ? intval($options['retention_policy']) : 0; echo '
'; echo '
'; echo ''; echo ''; echo '

' . esc_html__('Keep all files on your local server after offloading to the cloud. This option provides redundancy but uses more local storage.', 'advanced-media-offloader') . '

'; echo '
'; echo '
'; echo ''; echo ''; echo '

' . esc_html__('Remove local copies after cloud offloading, but keep the original file as a backup. Balances storage efficiency with data safety.', 'advanced-media-offloader') . '

'; echo '
'; echo '
'; echo ''; echo ''; echo '

' . esc_html__('Remove all local files, including originals, after successful cloud offloading. Maximizes local storage savings but relies entirely on cloud storage.', 'advanced-media-offloader') . '

'; echo '
'; echo '
'; } public function sanitize($options) { if (!current_user_can('manage_options')) { return; } // Initialize sanitized options with defaults $sanitized = [ 'cloud_provider' => '', 'retention_policy' => 0, 'object_versioning' => 0, 'path_prefix' => '', 'mirror_delete' => 0, 'path_prefix_active' => 0, 'auto_offload_uploads' => 1 ]; try { // Validate and sanitize cloud provider $sanitized['cloud_provider'] = $this->sanitizeCloudProvider($options); // Sanitize retention policy $sanitized['retention_policy'] = $this->sanitizeRetentionPolicy($options); // Sanitize object versioning $sanitized['object_versioning'] = $this->sanitizeObjectVersioning($options); // Sanitize path prefix $sanitized['path_prefix'] = $this->sanitizePathPrefix($options); // Sanitize mirror delete $sanitized['mirror_delete'] = isset($options['mirror_delete']) && (int) $options['mirror_delete'] === 1 ? 1 : 0; // Sanitize path prefix active $sanitized['path_prefix_active'] = isset($options['path_prefix_active']) && (int) $options['path_prefix_active'] === 1 ? 1 : 0; // Sanitize auto offload uploads $sanitized['auto_offload_uploads'] = isset($options['auto_offload_uploads']) && (int) $options['auto_offload_uploads'] === 1 ? 1 : 0; add_settings_error( 'advmo_messages', 'advmo_message', __('Settings Saved', 'advanced-media-offloader'), 'updated' ); return $sanitized; } catch (\Exception $e) { add_settings_error( 'advmo_messages', 'advmo_message', $e->getMessage(), 'error' ); return $options; } } /** * Sanitize and save cloud provider credentials * * @param array $credentials * @return array */ public function sanitize_credentials($credentials) { if (!current_user_can('manage_options')) { return get_option('advmo_credentials', []); } if (empty($credentials) || !is_array($credentials)) { return get_option('advmo_credentials', []); } // Get existing credentials to preserve other providers $sanitized = get_option('advmo_credentials', []); // Define checkbox fields that need special handling (unchecked checkboxes don't appear in POST) $checkbox_fields = ['path_style_endpoint', 'append_bucket_to_domain']; foreach ($credentials as $provider_key => $provider_credentials) { if (!is_array($provider_credentials)) { continue; } $sanitized[$provider_key] = []; foreach ($provider_credentials as $field_name => $field_value) { // Skip if constant is defined (constants take priority) $constant_name = 'ADVMO_' . strtoupper($provider_key) . '_' . strtoupper($field_name); if (defined($constant_name)) { continue; } // Sanitize based on field type if (in_array($field_name, ['endpoint', 'domain'])) { // URLs - normalize and validate $sanitized[$provider_key][$field_name] = advmo_normalize_url($field_value); } elseif (in_array($field_name, ['key', 'secret'])) { // API keys/secrets - sanitize as text, preserve special characters $sanitized[$provider_key][$field_name] = sanitize_text_field($field_value); } elseif (in_array($field_name, $checkbox_fields)) { // Boolean values (checkboxes) - '1' = checked, '0' or anything else = unchecked $sanitized[$provider_key][$field_name] = ($field_value === '1' || $field_value === 1) ? 1 : 0; } else { // Other fields (bucket, region, etc.) - sanitize as text $sanitized[$provider_key][$field_name] = sanitize_text_field($field_value); } } // Handle unchecked checkboxes - they don't appear in POST, so set them to 0 explicitly foreach ($checkbox_fields as $checkbox_field) { // Skip if constant is defined (constants take priority) $constant_name = 'ADVMO_' . strtoupper($provider_key) . '_' . strtoupper($checkbox_field); if (defined($constant_name)) { continue; } // If checkbox field is not in POST data, it means it's unchecked, so set it to 0 if (!isset($provider_credentials[$checkbox_field])) { $sanitized[$provider_key][$checkbox_field] = 0; } } } return $sanitized; } /** * Sanitizes the cloud provider setting * * @param array $options * @return string * @throws Exception */ private function sanitizeCloudProvider(array $options): string { $provider = sanitize_text_field(isset($options['cloud_provider']) ? $options['cloud_provider'] : ''); if (!array_key_exists($provider, $this->cloud_providers)) { throw new \Exception(__('Invalid Cloud Provider!', 'advanced-media-offloader')); } return $provider; } /** * Sanitizes the retention policy setting * * @param array $options * @return int */ private function sanitizeRetentionPolicy(array $options): int { $policy = isset($options['retention_policy']) ? (int) $options['retention_policy'] : 0; return in_array($policy, [0, 1, 2], true) ? $policy : 0; } /** * Sanitizes the object versioning setting * * @param array $options * @return int */ private function sanitizeObjectVersioning(array $options): int { return isset($options['object_versioning']) && (int) $options['object_versioning'] === 1 ? 1 : 0; } /** * Sanitizes the path prefix setting * * @param array $options * @return string */ private function sanitizePathPrefix(array $options): string { return isset($options['path_prefix']) ? advmo_sanitize_path($options['path_prefix']) : ''; } public function add_settings_page() { // Advanced Media Offload Logo as Icon $svg_icon = ' '; $icon_base64 = 'data:image/svg+xml;base64,' . base64_encode($svg_icon); add_menu_page( __('Advanced Media Offloader', 'advanced-media-offloader'), __('Media Offloader', 'advanced-media-offloader'), 'manage_options', 'advmo', [$this, 'general_settings_page_view'], $icon_base64, 100 ); add_submenu_page( 'advmo', __('General Settings', 'advanced-media-offloader'), __('General Settings', 'advanced-media-offloader'), 'manage_options', 'advmo', [$this, 'general_settings_page_view'] ); } public function cloud_provider_field($args) { $options = get_option('advmo_settings', []); $current_provider = isset($options['cloud_provider']) && !empty($options['cloud_provider']) ? $options['cloud_provider'] : ''; echo ''; } /** * Get the cloud provider key from the plugin settings. * * @return string The cloud provider key or an empty string if not set. */ private function get_cloud_provider_key(): string { return advmo_get_cloud_provider_key(); } public function cloud_provider_credentials_field() { $cloud_provider_key = $this->get_cloud_provider_key(); if (!empty($cloud_provider_key)) { try { // Use the CloudProviderFactory to create an instance of the selected cloud provider /** @var CloudProviderInterface $cloud_provider_instance */ $cloud_provider_instance = CloudProviderFactory::create($cloud_provider_key); // Render the credentials fields specific to the selected cloud provider $cloud_provider_instance->credentialsField(); } catch (\Exception $e) { // Display an error message if the cloud provider is unsupported or instantiation fails echo '

' . esc_html__('Selected cloud provider is not supported or failed to initialize.', 'advanced-media-offloader') . '

'; } } else { echo '

' . esc_html__('Please select a valid cloud provider to configure credentials.', 'advanced-media-offloader') . '

'; } } public function general_settings_page_view() { advmo_get_view('admin/general_settings'); } public function enqueue_scripts() { if (!advmo_is_settings_page()) { return; } if (advmo_is_settings_page('general')) { wp_enqueue_script('advmo_settings', ADVMO_URL . 'assets/js/advmo_settings.js', [], ADVMO_VERSION, true); wp_localize_script('advmo_settings', 'advmo_ajax_object', [ 'ajax_url' => admin_url('admin-ajax.php'), 'nonce' => wp_create_nonce('advmo_test_connection'), 'save_general_nonce' => wp_create_nonce('advmo_save_general_settings'), 'save_credentials_nonce' => wp_create_nonce('advmo_save_credentials'), 'get_provider_credentials_nonce' => wp_create_nonce('advmo_get_provider_credentials'), 'i18n' => [ 'test_connection' => __('Test Connection', 'advanced-media-offloader'), 'recheck' => __('Re-Check', 'advanced-media-offloader'), 'connected' => __('Connected.', 'advanced-media-offloader'), 'last_check' => __('Last check:', 'advanced-media-offloader') ] ]); } if (advmo_is_settings_page('media-overview')) { wp_enqueue_script('advmo_bulkoffload', ADVMO_URL . 'assets/js/advmo_bulkoffload.js', [], ADVMO_VERSION, true); wp_localize_script('advmo_bulkoffload', 'advmo_ajax_object', [ 'ajax_url' => admin_url('admin-ajax.php'), 'bulk_offload_nonce' => wp_create_nonce('advmo_bulk_offload') ]); } wp_enqueue_style('advmo_admin', ADVMO_URL . 'assets/css/admin.css', [], ADVMO_VERSION); // Enqueue RTL styles if needed if (is_rtl()) { wp_enqueue_style('advmo_admin_rtl', ADVMO_URL . 'assets/css/admin-rtl.css', ['advmo_admin'], ADVMO_VERSION); } } public function check_connection_ajax() { $current_time = current_time('d/m/Y - h:i A'); $response_data = [ 'last_check' => $current_time ]; // Verify nonce if (!$this->verify_security_nonce('security_nonce', 'advmo_test_connection')) { $response_data['message'] = __('Invalid nonce!', 'advanced-media-offloader'); wp_send_json_error($response_data); } // Retrieve plugin settings $cloud_provider_key = $this->get_cloud_provider_key(); if (empty($cloud_provider_key)) { $response_data['message'] = __('Invalid Cloud Provider!', 'advanced-media-offloader'); wp_send_json_error($response_data); } try { $cloud_provider = $this->createCloudProvider($cloud_provider_key); if (!$cloud_provider) { throw new \Exception(__('Could not initialize cloud provider', 'advanced-media-offloader')); } $connection_result = $cloud_provider->checkConnection(); // Always update last check time regardless of result update_option('advmo_last_connection_check', $current_time); if ($connection_result) { $response_data['message'] = __('Connection successful!', 'advanced-media-offloader'); wp_send_json_success($response_data); } else { $response_data['message'] = __('Connection failed!', 'advanced-media-offloader'); wp_send_json_error($response_data, 401); } } catch (\Exception $e) { // Log error and update check time error_log('Advanced Media Offloader Connection Error: ' . $e->getMessage()); update_option('advmo_last_connection_check', $current_time); $response_data['message'] = sprintf( /* translators: %s: error message */ __('Failed to establish a connection: %s', 'advanced-media-offloader'), esc_html($e->getMessage()) ); wp_send_json_error($response_data, 500); } } /** * AJAX handler for saving general settings. */ public function save_general_settings_ajax() { // Verify nonce if (!$this->verify_security_nonce('security_nonce', 'advmo_save_general_settings')) { wp_send_json_error([ 'message' => __('Invalid security token!', 'advanced-media-offloader') ]); } // Check user capabilities if (!current_user_can('manage_options')) { wp_send_json_error([ 'message' => __('You do not have permission to perform this action.', 'advanced-media-offloader') ]); } // Get the posted settings $settings = isset($_POST['advmo_settings']) ? wp_unslash($_POST['advmo_settings']) : []; try { // Sanitize using a direct validation approach for AJAX $sanitized_settings = $this->sanitize_for_ajax($settings); // Update the option update_option('advmo_settings', $sanitized_settings); // Success wp_send_json_success([ 'message' => __('Settings saved successfully!', 'advanced-media-offloader') ]); } catch (\Exception $e) { // Catch any validation errors and return them directly wp_send_json_error([ 'message' => $e->getMessage() ]); } } /** * Sanitize settings for AJAX calls (without using WordPress settings errors system) * * @param array $options * @return array * @throws \Exception */ private function sanitize_for_ajax($options) { if (!current_user_can('manage_options')) { throw new \Exception(__('You do not have permission to perform this action.', 'advanced-media-offloader')); } // Initialize sanitized options with defaults $sanitized = [ 'cloud_provider' => '', 'retention_policy' => 0, 'object_versioning' => 0, 'path_prefix' => '', 'mirror_delete' => 0, 'path_prefix_active' => 0, 'auto_offload_uploads' => 1 ]; // Validate and sanitize cloud provider $sanitized['cloud_provider'] = $this->sanitizeCloudProvider($options); // Sanitize retention policy $sanitized['retention_policy'] = $this->sanitizeRetentionPolicy($options); // Sanitize object versioning $sanitized['object_versioning'] = $this->sanitizeObjectVersioning($options); // Sanitize path prefix $sanitized['path_prefix'] = $this->sanitizePathPrefix($options); // Sanitize mirror delete $sanitized['mirror_delete'] = isset($options['mirror_delete']) && (int) $options['mirror_delete'] === 1 ? 1 : 0; // Sanitize path prefix active $sanitized['path_prefix_active'] = isset($options['path_prefix_active']) && (int) $options['path_prefix_active'] === 1 ? 1 : 0; // Sanitize auto offload uploads $sanitized['auto_offload_uploads'] = isset($options['auto_offload_uploads']) && (int) $options['auto_offload_uploads'] === 1 ? 1 : 0; return $sanitized; } /** * AJAX handler for saving credentials. */ public function save_credentials_ajax() { // Verify nonce if (!$this->verify_security_nonce('security_nonce', 'advmo_save_credentials')) { wp_send_json_error([ 'message' => __('Invalid security token!', 'advanced-media-offloader') ]); } // Check user capabilities if (!current_user_can('manage_options')) { wp_send_json_error([ 'message' => __('You do not have permission to perform this action.', 'advanced-media-offloader') ]); } // Get the posted credentials $credentials = isset($_POST['advmo_credentials']) ? wp_unslash($_POST['advmo_credentials']) : []; // Sanitize using existing method $sanitized_credentials = $this->sanitize_credentials($credentials); // Update the option $updated = update_option('advmo_credentials', $sanitized_credentials); // Success wp_send_json_success([ 'message' => __('Credentials saved successfully!', 'advanced-media-offloader') ]); } /** * AJAX handler for getting provider credentials HTML. */ public function get_provider_credentials_html_ajax() { // Verify nonce if (!$this->verify_security_nonce('security_nonce', 'advmo_get_provider_credentials')) { wp_send_json_error([ 'message' => __('Invalid security token!', 'advanced-media-offloader') ]); } // Check user capabilities if (!current_user_can('manage_options')) { wp_send_json_error([ 'message' => __('You do not have permission to perform this action.', 'advanced-media-offloader') ]); } // Get the provider from POST $provider_key = isset($_POST['provider']) ? sanitize_text_field($_POST['provider']) : ''; if (empty($provider_key)) { wp_send_json_error([ 'message' => __('No provider specified.', 'advanced-media-offloader') ]); } // Validate provider exists if (!array_key_exists($provider_key, $this->cloud_providers)) { wp_send_json_error([ 'message' => __('Invalid cloud provider.', 'advanced-media-offloader') ]); } try { // Create an instance of the selected cloud provider $cloud_provider_instance = CloudProviderFactory::create($provider_key); // Capture the credentials field HTML ob_start(); $cloud_provider_instance->credentialsField(); $credentials_html = ob_get_clean(); // Success - return the HTML wp_send_json_success([ 'html' => $credentials_html, 'provider' => $provider_key ]); } catch (\Exception $e) { wp_send_json_error([ 'message' => sprintf( /* translators: %s: error message */ __('Failed to load credentials fields: %s', 'advanced-media-offloader'), esc_html($e->getMessage()) ) ]); } } /** * Verify the security nonce for AJAX requests. * * @return bool Whether the nonce is valid. */ private function verify_security_nonce($name, $action) { $security_nonce = isset($_POST[$name]) ? sanitize_text_field($_POST[$name]) : ''; return wp_verify_nonce($security_nonce, $action); } // Prevent cloning of the instance private function __clone() {} // Prevent unserializing of the instance public function __wakeup() {} }