Deskripsyon
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
Mga Screenshot
Pag-install
- Upload the plugin files to the
/wp-content/plugins/hippius-media-offloaderdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Go to Hippius Media in the WordPress admin dashboard.
- Enter your Hippius Access Key ID and Secret Access Key.
- Optionally enter your Hippius API token if you want to use credit balance checks.
- Configure your IPFS Gateway URL, S3 Endpoint, and bucket name.
- Test the connection to ensure everything is working properly.
- Start migrating your media files.
FAQ
-
What is IPFS?
-
IPFS (InterPlanetary File System) is a distributed, peer-to-peer protocol designed to create a more open, resilient, and permanent web.
-
Where do I get Hippius S3 credentials and API token?
-
Create or copy your S3 credentials from the Hippius Console. You need both the Access Key ID and Secret Access Key for S3 storage operations. Get your API token from Hippius Console settings for account APIs such as credit balance checks.
-
Are my Hippius credentials stored securely?
-
The credentials are stored in WordPress options and are only available to administrators with the required capability. Keep your Secret Access Key private and only enter it on trusted WordPress admin pages.
-
Can I migrate only specific files?
-
Currently, the plugin supports bulk migration of supported media files and individual media actions where available.
-
What happens if the migration fails?
-
The plugin provides detailed error logging. You can identify which files failed to migrate and why, then retry the process.
-
Can I revert the migration?
-
If you kept local copies during migration, you can disable the plugin to revert to local file serving. However, there is no automated reversion process.
Mga Review
Wala pang reviews para sa plugin na ito.
Mga Contributor at Developer
Ang “Hippius Media Offloader” ay open source software. Ang mga sumusunod na tao ay nag-ambag sa plugin na ito.
Mga Contributor
Isalin ang “Hippius Media Offloader” sa iyong wika.
Interesado sa development?
Tingnan ang code, i-check ang SVN repository, o mag-subscribe sa development log sa pamamagitan ng RSS.
Changelog
1.0.0
- Initial release
- Bulk media migration functionality
- Auto-migration for new uploads
- Real-time progress tracking
- Comprehensive error handling
- Administrator-only credential settings
- Uses Hippius Access Key ID and Secret Access Key for authentication
- Uses Hippius S3-compatible API for storage operations
- Supports API token-based credit balance checks through api.hippius.com
- Includes current Hippius credential flow documentation