WP Manifestindependent plugin directory
manifest / media / s3-media-sync

S3 Media Sync

A minimal WordPress plugin to offload media files to any S3-compatible storage

by S3 Media Sync · github.com/alexy-os/s3-media-sync · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/alexy-os/s3-media-sync/archive/refs/heads/main.zip
Readme github.com/alexy-os/s3-media-sync ↗

A minimal WordPress plugin to offload media files to any S3-compatible storage.

Features

  • Works with any S3-compatible endpoint
  • Single-page configuration
  • Automatic offload of new uploads
  • Smart local cleanup (keeps originals as backup)
  • Optional custom path prefix and file versioning
  • Optional deletion sync with cloud storage

Installation

  1. Copy the plugin folder to /wp-content/plugins/
  2. Activate S3 Media Sync in WordPress Admin → Plugins

Setup

  1. Go to Admin → S3 Media Sync
  2. Fill in:
    • Access Key ID
    • Secret Access Key
    • S3 Endpoint (leave empty to use the default)
    • Bucket Name
    • Region
    • Custom Domain (CDN) (optional)
  3. Click Test Connection
  4. Click Save Settings

Usage

  • New uploads are offloaded automatically (when enabled)
  • Existing media can be offloaded via Bulk Upload Existing Files

Requirements

  • WordPress 5.6+
  • PHP 8.1+
  • An S3-compatible storage account

File Structure

s3-media-sync/
├── s3-media-sync.php
├── config.php
├── utility-functions.php
├── includes/
│   ├── class-s3-provider.php
│   ├── class-offloader.php
│   └── class-admin.php
└── assets/
    ├── css/admin.css
    └── js/admin.js

License

GPL v2 or later