Hippius Media Offloader

Hippius Media Offloader allows you to seamlessly migrate your WordPress media files to the Hippius IPFS network using the Hippius S3-compatible API. This plugin provides:

• Decentralized Storage: Store your media files on Hippius-backed decentralized storage for better reliability and censorship resistance
• S3-Compatible API: Upload and manage media through Hippius S3-compatible storage
• Access Key Authentication: Authenticate using Hippius Access Key ID and Secret Access Key
• API Token Support: Check account credit balance using a separate Hippius API token
• Flexible Migration: Choose what to migrate and when
• Error Handling: Comprehensive error reporting and retry mechanisms
• Security: Administrator-only credential settings with hidden Secret Access Key and API token fields

Features

• Bulk migration of existing media files
• Automatic migration of new uploads
• Option to keep or remove local copies
• Real-time migration progress tracking
• Detailed error logging and reporting
• Test connection functionality
• Clean, intuitive admin interface
• S3-compatible upload, delete, and bucket-policy handling

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Hippius S3 Access Key ID
• Hippius S3 Secret Access Key
• HTTPS enabled (recommended)
• Hippius API token (optional, only for credit balance checks)

External Services

This plugin connects to Hippius services to upload, manage, and delete migrated media files, test storage connectivity, and optionally retrieve the administrator’s account credit balance.

The external service is used to:
– Upload media files to Hippius S3-compatible storage
– Delete migrated media files from Hippius S3-compatible storage
– Test connection and storage configuration
– Retrieve the administrator’s account credit balance when the API token feature is used
– Configure bucket policy for public gateway access where supported

When does the plugin communicate with external services?
– When the administrator tests the Hippius connection
– When the administrator uploads or migrates media to Hippius storage
– When the administrator deletes migrated media from Hippius storage
– When the administrator requests account credit information

What data is sent?
– Hippius S3 Access Key ID for authenticated storage requests
– Request signatures generated using the Secret Access Key
– Hippius API token for credit balance API requests
– Media files selected by the site administrator for migration
– Media file identifiers and object keys needed for storage operations
– Bucket name and related storage configuration values required for S3-compatible operations

Media files selected by the site administrator are transmitted to Hippius for storage operations. Those files may contain embedded metadata such as EXIF data depending on the original upload. No visitor browsing data is intentionally sent by the plugin.

This plugin requires a Hippius account and administrator-provided Hippius S3 credentials to use offloading features.

The plugin does not send media files to Hippius until an administrator configures credentials and either manually starts migration, migrates an individual media item, enables automatic migration for new uploads, tests the connection, deletes a migrated file, or requests account credit balance.

If automatic migration is enabled, newly uploaded supported media files are transmitted to Hippius S3-compatible storage after upload.

This plugin is not usable as a media offloader without Hippius S3-compatible storage credentials.

Service Provider:
Hippius Network

Service URLs:
https://hippius.com/
https://s3.hippius.com/
https://api.hippius.com/

Credit balance checks use:
https://api.hippius.com/api/billing/credits/balance/

Terms of Service:
https://hippius.com/terms-and-conditions

Privacy Policy:
https://hippius.com/privacy-policy