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() { $step_one_done = $this->step_one_state() === 'done'; $save_button = sprintf( '', esc_html__('Save Changes', 'advanced-media-offloader') ); // Keep the pending bulk-offload action visible above the settings panels. // The stable slot also lets AJAX responses add or clear the notice without // reloading the page. add_settings_section( 'advmo_next_action', '', [$this, 'render_next_action_slot'], 'advmo', [ 'before_section' => '', 'after_section' => '', ] ); add_settings_section( 'cloud_provider', __('Cloud storage', 'advanced-media-offloader'), function () { echo wp_kses_post($this->step_one_summary()); echo wp_kses_post($this->step_one_status_badge()); echo ''; echo '
' . esc_html__('Choose a cloud storage provider and enter its connection credentials.', 'advanced-media-offloader') . '
'; }, 'advmo', [ 'before_section' => '' . esc_html__('Choose what happens to new uploads and local files after they are copied to cloud storage.', 'advanced-media-offloader') . '
'; }, 'advmo', [ 'before_section' => '' . '' . '
'; echo '' . esc_html__('Add a common prefix to organize offloaded media files from this site in your cloud storage bucket.', 'advanced-media-offloader') . '
'; 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 '' . esc_html__('When enabled, deleting a media file in WordPress will also remove it from your cloud storage.', 'advanced-media-offloader') . '
'; 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 '' . esc_html__('This applies to each file right after it has been copied to cloud storage successfully — nothing is deleted before the cloud copy exists. Changing this does not go back and delete files that were already offloaded.', 'advanced-media-offloader') . '
'; if ($retention_policy > 0 && $this->provider_has_no_domain()) { echo '' . esc_html__('No Custom Domain is set for your cloud provider, so media is still served from this server and local files are kept, whatever you choose here. Set the Custom Domain (the public URL of your bucket or CDN) to serve media from cloud storage. Files already removed from this server load again once it is set.', 'advanced-media-offloader') . '
' . esc_html(sprintf( /* translators: %s: the cloud provider key saved in the settings */ __('The saved cloud provider "%s" is not available, so media is not offloaded or served from cloud storage. Choose a cloud provider above, enter its credentials and save.', 'advanced-media-offloader'), $cloud_provider_key )) . '
' . 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($hook_suffix = '') { 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' => [ 'testing' => __('Testing connection…', 'advanced-media-offloader'), 'copied' => __('Copied!', 'advanced-media-offloader'), 'copy_failed' => __('Press Ctrl/Cmd + C to copy', 'advanced-media-offloader'), 'connected' => __('Connected', 'advanced-media-offloader'), 'connection_failed' => __('Connection failed', 'advanced-media-offloader'), 'test_failed_network' => __('Could not run the test. Check your internet connection and try again.', 'advanced-media-offloader'), 'failed_load_credentials' => __('Failed to load credentials fields.', 'advanced-media-offloader'), 'error_loading_credentials' => __('An error occurred while loading credentials fields. Please try again.', 'advanced-media-offloader'), 'failed_save_provider' => __('Failed to save the selected provider. Please try again.', 'advanced-media-offloader'), 'failed_save_credentials' => __('Failed to save credentials.', 'advanced-media-offloader'), 'failed_save_general' => __('Failed to save general settings.', 'advanced-media-offloader'), 'error_saving' => __('An error occurred while saving settings. Please try again.', 'advanced-media-offloader') ] ]); } if (advmo_is_settings_page('support')) { wp_enqueue_script('advmo_support', ADVMO_URL . 'assets/js/advmo_support.js', [], ADVMO_VERSION, true); } if ( advmo_is_settings_page('media-overview') && is_string($hook_suffix) && strlen($hook_suffix) >= strlen('_page_advmo_media_overview') && 0 === substr_compare($hook_suffix, '_page_advmo_media_overview', -strlen('_page_advmo_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'), 'bulk_messages' => [ 'offload' => __('Offload Now', 'advanced-media-offloader'), 'resume' => __('Resume offload', 'advanced-media-offloader'), 'preparing' => __('Preparing…', 'advanced-media-offloader'), 'cancelling' => __('Cancelling after the active upload finishes…', 'advanced-media-offloader'), 'cancelled' => __('Bulk offload cancelled.', 'advanced-media-offloader'), 'paused' => __('Bulk offload paused. Resolve the problem before resuming.', 'advanced-media-offloader'), 'changed_run' => __('Another bulk run has started. Refresh this page to manage it.', 'advanced-media-offloader'), 'complete' => __('Offload complete.', 'advanced-media-offloader'), 'no_files' => __('No files to offload.', 'advanced-media-offloader'), 'failed_files' => __('Files that failed to offload:', 'advanced-media-offloader'), 'request_failed' => __('The request failed. Refresh the run status and try again.', 'advanced-media-offloader'), ] ]); } 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() { $response_data = []; // 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); } // Check user capabilities if (!current_user_can('manage_options')) { $response_data['message'] = __('You do not have permission to perform this action.', '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'] = __('Please select a cloud provider and save your settings first.', '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')); } $stored_status = advmo()->app()->get(\AdvancedMediaOffloader\Storage\ConnectionTester::class)->testProvider($cloud_provider, $cloud_provider_key); $is_connected = $stored_status['success']; // The card in the response is produced by the same renderer the // settings page uses, so the two presentations can never drift. $response_data['status_html'] = $cloud_provider->renderConnectionStatusCard($stored_status); $response_data['setup_status'] = $this->get_setup_status_fragments(); if ($is_connected) { $response_data['message'] = __('Connection successful!', 'advanced-media-offloader'); wp_send_json_success($response_data); } else { $response_data['message'] = $stored_status['message']; wp_send_json_error($response_data, 401); } } catch (\Exception $e) { error_log('Advanced Media Offloader Connection Error: ' . $e->getMessage()); $response_data['message'] = sprintf( /* translators: %s: error message */ __('Failed to establish a connection: %s', 'advanced-media-offloader'), esc_html($e->getMessage()) ); $stored_status = $this->store_connection_status($cloud_provider_key, false, $response_data['message']); if (isset($cloud_provider) && $cloud_provider instanceof \Advanced_Media_Offloader\Abstracts\S3_Provider) { $response_data['status_html'] = $cloud_provider->renderConnectionStatusCard($stored_status); } $response_data['setup_status'] = $this->get_setup_status_fragments(); wp_send_json_error($response_data, 500); } } /** * The parts of the guided setup UI that depend on live state. * * These are rendered server-side on page load, so any AJAX action that * changes the state must send them back — otherwise the step badges keep * showing what was true when the page was opened (e.g. "Needs attention" * next to a green connection card). * * @return array{step_one_badge: string, step_one_summary: string, step_two_summary: string, next_action: string} */ private function get_setup_status_fragments(): array { return [ 'step_one_badge' => $this->step_one_status_badge(), 'step_one_summary' => $this->step_one_summary(), 'step_two_summary' => $this->step_two_summary(), 'next_action' => $this->next_action_html(), ]; } /** * Persist the result of the last connection test so the settings page can * render it without a live network call. */ private function store_connection_status(string $provider_key, bool $success, string $message = '', string $hint = '', string $code = ''): array { return advmo()->app()->get(\AdvancedMediaOffloader\Storage\ConnectionStatusStore::class)->save($provider_key, $success, $message, $hint, $code); } /** * 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'), // Switching provider changes which step is done, and no test // runs on this path, so refresh the step badges here too. 'setup_status' => $this->get_setup_status_fragments() ]); } 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(esc_html__('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() {} }