feat: add S3-compatible storage provider (MinIO, Ceph, R2, etc.)

Adds a new 'S3-Compatible Storage' provider that works with any
S3-API-compatible object storage service, including MinIO, Ceph,
Cloudflare R2, Backblaze B2, and others.

Changes:
- New provider class: classes/providers/storage/s3-compatible-provider.php
  - Provider key: s3compatible
  - Reads user-configured endpoint URL from settings
  - Uses path-style URL access (required by most S3-compatible services)
  - Supports credentials via AS3CF_S3COMPAT_ACCESS_KEY_ID /
    AS3CF_S3COMPAT_SECRET_ACCESS_KEY wp-config.php constants
  - Disables AWS-specific features (Block Public Access, Object Ownership)
- New provider SVG icons (s3compatible.svg, -link.svg, -round.svg)
- Registered provider in main plugin class with endpoint setting support
- Updated StorageProviderSubPage to show endpoint URL input for S3-compatible
- Built pro settings bundle with rollup (Svelte 4.2.19)
- Added package.json and updated rollup.config.mjs for pro-only builds

classes/integrations/advanced-custom-fields.php

@@ -0,0 +1,280 @@
+<?php
+
+namespace DeliciousBrains\WP_Offload_Media\Integrations;
+
+use AS3CF_Error;
+use AS3CF_Utils;
+use DeliciousBrains\WP_Offload_Media\Items\Media_Library_Item;
+use DeliciousBrains\WP_Offload_Media\Items\Remove_Local_Handler;
+use Exception;
+use WP_Error;
+use WP_Post;
+
+class Advanced_Custom_Fields extends Integration {
+	/**
+	 * Is installed?
+	 *
+	 * @return bool
+	 */
+	public static function is_installed(): bool {
+		if ( class_exists( 'acf' ) ) {
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * Init integration.
+	 */
+	public function init() {
+		// Nothing to do.
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function setup() {
+		/*
+		 * Content Filtering
+		 */
+		add_filter( 'acf/load_value/type=text', array( $this->as3cf->filter_local, 'filter_post' ) );
+		add_filter( 'acf/load_value/type=textarea', array( $this->as3cf->filter_local, 'filter_post' ) );
+		add_filter( 'acf/load_value/type=wysiwyg', array( $this->as3cf->filter_local, 'filter_post' ) );
+		add_filter( 'acf/load_value/type=url', array( $this->as3cf->filter_local, 'filter_post' ) );
+		add_filter( 'acf/load_value/type=link', array( $this, 'filter_link_local' ) );
+		add_filter( 'acf/update_value/type=text', array( $this->as3cf->filter_provider, 'filter_post' ) );
+		add_filter( 'acf/update_value/type=textarea', array( $this->as3cf->filter_provider, 'filter_post' ) );
+		add_filter( 'acf/update_value/type=wysiwyg', array( $this->as3cf->filter_provider, 'filter_post' ) );
+		add_filter( 'acf/update_value/type=url', array( $this->as3cf->filter_provider, 'filter_post' ) );
+		add_filter( 'acf/update_value/type=link', array( $this, 'filter_link_provider' ) );
+
+		/*
+		 * Image Crop Add-on
+		 * https://en-gb.wordpress.org/plugins/acf-image-crop-add-on/
+		 */
+		if ( class_exists( 'acf_field_image_crop' ) ) {
+			add_filter( 'wp_get_attachment_metadata', array( $this, 'download_image' ), 10, 2 );
+			add_filter( 'sanitize_file_name', array( $this, 'remove_original_after_download' ) );
+		}
+
+		/*
+		 * Rewrite URLs in field and field group config.
+		 */
+		add_filter( 'acf/load_fields', array( $this, 'acf_load_config' ) );
+		add_filter( 'acf/load_field_group', array( $this, 'acf_load_config' ) );
+
+		/*
+		 * Supply missing data.
+		 */
+		add_filter( 'acf/filesize', array( $this, 'acf_filesize' ), 10, 2 );
+	}
+
+	/**
+	 * Copy back the S3 image for cropping
+	 *
+	 * @param array $data
+	 * @param int   $post_id
+	 *
+	 * @return array
+	 */
+	public function download_image( $data, $post_id ) {
+		$this->maybe_download_image( $post_id );
+
+		return $data;
+	}
+
+	/**
+	 * Copy back the S3 image
+	 *
+	 * @param int $post_id
+	 *
+	 * @return bool|WP_Error
+	 */
+	public function maybe_download_image( $post_id ) {
+		if ( false === $this->as3cf->plugin_compat->maybe_process_on_action( 'acf_image_crop_perform_crop', true ) ) {
+			return $this->as3cf->_throw_error( 1, 'Not ACF crop process' );
+		}
+
+		$file = get_attached_file( $post_id, true );
+
+		if ( file_exists( $file ) ) {
+			return $this->as3cf->_throw_error( 2, 'File already exists' );
+		}
+
+		$as3cf_item = Media_Library_Item::get_by_source_id( $post_id );
+
+		if ( ! $as3cf_item ) {
+			return $this->as3cf->_throw_error( 3, 'Attachment not offloaded' );
+		}
+
+		$callers = debug_backtrace(); // phpcs:ignore
+		foreach ( $callers as $caller ) {
+			if ( isset( $caller['function'] ) && 'image_downsize' === $caller['function'] ) {
+				// Don't copy when downsizing the image, which would result in bringing back
+				// the newly cropped image from S3.
+				return $this->as3cf->_throw_error( 4, 'Copying back cropped file' );
+			}
+		}
+
+		// Copy back the original file for cropping
+		$result = $this->as3cf->plugin_compat->copy_provider_file_to_server( $as3cf_item, $file );
+
+		if ( false === $result ) {
+			return $this->as3cf->_throw_error( 5, 'Copy back failed' );
+		}
+
+		// Mark the attachment so we know to remove it later after the crop
+		update_post_meta( $post_id, 'as3cf_acf_cropped_to_remove', true );
+
+		return true;
+	}
+
+	/**
+	 * Remove the original image downloaded for the cropping after it has been processed
+	 *
+	 * @param string $filename
+	 *
+	 * @return mixed
+	 */
+	public function remove_original_after_download( $filename ) {
+		$this->maybe_remove_original_after_download();
+
+		return $filename;
+	}
+
+	/**
+	 * Remove the original image from the server
+	 *
+	 * @return bool|WP_Error
+	 */
+	public function maybe_remove_original_after_download() {
+		if ( false === $this->as3cf->plugin_compat->maybe_process_on_action( 'acf_image_crop_perform_crop', true ) ) {
+			return $this->as3cf->_throw_error( 1, 'Not ACF crop process' );
+		}
+
+		$original_attachment_id = $this->as3cf->filter_input( 'id', INPUT_POST, FILTER_VALIDATE_INT );
+
+		if ( ! isset( $original_attachment_id ) ) {
+			// Can't find the original attachment id
+			return $this->as3cf->_throw_error( 6, 'Attachment ID not available' );
+		}
+
+		$as3cf_item = Media_Library_Item::get_by_source_id( $original_attachment_id );
+
+		if ( ! $as3cf_item ) {
+			// Original attachment not on S3
+			return $this->as3cf->_throw_error( 3, 'Attachment not offloaded' );
+		}
+
+		if ( ! get_post_meta( $original_attachment_id, 'as3cf_acf_cropped_to_remove', true ) ) {
+			// Original attachment should exist locally, no need to delete
+			return $this->as3cf->_throw_error( 7, 'Attachment not to be removed from server' );
+		}
+
+		// Remove the original file from the server
+		$original_file = get_attached_file( $original_attachment_id, true );
+
+		$remove_local_handler = $this->as3cf->get_item_handler( Remove_Local_Handler::get_item_handler_key_name() );
+		$remove_local_handler->handle( $as3cf_item, array( 'files_to_remove' => array( $original_file ) ) );
+
+		// Remove marker
+		delete_post_meta( $original_attachment_id, 'as3cf_acf_cropped_to_remove' );
+
+		return true;
+	}
+
+	/**
+	 * Rewrites URLs from local to remote inside ACF field and field group config. If the
+	 * rewriting process fails, it will return the original config.
+	 *
+	 * @handles acf/load_fields
+	 * @handles acf/load_field_group
+	 *
+	 * @param array $config
+	 *
+	 * @return array
+	 */
+	public function acf_load_config( array $config ): array {
+		try {
+			$filtered_config = AS3CF_Utils::maybe_unserialize( $this->as3cf->filter_local->filter_post( serialize( $config ) ) );
+		} catch ( Exception $e ) {
+			AS3CF_Error::log( __METHOD__ . ' ' . $e->getMessage() );
+
+			return $config;
+		}
+
+		return is_array( $filtered_config ) ? $filtered_config : $config;
+	}
+
+	/**
+	 * Shortcut ACF's `filesize` call to prevent remote stream wrapper call
+	 * if attachment offloaded and removed from local and filesize metadata missing.
+	 *
+	 * ACF doesn't really use result, so if attachment offloaded and removed
+	 * but for some reason we too do not have the filesize, returning true
+	 * satisfies ACF's requirements.
+	 *
+	 * @param int|null $filesize   The default filesize.
+	 * @param WP_Post  $attachment The attachment post object we're looking for the filesize for.
+	 *
+	 * @return int|true
+	 */
+	public function acf_filesize( $filesize, $attachment ) {
+		if ( ! empty( $filesize ) || ! is_a( $attachment, 'WP_Post' ) ) {
+			return $filesize;
+		}
+
+		$item = Media_Library_Item::get_by_source_id( $attachment->ID );
+
+		if ( empty( $item ) ) {
+			return $filesize;
+		}
+
+		$filesize = $item->get_filesize();
+
+		if ( empty( $filesize ) ) {
+			return true;
+		}
+
+		return $filesize;
+	}
+
+	/**
+	 * Filter a link field's URL from local to provider.
+	 *
+	 * @param array $link
+	 *
+	 * @return array
+	 */
+	public function filter_link_local( $link ) {
+		if ( is_array( $link ) && ! empty( $link['url'] ) ) {
+			$url = $this->as3cf->filter_local->filter_post( $link['url'] );
+
+			if ( ! empty( $url ) ) {
+				$link['url'] = $url;
+			}
+		}
+
+		return $link;
+	}
+
+	/**
+	 * Filter a link field's URL from provider to local.
+	 *
+	 * @param array $link
+	 *
+	 * @return array
+	 */
+	public function filter_link_provider( $link ) {
+		if ( is_array( $link ) && ! empty( $link['url'] ) ) {
+			$url = $this->as3cf->filter_provider->filter_post( $link['url'] );
+
+			if ( ! empty( $url ) ) {
+				$link['url'] = $url;
+			}
+		}
+
+		return $link;
+	}
+}

classes/integrations/core.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace DeliciousBrains\WP_Offload_Media\Integrations;
+
+use DeliciousBrains\WP_Offload_Media\Items\Item;
+use DeliciousBrains\WP_Offload_Media\Items\Remove_Local_Handler;
+use DeliciousBrains\WP_Offload_Media\Items\Upload_Handler;
+use WP_Error;
+
+class Core extends Integration {
+	/**
+	 * Is installed?
+	 *
+	 * @return bool
+	 */
+	public static function is_installed(): bool {
+		return true;
+	}
+
+	/**
+	 * Init integration.
+	 */
+	public function init() {
+		// Nothing to do.
+	}
+
+	/**
+	 * @inheritDoc
+	 */
+	public function setup() {
+		add_action( 'as3cf_post_handle_item_' . Upload_Handler::get_item_handler_key_name(), array( $this, 'maybe_remove_local_files' ), 10, 3 );
+	}
+
+	/**
+	 * After an upload completes, maybe remove local files.
+	 *
+	 * @handles as3cf_post_handle_item_upload
+	 *
+	 * @param bool|WP_Error $result     Result for the action, either handled (true/false), or an error.
+	 * @param Item          $as3cf_item The item that the action was being handled for.
+	 * @param array         $options    Handler dependent options that may have been set for the action.
+	 */
+	public function maybe_remove_local_files( $result, Item $as3cf_item, array $options ) {
+		if ( ! is_wp_error( $result ) && $as3cf_item->id() && $this->as3cf->get_setting( 'remove-local-file', false ) && $as3cf_item->exists_locally() ) {
+			$remove_local_handler = $this->as3cf->get_item_handler( Remove_Local_Handler::get_item_handler_key_name() );
+
+			$remove_local_handler->handle( $as3cf_item );
+		}
+	}
+}

classes/integrations/integration-manager.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace DeliciousBrains\WP_Offload_Media\Integrations;
+
+class Integration_Manager {
+
+	/**
+	 * @var Integration_Manager
+	 */
+	protected static $instance;
+
+	/**
+	 * @var Integration[]
+	 */
+	private $integrations;
+
+	/**
+	 * Protected constructor to prevent creating a new instance of the
+	 * class via the `new` operator from outside this class.
+	 */
+	protected function __construct() {
+		$this->integrations = array();
+
+		add_action( 'as3cf_setup', array( $this, 'setup' ) );
+	}
+
+	/**
+	 * Make this class a singleton.
+	 *
+	 * Use this instead of __construct().
+	 *
+	 * @return Integration_Manager
+	 */
+	public static function get_instance() {
+		if ( ! isset( static::$instance ) && ! ( self::$instance instanceof Integration_Manager ) ) {
+			static::$instance = new Integration_Manager();
+		}
+
+		return static::$instance;
+	}
+
+	/**
+	 * Getter for integration class instance
+	 *
+	 * @param string $integration_key
+	 *
+	 * @return Integration|null
+	 */
+	public function get_integration( $integration_key ) {
+		if ( ! empty( $this->integrations[ $integration_key ] ) ) {
+			return $this->integrations[ $integration_key ];
+		}
+
+		return null;
+	}
+
+	/**
+	 * Register integration.
+	 *
+	 * @param string      $integration_key
+	 * @param Integration $integration
+	 */
+	public function register_integration( $integration_key, Integration $integration ) {
+		if ( $integration::is_installed() ) {
+			$integration->init();
+
+			$this->integrations[ $integration_key ] = $integration;
+		}
+	}
+
+	/**
+	 * Set up the registered integrations.
+	 *
+	 * @return void
+	 */
+	public function setup() {
+		foreach ( $this->integrations as $integration ) {
+			$integration->setup();
+		}
+	}
+
+	/**
+	 * As this class is a singleton it should not be clone-able.
+	 */
+	protected function __clone() {
+	}
+
+	/**
+	 * As this class is a singleton it should not be able to be unserialized.
+	 */
+	public function __wakeup() {
+	}
+
+}

classes/integrations/integration.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace DeliciousBrains\WP_Offload_Media\Integrations;
+
+use Amazon_S3_And_CloudFront;
+
+abstract class Integration {
+
+	/**
+	 * @var Amazon_S3_And_CloudFront
+	 */
+	protected $as3cf;
+
+	/**
+	 * Integration constructor.
+	 *
+	 * @param Amazon_S3_And_CloudFront $as3cf
+	 */
+	public function __construct( Amazon_S3_And_CloudFront $as3cf ) {
+		$this->as3cf = $as3cf;
+	}
+
+	/**
+	 * Is installed?
+	 *
+	 * @return bool
+	 */
+	public static function is_installed(): bool {
+		return false;
+	}
+
+	/**
+	 * Is this integration enabled?
+	 *
+	 * While the integration's dependencies may be installed,
+	 * it is possible that the integration is disabled for other reasons.
+	 *
+	 * @return bool
+	 */
+	public function is_enabled(): bool {
+		return static::is_installed();
+	}
+
+	/**
+	 * Init integration.
+	 */
+	abstract public function init();
+
+	/**
+	 * Set up the integration.
+	 */
+	abstract public function setup();
+}