﻿====================
程序标识
====================
程序名称：xwb for discuz! 6.0 - 7.2
发布时间：2010-9-13 16:50
程序svn：73
发布者：yaoying
发布类型：v1.3稳定版



====================
插件需满足环境
====================
v1.3可用于Discuz! 6.0——7.2版本
v1.3允许的论坛字符集版本为gbk、utf-8
v1.3满足运行在PHP4.3.0及以上环境下；而对MYSQL的要求等同于DZ环境


====================
安装/升级注意事项
====================
1、
【安装问题】
安装时候需要appkey和appsecret。
请站长们自行到 http://open.t.sina.com.cn 申请。
申请后按需填写即可

2、
【安装问题】全新安装v1.3的方法
以下假设论坛url为http://www.luntan.com/bbs/
（1）将v1.3插件包中的xwb目录上传到论坛根目录下，你也可以将xwb目录改名再上传（比如，改为xwb_plugin、xwb_sina等等，下面步骤中的xwb标识请自行替换）。
（2）访问安装url（ http://www.luntan.com/bbs/xwb/install/index.php ），进行安装操作。
（3）如果安装过程中出现任何问题，请截图，并将论坛地址、论坛字符集编码、论坛程序版本等信息反馈给liqing3@staff.sina.com.cn


====================
升级注意事项
====================
1、
【升级问题】如何从v1.1或者v1.2升级到v1.3？
答复：
v1.3版本已经实现了保护机制和安装防干扰机制。因此对应的升级方式有两种。
第一种：覆盖文件升级。
如果选用此方法，必须要站长按照如下步骤操作，否则将无法完成升级！
以下假设安装该插件v1.1/v1.2版本的目录名称是xwb_plugin；并假设你的论坛url为http://www.luntan.com/bbs/
（1）备份服务器上v1.1/v1.2的插件目录xwb_plugin到本地（不要备份到服务器上，以防止服务器安全性问题）。
比如，通过ftp将这个目录xwb_plugin里面的所有文件下载备份到本地。
请注意：不要对服务器上的xwb_plugin目录进行任何删除或者改名操作！只是将它备份到本地！！否则论坛将无法运行！！！
（2）将v1.3插件包中、xwb目录的所有文件和文件夹（但除了文件app.cfg.php！）上传到xwb_plugin，进行覆盖v1.1/v1.2的文件和文件夹操作。
如果不小心覆盖了文件app.cfg.php，请看步骤5。
（3）删除服务器上的安装锁定文件xwb_plugin\log\xwb_install.lock
（4）访问安装url（ http://www.luntan.com/bbs/xwb_plugin/install/index.php ），进行重新安装操作，即可完成升级。
（5）如果在步骤2中不小心覆盖了app.cfg.php，那么在安装出现填写appkey和appsecret的时候，请打开本地备份的app.cfg.php，然后将对应的信息填写进去。
（6）如果升级过程中出现任何问题，请叫站长立刻截图，并将论坛地址、论坛字符集编码、论坛程序版本等信息一同反馈给yaoying。

第二种：重新部署升级。
该方法更加直接便捷。
（1）备份服务器上v1.1/v1.2的插件目录xwb_plugin到本地（不要备份到服务器上，以防止服务器安全性问题）。
比如，通过ftp将这个目录xwb_plugin里面的所有文件下载备份到本地。
（2）将v1.3插件包中、xwb目录改名（比如改为xwb_new，下同）。改名原则是不能够和原来服务器上面的插件目录重名，防止覆盖。
（3）将xwb_new目录上传到服务器。
（4）访问安装url（ http://www.luntan.com/bbs/xwb_new/install/index.php ），进行重新安装操作，即可完成升级。
（5）将服务器上v1.1/v1.2的插件目录xwb_plugin改名为xwb_old。
（6）在论坛进行常规操作，看论坛和插件能否正常运行。
（7）如果第6步操作顺利的话，请立刻删除xwb_old（但请保留本地备份）；否则请看步骤9。
（8）如果在安装出现填写appkey和appsecret的时候，请打开本地备份v1.1/v1.2的插件目录的app.cfg.php，然后将对应的信息填写进去。
（9）如果升级过程中出现任何问题，请叫站长立刻截图，并将论坛地址、论坛字符集编码、论坛程序版本等信息一同反馈给yaoying。

====================
其它注意事项
====================
1、
【安全提醒】
为了安全起见，建议安装或者升级后，请改名或者删除安装入口文件xwb\install\index.php，以防止黑客利用。

