目录一插件使用须知 :... 3 二安装插件 :... 4 三启用插件和插件的设置 :... 5 四卸载插件 :... 7 五升级插件 :... 8 六 API 接入点测速... 9 七注意事项 : 八常见问答 : 九联系我们 : 附录 : 安装

Size: px

Start display at page:

Download "目录一插件使用须知 :... 3 二安装插件 :... 4 三启用插件和插件的设置 :... 5 四卸载插件 :... 7 五升级插件 :... 8 六 API 接入点测速... 9 七注意事项 : 八常见问答 : 九联系我们 : 附录 : 安装"

又霓梁
7 years ago
Views:

1 又拍 UpYun 云存储附件助手安装使用手册 v

2 目录一插件使用须知 :... 3 二安装插件 :... 4 三启用插件和插件的设置 :... 5 四卸载插件 :... 7 五升级插件 :... 8 六 API 接入点测速... 9 七注意事项 : 八常见问答 : 九联系我们 : 附录 : 安装插件时插件会自动修改的文件代码杭州纬聚网络有限公司 2 / 17

3 一插件使用须知 : 插件暂时只支持 Discuz X2.5 版本,2.5 以下版本可能会存在无法正常使用的情况 ; 插件是基于又拍云存储服务的, 所以试用需要有有效的又拍云存储账号, 还没有账号的用户, 可前往又拍云存储官网免费申请全功能体验账号 : 如果之前使用本地存储图片和附件, 那可以直接安装启用我们的插件 ; 如果之前有使用远程附件功能, 需要将远端存储的文件复制到又拍云存储对应空间 ( 即在插件中设置的图片和文件空间 ), 才能保证之前上传的图片和附件可以正常访问, 当然, 我们的图片搬家工具也已经上线, 有需要的站长也可以和我们的销售专员联系, 协助搬家杭州纬聚网络有限公司 3 / 17

4 二安装插件 : 1. 安装插件之前, 建议手动备份以下四个文件 ; a)./source/module/forum/forum_attachment.php b)./source/function/function_core.php c)./source/function/function_post.php d)./source/class/discuz/discuz_ftp.php 2. 修改上述四个文件的权限, 修改权限为 666; 3. 下载后手动安装 ; a) 将解压 v0.4.1 安装包得到的插件文件夹 (upyun_upload) 复制到./source/plugin 文件夹下 ; b) 进入后台管理中心 -> 应用 -> 插件 ; c) 如果步骤 a 操作成功, 将在未安装插件列表里看到又拍 UpYun 云存储附件助手 v0.4.1 及其对应的安装按钮 ; d) 点击安装, 会提示插件安装成功, 在未启用的插件列表中会看到之前安装成功的又拍 UpYun 云存储附件助手 v0.4.1 插件 ; 4. 如果想要使用插件功能, 必须启用插件, 详细请看启用插件和插件的设置 ; 杭州纬聚网络有限公司 4 / 17

5 三启用插件和插件的设置 : 1. 点击又拍 UpYun 云存储附件助手 v0.4.1 右侧对应的启用按钮, 启用插件功能 ; 2. 启用后, 点击设置进入插件的相关参数设置 ; 1) 进行 API 接入点的设置 : API 接入点提供四个选项, 分别为自动判断电信联通网通和移动铁通, 默认为自动选择各位站长可以根据自己服务器实际情况, 手动设置合理的接入点以获取最佳的访问速度, 我们也为站长们提供测速工具, 使用说明请看后面的 API 接入点测速 2) 进行图片空间的设置 : a) 图片空间名填写云存储中创建的用于存储图片的空间名称 ( 建议使用图片类空间 ); b) 操作员帐号和操作员密码内分别填写授权图片空间管理权限的操作员帐号和密码 ; c) 图片访问域名填写云存储系统默认的空间域名或者绑定成功的域名, 结尾不要加斜杠 / ; 3) 进行文件空间的设置 : a) 文件空间名填写云存储中创建的用于存储文件的空间名称 ( 必须使用文件类空间 ); b) 操作员帐号和操作员密码内分别填写授权文件空间管理权限的操作员帐号和密码 ; c) 文件访问域名填写云存储系统默认的空间域名或者绑定成功的域名, 结尾不要加斜杠 / ; d) 是否启用防盗链根据需要勾选是或者否, 防盗链功能仅针对文件空间有效, 图片空间无防盗链支持, 并且防盗链设置需要和空间原本的 token 防盗链设置一致才有效 ; e) 防盗链密钥填写在云存储管理中心给用于文件存储空间设置的防盗链 token 密钥 ; f) 密钥失效时间单位为秒, 根据需要设置密钥失效时间 ; 杭州纬聚网络有限公司 5 / 17

