' . 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 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
];
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;
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;
}
}
/**
* 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'),
'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);
}
}
/**
* 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() {}
}