Sync QCloud COS

使用腾讯云对象存储服务 COS 作为附件存储空间的 WordPress 插件

使用 WordPress Playground 在线预览 Sync QCloud COS 插件

插件特色

• 可配置是否上传缩略图和是否保留本地备份
• 本地删除可同步删除腾讯云上面的文件
• 支持腾讯云 COS 存储桶绑定自定义域名
• 支持替换数据库中旧的资源链接地址
• 支持北京、上海、广州、香港、法兰克福等完整地域使用
• 支持同步历史附件到 COS
• 支持验证桶名是否填写正确
• 支持腾讯云数据万象 CI 图片处理
• 支持上传文件自动重命名
• 支持媒体库编辑
• 支持腾讯云数据万象图片极智压缩
• 支持文件预览
• 支持文本内容审核
• 支持原图保护
• 支持数据监控
• 支持使用 wp-cli 命令上传/删除文件
• 支持上传文件到存储桶子目录
• 支持多站点

安装

后台安装（推荐使用）

WordPress 后台安装插件页面搜索Sync QCloud COS，点击安装

下载源码

从 GitHub 下载源码，通过 WordPress 后台上传安装，或者直接将源码上传到 WordPress 插件目录wp-content/plugins，然后在后台启用

GitHub 下载节点：https://github.com/sy-records/sync-qcloud-cos/releases/latest

修改配置

• 方法一：在 WordPress 插件管理页面有设置按钮，进行设置
• 方法二：在 WordPress 后台管理左侧导航栏设置下腾讯云 COS，点击进入设置页面
• 方法三：在 WordPress 后台管理左侧一级导航栏腾讯云 COS，点击进入设置页面

常量定义

数据监控中默认根据配置项判断是否展示图片处理、文档处理和文本审核的图表，如果需要强制展示或关闭，可以在wp-config.php中定义常量：

常量	说明
COS_DISABLE_CHARTS	禁用所有图表
COS_ENABLE_STYLE_CHART	强制展示图片处理图表
COS_ENABLE_PREVIEW_CHART	强制展示文档处理图表
COS_ENABLE_TEXT_CHART	强制展示文本审核图表

// 禁用所有图表
define('COS_DISABLE_CHARTS', true);

// 强制展示图片处理图表
define('COS_ENABLE_STYLE_CHART', true);

// 强制展示文档处理图表
define('COS_ENABLE_PREVIEW_CHART', true);

// 强制展示文本审核图表
define('COS_ENABLE_TEXT_CHART', true);

Contributors

This project exists thanks to all the people who contribute. [Contributors].

常见问题

1. 怎么替换文章中之前的旧资源地址链接

这个插件已经加上了替换数据库中之前的旧资源地址链接功能，只需要填好对应的链接即可

2. 使用子账户报错Cos Error Code: AccessDenied, Status Code: 403

可以使用子账户，但是 APPID 需要填写为存储桶创建者的 ID，而不是子账户的 ID。例如下文配置指南中的1250000000就是 APPID

3. 上传图片提示图像后期处理失败，请将其缩小到2500像素并重新上传

1）配置的存储桶名称填写错误，正确的配置参照 配置指南 中的存储桶名称

v1.6.1 版本增强了校验，填写错误会给予提示；同时兼容了桶名称附带APPID的情况

2）图片确实像素大于 2500px，可以在functions.php中加入以下代码禁止大图片裁剪功能

add_filter('big_image_size_threshold', '__return_false');

4. 从媒体库中删除了图片，但是COS中还是存在

原因是在配置页面选择了不在本地保留备份，因为 WordPress 机制问题，无法获取对应的文件信息

5. 在插件中应该如何使用腾讯云数据万象 CI

参考：腾讯云对象存储 COS + 数据万象 CI = 完善的图片解决方案 或 腾讯云文档 - 使用图片样式

6. 保存配置时报错：您的站点遇到了致命错误，请查看您的站点的管理电子邮箱来获得指引

这个问题应该只出现在 Windows 的机器上，打开WP_DEBUG的话会报错：Fatal error: Uncaught GuzzleHttp\Exception\RequestException: cURL error 60: SSL certificate problem: self signed certificate，解决方法如下：

1）从 https://curl.haxx.se/ca/cacert.pem 下载最新的 cacert.pem
2）将以下行添加到php.ini中，注意修改对应的路径

curl.cainfo=/path/to/cacert.pem

7. 保存配置时提示：ErrorCode:xxx, ErrorMessage:xxxx。如：ErrorCode:403, ErrorMessage:Request has expired

这种问题请直接前往腾讯云 对象存储文档 搜索对应的ErrorMessage信息即可，或者访问 对象存储错误码列表

8. 跟所有使用 Guzzle 组件的插件或主题都可能发生冲突，发生报错Call to undefined method GuzzleHttp...

不可同时开启同类插件，类似于腾讯云的官方插件 tencentcloud-* 系列。

配置指南

查看详细教程https://qq52o.me/2722.html

• 存储桶设置

访问 腾讯云控制台 创建存储桶，把创建存储桶时要求你填写的存储桶名称，把存储桶名称填到这里就可以了，没有后面的-appid。
examplebucket-1250000000，其中examplebucket为存储桶名称，1250000000为 APPID。

• 存储桶地域

选择你创建存储桶时所选的地域即可。
如果地域选择全球加速，则在 COS 控制台中开启全球加速服务，具体方法和资费问题请查看 全球加速官方文档

• APP ID、SecretID、SecretKey

APP ID 填写上文存储桶设置中所说的125000000即可；也可以访问 腾讯云控制台 获取 APP ID、SecretID、SecretKey

插件截图

更新记录

CHANGELOG