WP Manifestindependent plugin directory
manifest / media / yvanki-s3-offload

Yvanki S3 Offload

WordPress plugin to automatically offload media uploads to AWS S3

by WalterT812 · github.com/waltert812/yvanki-s3-offload · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/waltert812/yvanki-s3-offload/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/waltert812/yvanki-s3-offload ↗

一个 WordPress 插件，用于自动将媒体文件上传到 AWS S3，并在前端从 S3 URL 提供这些文件。

功能特性

  • 🚀 自动将 WordPress 媒体上传同步到 AWS S3
  • 🔄 在前端自动替换媒体 URL 为 S3 URL
  • ⚙️ 易于配置的管理界面
  • 🗑️ 支持删除附件时同步删除 S3 文件
  • 📦 支持多种文件类型和图片尺寸

系统要求

  • WordPress 6.0 或更高版本
  • PHP 8.1 或更高版本
  • AWS S3 账户和访问凭证

安装

通过 Composer 安装

composer install

手动安装

  1. 下载或克隆此仓库到 WordPress 的 wp-content/plugins/ 目录
  2. 在 WordPress 后台激活插件
  3. 在设置页面配置 AWS S3 凭证

配置

  1. 在 WordPress 后台，进入 设置 > Yvanki S3 Offload
  2. 填写以下信息：
    • AWS Access Key ID
    • AWS Secret Access Key
    • S3 Bucket 名称
    • S3 区域（Region）
    • 可选的路径前缀

使用方法

配置完成后，所有新上传的媒体文件将自动上传到 S3。现有的媒体文件 URL 也会在前端自动替换为 S3 URL。

开发

项目结构

yvanki-s3-offload/
├── assets/          # CSS 和 JavaScript 文件
├── includes/        # PHP 类文件
│   ├── class-yso-admin.php      # 管理界面
│   ├── class-yso-offload.php    # 核心上传逻辑
│   └── class-yso-s3-client.php  # S3 客户端封装
├── vendor/          # Composer 依赖
├── yvanki-s3-offload.php  # 主插件文件
└── composer.json    # Composer 配置

依赖

许可证

GPL v2 或更高版本

作者

WalterT812

贡献

欢迎提交 Issue 和 Pull Request！