6 3. 设定是否开启本地备份附件, 该设置同时对上面填写的图片和文件两个空间生效选是则云存储对应空间和论坛本地都有附件内容, 选否则只在云存储对应空间保存有附件内容 ; 4. 所有设置完成, 确保正确后, 点击提交按钮, 保存插件设置 ; 5. 接下来新开一个网页进入任意论坛前台页面 ( 如论坛首页帖子页面等都可以 ), 再次进入后台管理中心 -> 工具 -> 更新缓存, 手动更新缓存 ( 只需更新数据缓存即可, 当然全部更新也没关系 ), 刷新完成后插件就安装完成了, 可以在论坛帖子里面试传一个图片和文件附件看看效果 ; 6. 插件安装成功之后, 出于安全方面的考虑, 建议将四个个文件权限改回原来的只读权限 ; 杭州纬聚网络有限公司 6 / 17

7 四卸载插件 : 需要卸载插件, 先将安装时提到的四个文件权限修改为 666, 然后点击与又拍 UpYun 云存储附件助手 v0.4.1 对应的卸载按钮即可安全卸载, 插件卸载成功之后, 将四个文件权限改回原来的只读权限 ; 杭州纬聚网络有限公司 7 / 17

8 五升级插件 : 之前安装 v0.2 版或 v0.3 版的站长需要升级到 v0.4.1 版, 可以按照以下步骤操作 : 1. 先将安装时提到的四个文件权限修改为 666; 2. 根据当前安装的插件版本解压对应的 v0.2 升级包或 v0.3 升级包 3. 将解压得到的插件文件夹 (upyun_upload) 复制到./source/plugin 文件夹下替换掉原有文件夹 4. 打开管理中心 -> 应用 -> 插件, 点击又拍 UpYun 云存储附件助手 v0.x(x 为版本号 ) 右侧的更新 ; 5. 更新成功后请按照说明正确设置插件参数 6. 更新不成功的站长, 请先卸载插件, 再按照说明重新安装 v0.4.1 版之前安装 v0.4 版的站长需要升级到 v0.4.1 版, 可按照以下步骤操作 : 用 v.0.4 升级包里面的文件替换./source/class/discus/discus_ftp.php./source/plugin/upyun_upload/sdk/upyun.class.php 两个路径下的同名文件即可还在使用 v0.1 版的站长请先卸载插件, 再按照说明重新安装 v0.4.1 版杭州纬聚网络有限公司 8 / 17

9 六 API 接入点测速有需要 API 接入点测速的站长, 可将压缩包中的 upyun_ping.php 文件上传到论坛根目录下, 然后通过浏览器访问该文件, 即可得到论坛服务器和 UpYun 服务器连接的测速反馈, 根据测试得到的结果在插件参数中的 API 接入点选择最快的 API 接入点即可杭州纬聚网络有限公司 9 / 17