2、
【安装/升级通用问题】我是一个站长，然后使用了自己的模板，结果发现有些地方没有显示新浪微博相关的东西。这种情况下应该如何处理？
答复：
为了安全期间，本程序在安装和修改时，并不会修改非官方模板，结果可能使用自己的模板上无法出现新浪微博相关入口，导致无法使用某些功能。
从v1.2开始，我们提供了一个详细的手动修改文档。该手动修改文档是由我们内部的程序依据安装程序配置文件自动生成而来，因此内容与使用安装程序自动修改毫无区别。
如果站长自己有技术、或者所在公司有技术支持团队，可依照文档自行进行排查，和修改自定义模板的对应文件。

3、
【OAuth相关问题】如果有站长用事项1所说的内测appkey + appsecret安装了插件后，
现在又在 http://open.t.sina.com.cn 新申请了一个，接着又想更改插件对应的值，那么该怎么做？
答复：
由于OAUTH验证机制中，绑定用户信息和appkey + appsecrt相关联，更改后这些用户信息将失效。
因此如果站长需要更改appkey和appsecrt，此时只能先卸载插件，并且在卸载的时候不能（请注意是不能）“保留微博插件数据”。
也就是说在卸载的时候，要把“保留微博插件数据”前面的勾去掉。
最后再重新安装插件才可。
本操作完成后，所有绑定用户必须重新绑定一次。

4
【高级应用】开启记录所有OAuth通讯情况和结果为日志、记录所有头像同步结果为日志功能
本功能仅面向开发者和重点bug反馈排查，从svn1879开始内置，在切换后的svn11开始初步统一日志记录开启方式。
在正式环境中，非必要情况下请务必不要使用该功能，以防止安全性问题；
而在内部测试的时候建议打开，以记录与API的通讯情况，让插件开发者更好排查是插件本身的问题还是API方面的问题还是两者均有之的问题。

打开方法：
为安全起见，现阶段需要手动修改程序配置文件。
插件安装完成后，请使用EDITPLUS等程序（务必不能使用windows自带记事本，以防出现utf8 bom问题）打开app.cfg.php。
找到：
define('XWB_DEV_LOG_ALL_RESPOND', false);
将false改为true，即：
define('XWB_DEV_LOG_ALL_RESPOND', true);
即可。
OAuth通讯日志将以1个小时为时间段、自动分割存放在插件的log文件夹下。日志文件名例子：oauth_respond_log_2010-08-19_14.txt.php
如果你不需要记录了，就将该常量将true改为false。


====================
更新记录
====================
(2010-9-13 v1.3 svn73)
[修正]svn69中无法upload图片的问题
[修正]1.2中截取字符串过短问题


(2010-9-9 v1.3 svn69)
[增加]php4.3以上全面支持
[增加]基础功能按需关闭。特别是对服务器性能影响较大的功能，都提供一些特殊开关
[优化]性能优化，显著降低服务器负担
[优化]插件崩溃基础保护（现阶段实现的保护为：删除插件目录、更改插件目录名称不会影响论坛运行）
[优化]安装程序脱钩附属站点保护（部署两个插件包时，在安装和卸载时不会交叉影响导致fatal error）
[修正]iis下跳转问题
[修正]分享按钮在7.1/7.2开启主题评价后的错位


（2010-8-23，v1.2 svn11）
[修正]dz7.1和7.2下个人资料页无法使用签名的问题
[增加]初步统一日志记录开启方式

（2010-8-20，v1.2 svn1903）
本svn1903是测试svn1885完成后的修正版本
主要修正后台弹出升级提示框的问题，以及开启外部升级信息获取服务器

（2010-8-20，v1.2 svn1885）
相比v1.1，主要增加了产品文档的新功能需求
产品文档之外的新特性有：
[增加]内置记录所有OAuth通讯情况和结果为日志功能




===问题反馈及咨询合作=============================

Mr.Linger - 周立清
------------------------------------------------
新浪产品事业部–微博开放平台
SINA Product Department
手机：13718188488/13121111611
电话：(86-10)62676120 分机：(86-10)82628888-6120
传真：(86-10)82607109
邮箱：liqing3@staff.sina.com.cn
博客：www.linger.cn
微博：http://t.sina.com.cn/xyzlinger
MSN ：xyzlinger@qq.com QQ：622000805/3653550
地址：北京市海淀区北四环西路58号理想国际大厦18层
邮编：100080
------------------------------------------------
新浪·北京 You Are the One    新浪 一切由你开始！
