# 腾讯云对象存储插件

# 0.版本依赖

  • 依赖 PHP 5.5+ 环境

  • GuzzleHttp 6.3.0+ (如果有其它插件引用了 GuzzleHttp 库并低于 6.3.0 版本会引起插件冲突)

# 1.插件介绍

WordPress COS插件是一款腾讯云研发的,提供给WordPress站长使用的官方插件。实现网站静态媒体资源与腾讯云COS的互通,有效降低本地存储负载,提升用户访问网站媒体资源的体验。

标题 名称
中文名称 腾讯云对象存储(COS)插件
英文名称 tencentcloud-cos
最新版本 1.0.0 (2020.06.18)
适用平台 WordPress (opens new window)
适用产品 腾讯云对象存储(COS) (opens new window)
GitHub项目 tencentcloud-wordpress-plugin-cos (opens new window)
gitee项目 tencentcloud-wordpress-plugin-cos (opens new window)
主创团队 腾讯云中小企业产品中心(SMB Product Center of Tencent Cloud)

# 2.功能特性

  • 支持验证桶名是否有效
  • 可配置是否数据万象 CI 图片处理-默认不开启
  • 可配置是否保留本地备份-默认不备份
  • 本地删除可同步删除腾讯云对象存储 COS 中的文件-默认同步删除
  • 支持同步历史附件到 COS
  • 支持上传文件自动重命名-默认支持
  • API动态获取域名列表

# 3.安装指引

# 3.1.部署方式一:通过GitHub部署安装

  1. git clone https://github.com/Tencent-Cloud-Plugins/tencentcloud-wordpress-plugin-cos
  2. 复制tencentcloud-wordpress-plugin-cos目录中的tencentcloud-cos文件夹拷贝到wordpress安装路径/wp-content/plugins/文件夹里面

# 3.2.部署方式二:通过WordPress官网插件中心下载安装

  1. 前往WordPress插件中心 (opens new window)点击下载
  2. 你的WordPress站点后台=》插件=》安装插件。点击左上角的"上传插件"按钮,选择上一步下载的zip安装包

# 3.3.部署方式三:通过本地WordPress站点插件中心部署安装

  1. 你的WordPress站点后台=》插件=》安装插件。在页面搜索框输入tencentcloud-cos
  2. 点击"安装"按钮,就会自动下载安装插件

# 4.使用指引

# 4.1.界面功能介绍

上图主要是配置COS插件的腾讯云参数,包括secretId、secretKey、所属地域、空间名称、是否自动重命名、不在本地保存、是否禁止生成缩略图、是否开启数据万象功能

上图中"附件同步"可同步WordPress媒体库中的全部文件到腾讯与的COS。 "一键替换"可替换网站内容中所有静态文件地址为腾讯云COS文件地址

# 4.2.名词解释

  • 自定义密钥:插件提供统一密钥管理,既可在多个腾讯云插件之间共享SecretId和SecretKey,也可为插件配置单独定义的腾讯云密钥。
  • SecretId:在腾讯云云平台API密钥上申请的标识身份的 SecretId。详情参考腾讯云文档 (opens new window)
  • SecretKey:在腾讯云云平台API密钥上申请的标识身份的SecretId对应的SecretKey。详情参考腾讯云文档 (opens new window)
  • 所属地域:在腾讯云服务器所在地域。详情参考腾讯云文档 (opens new window)
  • 空间名称:COS服务中存储桶的名称。详情参考腾讯云文档 (opens new window)
  • 访问域名:存储桶的域名。详情参考腾讯云文档 (opens new window)
  • 是否自动重命名:开启后,文件上传到腾讯云COS后将自动重命名,避免与已有同名文件相冲突。
  • 不在本地保存:开启后,静态文件同步到腾讯云COS后将删除本地副本,释放本地存储空间。
  • 是否禁止生成缩略图:开启后,上传图片时仅生成和上传主图到腾讯云COS。
  • 数据万象:开启数据万象对图片进行编辑,压缩、转换格式、水印添加等操作。详情参考腾讯云文档 (opens new window)
  • 附件同步:触发"附件同步"将同步WordPress媒体库中的全部文件到腾讯云COS。首次同步,执行时间会比较长,有可能会因执行时间过长,页面显示超时或者报错。推荐使用官方工具 COSBrowser (opens new window)
  • 一键替换:触发"一键替换"将替换网站内容中所有静态文件地址为腾讯云COS文件地址。

# 5.获取入口

插件入口 链接
GitHub link (opens new window)
gitee link (opens new window)
插件中心 link (opens new window)

# 6.FAQ

# 为什么打开插件媒体库同步后功能没有生效?

  1. 腾讯云的COS服务是否正常开启,是否欠费;
  2. 首先确认配置参数secretId、secretKey、所属地域和空间名称都是否正确;
  3. 到腾讯云的COS服务界面查看附件是否有上传;
  4. 是否有开启防盗链功能;

# 7.版本迭代记录

# 7.1 tencentcloud-wordpress-plugin-cos v1.0.0

  • 支持验证桶名是否有效
  • 可配置是否数据万象 CI 图片处理-默认不开启
  • 可配置是否保留本地备份-默认不备份
  • 本地删除可同步删除腾讯云对象存储 COS 中的文件-默认同步删除
  • 支持同步历史附件到 COS
  • 支持上传文件自动重命名-默认支持
  • API动态获取域名列表

# 8.致谢