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
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/waltert812/yvanki-s3-offload/archive/refs/heads/main.zip
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！