10 七注意事项 : 1. 本插件暂时只支持 Discuz X2.5 版本,2.5 以下版本用户请慎用 ; 2. 安装启用插件后, 请不要对系统自带的远程附件设置表单做任何修改, 否则可能会导致插件失效 ; 3. 建议备份附录中提到的四个文件, 虽然卸载插件时插件会还原之前的修改 ; 4. 安装插件前使用过论坛自带远程附件功能的用户请注意, 安装使用插件之前请先将之前远程附件空间的文件搬家到又拍云存储对应空间, 然后再安装使用我们的插件, 否则可能会导致之前远程附件的文件无法访问 ; 5. 防盗链只对文件类型附件有效, 附件是图片还是文件的判断, 插件跟论坛保持一致, 防盗链设置必须和云存储空间中 token 防盗链设置保持一致 ; 6. 图片类文件不支持防盗链, 所以请关闭用于存储图片类文件空间的 token 防盗链功能 ( 其他防盗链设置不受影响 ); 7. 本地备份文件选项设定的改变, 会同时影响文件存储空间和图片存储空间, 请务必注意 ; 8. 启用插件或者插件参数有更新 ( 即提交参数后 ), 先进入一次任意前台论坛页面 ( 让插件程序得到一次运行的机会 ), 然后再进入后台手动更新缓存 ( 更新数据缓存即可 ); 9. 当不需要使用该插件时, 建议卸载插件, 而不是简单的关闭插件, 保证论坛的正常运行 ; 10. 卸载插件之后, 觉得不太放心的用户, 可以将上述提到的四个文件用备份的文件替换还原, 但是想再次安装插件的用户必须注意文件的权限修改 ; 杭州纬聚网络有限公司 10 / 17

11 八常见问答 : 问 : 如果文件权限没有修改好就直接安装了插件, 该怎么办? 答 : 可以卸载插件, 然后修改文件权限, 再次安装或者也可以按照安装说明中附件的文件修改说明, 手动修改四个文件的代码问 : 插件正确安装且参数设置正确, 但是上传后显示的地址还是本地的? 答 : 尝试进入后台更新论坛数据缓存问 : 插件中设置了参数, 还需要在远程附件中设置么? 答 : 不需要, 插件会自动修改远程附件的设置, 所以只需要在插件中设置相关参数即可, 远程附件设置表单无需修改杭州纬聚网络有限公司 11 / 17

12 九联系我们 : 插件相关反馈请邮件联系 : faq@upyun.com 我们会在最短的时间内尽量给您满意的答复 ~~ 杭州纬聚网络有限公司 12 / 17

13 附录 : 安装插件时插件会自动修改的文件代码 ( 如果无法修改文件权限, 或者需要手工修改文件代码, 可按以下说明操作 ) 四个文件代码修改 : 四个文件代码修改 : (1)./source/module/forum/forum_attachment.php 将以下 3 行代码 ( 官方标准文件第 224 行开始 ) if($attach['remote'] &&!$_G['setting']['ftp']['hideurl'] && $isimage) { dheader('location:'.$_g['setting']['ftp']['attachurl'].'forum/'.$attach['attachment']); 替换为下列 24 行代码 ( 两条注释代码非必须, 主要为了方便删除 ) //Begin Of Upyun Insert Code if($attach['remote'] &&!$_G['setting']['ftp']['hideurl']){ if(strtolower(charset) == 'gbk'){ $attach['filename'] = urlencode(iconv('gbk', 'UTF-8', $attach['filename'])); elseif(strtolower(charset) == 'big5'){ $attach['filename'] = urlencode(iconv('big5', 'UTF-8', $attach['filename'])); else{ $attach['filename'] = urlencode($attach['filename']); if($isimage){ dheader('location:'.$_g['setting']['ftp']['attachurl'].'forum/'.$attach['attachment'].'?_upd='.$attach[' 杭州纬聚网络有限公司 13 / 17

14 filename']); else{ if($_g['cache']['plugin']['upyun_upload']['att_status']==1){ $etime = time()+$_g['cache']['plugin']['upyun_upload']['att_failure_time']; $sign = '?_upt='.substr(md5($_g['cache']['plugin']['upyun_upload']['att_key'].'&'.$etime.'&/forum/'.$attach['att achment']), 12,8).$etime.'&_upd='.$attach['filename']; else{ $sign = '?_upd='.$attach['filename']; dheader('location:'.$_g['cache']['plugin']['upyun_upload']['att_attachurl'].'/forum/'.$attach['attach ment'].$sign); //End Of Upyun Insert Code (2)./source/function/function_core.php 将以下 9 行代码 ( 官方标准文件第 1445 行开始 ) 杭州纬聚网络有限公司 14 / 17

15 $ftpon = getglobal('setting/ftp/on'); if(!$ftpon) { return $cmd == 'error'? -101 : 0; elseif($ftp == null) { $ftp = & discuz_ftp::instance(); if(!$ftp->enabled) { return $ftp->error(); elseif($ftp->enabled &&!$ftp->connectid) { 替换为下列 29 行代码 ( 两条注释代码非必须, 主要为了方便删除 ) //Begin Of Upyun Insert Code global $_G; $imgext = array('jpg', 'jpeg', 'gif', 'png', 'bmp'); preg_match("/\.([^\.]+)$/", $arg1, $matches); $isimage = in_array($matches[1], $imgext)? 1 : 0; $ftpon = getglobal('setting/ftp/on'); if(!$_g['cache']['plugin']['upyun_upload']){ loadcache('plugin'); if(!$ftpon) { return $cmd == 'error'? -101 : 0; 杭州纬聚网络有限公司 15 / 17

16 elseif($ftp == null) { $ftp = & discuz_ftp::instance(); if(!$ftp->enabled) { return $ftp->error(); elseif($ftp->enabled &&!$ftp->connectid) { $ftp->connect(); if($isimage == 0){ $ftp->config['bucketname']=$_g['cache']['plugin']['upyun_upload'['att_bucketname']; $ftp->config['username'] = $_G['cache']['plugin']['upyun_upload']['att_user']; $ftp->config['password'] = $_G['cache']['plugin']['upyun_upload']['att_password']; else{ $ftp->config['bucketname'] = $_G['cache']['plugin']['upyun_upload']['bucketname']; $ftp->config['username'] = $_G['cache']['plugin']['upyun_upload']['user']; $ftp->config['password'] = $_G['cache']['plugin']['upyun_upload']['password']; //End Of Upyun Insert Code (3)./source/function/function_post.php 将以下 2 行代码 ( 官方标准文件第 134 行开始 ) 杭州纬聚网络有限公司 16 / 17

17 dunlink($attach); $remoteaids[$attach['aid']] = $attach['aid']; 替换为下列 6 行代码 ( 两条注释代码非必须, 主要为了方便删除 ) //Begin Of Upyun Insert Code if($_g['cache']['plugin']['upyun_upload']['local_save']==0){ dunlink($attach); //End Of Upyun Insert Code $remoteaids[$attach['aid']] = $attach['aid']; (4)./source/class/discus/discuz_ftp.php 该文件是整体替换, 代码详见 upyun_upload 文件夹里的 upyun_ftp.php 杭州纬聚网络有限公司 17 / 17

又拍 UpYun 云存储百度编辑器 UEditor 集成工具安装使用手册 v

又拍 UpYun 云存储百度编辑器 UEditor 集成工具安装使用手册 v0.2 2013.01 目录一使用须知 :... 3 二安装说明 :... 4 三联系我们 :... 6 附一 : 百度编辑器 UEditor 完整版部署与体验 :... 7 附二此集成工具所做的一些修改 :... 9 杭州纬聚网络有限公司 2 / 11 一使用须知 : 已经安装部署百度编辑器 UEditor

目录 一 插件使用须知 :... 3 二 安装插件 :... 4 三 启用插件和插件的设置 :... 5 四 卸载插件 :... 7 五 升级插件 :... 8 六 API 接入点测速... 9 七 注意事项 : 八 常见问答 : 九 联系我们 : 附录 : 安装

目录一插件使用须知 :... 3 二安装插件 :... 4 三启用插件和插件的设置 :... 5 四卸载插件 :... 7 五升级插件 :... 8 六 API 接入点测速... 9 七注意事项 : 八常见问答 : 九联系我们 : 附录 : 安装