新浪微博 for Discuz! 6.0～7.2 官方插件 v1.4正式版发布！

新浪微博 for Discuz! 6.0～7.2 官方插件 v1.4正式版发布！

此版本适用discuz6.0至discuz7.2系列，同时支持utf8和gbk，不用担心编码问题，请勿用于discuz X系列（Discuz! x1.5版插件下载：http://down.chinaz.com/soft/28142.htm ）。

警告：由于程序需要创建数据信息，对discuz做过二次开发的网站请慎重选择，如需安装可以联系我们索取细节信息，或参考安装包中的文档。为确保安全，安装前切记备份数据。

希望各位站长兄弟在使用中，对我们多提需求和建议，发现问题请直接拍砖，希望广大站长朋友积极反馈。

邮箱：liqing3#staff.sina.com.cn 或 622000805#qq.com
或直接@我的新浪微博： http://t.sina.com.cn/xyzlinger，私信已开，有问题或建议可以直接在线沟通。

插件下载：


也可通过chinaz.com下载：
http://down.chinaz.com/soft/27938.htm

功能展示：

具体新浪微博discuz插件的功能就不介绍了，直接上几个图，有图有真相：



直接使用新浪微博帐号授权登录论坛，并自动读取新浪微博账户信息创建为论坛用户。



功能之一：发帖时可以选择是否同步到对应的新浪微博帐号，产生的信息如下图所示：



在论坛发布的帖子将以摘要+原帖链接的形式同步到新浪微博，质量较高的合作站点还可以申请来源显示（可定制来源文字和对应链接），还有评论同步和回推等功能。只要你的传播得当，从新浪微博导回论坛的流量还是非常可观的。



插件简介：


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


====================
安装/升级注意事项
====================
1、
【安装问题】
安装时候需要appkey和appsecret，请站长们自行到 http://open.t.sina.com.cn 申请如需申请来源显示，请将将以下信息发送至：liqing3#staff.sina.com.cn（信息务必真实准确）
Appkey / 应用名称 / 来源网址 / 联系人 / 联系方式

2、
【安装问题】全新安装v1.4的方法
请注意，1.4 for Discuz! X1.5安装包和1.4 for Discuz! 6.0-7.2不能互用（即1.4 for Discuz! X1.5不能用于Discuz! 6.0-7.2；反之同理）；其安装方式也不一样。
以下假设论坛url为http://www.luntan.com/bbs/
（1）将v1.4插件包中的xwb目录上传到论坛根目录下，你也可以将xwb目录改名再上传（比如，改为xwb_plugin、xwb_sina等等，下面步骤中的xwb标识请自行替换）。
（2）访问安装url（ http://www.luntan.com/bbs/xwb/install/index.php ），进行安装操作。
（3）如果安装过程中出现任何问题，请站长立刻截图，并将论坛地址、论坛字符集编码、论坛程序版本等信息一同反馈到官网论坛技术支持板块：http://bbs.x.weibo.com/forum/forumdisplay.php?fid=9&;page=1

3、
【安装问题】为什么安装时，通过环境检测后点下一步提示“未通过”？
答复：
很可能表明你的服务器中，有关php.ini的session设置有问题，导致session的生成和传输存在问题，从而导致插件无法正常工作。
请到如下地址下载排错手册进行排查：http://bbs.x.weibo.com/forum/viewthread.php?tid=45&;extra=page%3D1



====================
升级注意事项
====================
1、
【升级问题】如何从v1.1或者v1.2升级到v1.4？
答复：
v1.4版本已经实现了保护机制和安装防干扰机制。因此对应的升级方式有两种。
第一种：覆盖文件升级。
如果选用此方法，必须要站长按照如下步骤操作，否则将无法完成升级！
以下假设安装该插件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.4插件包中、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.4插件包中、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。


2、
【升级问题】如何从v1.3升级到v1.4？
答复：
对于使用默认模板的站长，v1.3升级到v1.4的方法基本和“从v1.1或者v1.2升级到v1.4？”相同。
但对于部分已经安装了v1.3版本的、不想重新让程序自动修改模板的站长而言，也可以按照如下步骤操作：
1）、将v1.4安装包中，xwb目录中的所有文件，覆盖到已经运行在网站上的v1.3插件目录。
请注意：覆盖前，请备份v1.3插件目录到本地（不要备份到服务器上，以防止服务器安全性问题）。
2）、v1.4相比v1.3，有如下模板需要重新修改：
- admin/home.inc.php
- template/default/footer.htm
- template/default/viewthread_node.htm中，有关分享（转发）按钮的相关模板代码（仅针对Discuz! 7.0.0——7.2）
- template/default/viewthread.htm中，有关分享（转发）按钮的相关模板代码（仅针对Discuz! 6.0.0——6.1.0）
- template/default/post.htm（仅针对Discuz! 7.0.0——7.2）
- template/default/post_newthread.htm（仅针对Discuz! 7.0.0——7.2）
因此请站长自行对照安装包中的“安装程序所修改的文件详细文档”，自行进行修改操作。
修改前请记住备份文件。



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

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

3、
【OAuth相关问题】如果有站长用事项1所说的内测appkey + appsecret安装了插件后，
现在又在 http://open.t.sina.com.cn 新申请了一个，接着又想更改插件对应的值，那么该怎么做？
答复：
由于OAUTH验证机制中，绑定用户信息和appkey + appsecrt相关联，更改后这些用户信息将失效。
因此如果站长需要更改appkey和appsecrt，如果你是使用v1.1/1.2/v1.3，此时只能先卸载插件，并且在卸载的时候不能（请注意是不能）“保留微博插件数据”。
也就是说在卸载的时候，要把“保留微博插件数据”前面的勾去掉。
最后再重新安装插件才可。
本操作完成后，所有绑定用户必须重新绑定一次。
而对于v1.4，只需修改插件目录的app.cfg.php，并更改为自己的appkey + appsecrt。（请注意，不要使用记事本修改，而应该用editplus等软件，否则将使论坛变成乱码！）
修改完成后，必须通知论坛用户自行解除绑定，然后重绑；或者让论坛用户退出论坛，然后在论坛使用微博账号重新登录一次即可。


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-10-15 v1.4 svn230)
[增加]支持Discuz! X1.5的分支（请注意，不能和Discuz! 6.0-7.2互用）
[增加]核查存储的access token是否有更新，有更新则进行自动更新
[增加]用户绑定后，可通过服务器本地转发帖子，让应用来源更加明确
[修正]用户在新浪微博官方账户取消应用授权后，可手动解绑
[修正]gbk下无法绑定、登录，提示js错误的问题（v1.3手动解决方法：http://bbs.x.weibo.com/forum/viewthread.php?tid=44&;extra=page%3D1 ）
[修正]无微博数据时候，资料页显示错误问题
[修正]少数服务器兼容修正：json_decode可能存在解析超过int最大数的错误，导致微博id被解析为负数
[修正]后台删除已绑定微博的论坛用户后，使用该微博登录无效的问题
[修正]在chrome浏览器无法解除绑定的Bug
[修正]绑定流程问题
[修正]后台模板修改的for php4兼容性修正
[优化]从新浪微博登录跳转回论坛后，若js自动加载失败，则给予手动加载链接
......
其他修正和优化不一一列出

占位编辑。

安装这个有什么好处？

回复 wsx120 的帖子

这个好处太多了，谁用谁知道
站长推广网站，无谓乎追求流量、用户、展现，这些它都有。

哈哈

有QQ空间同步的就更好了，流量更大。

1.5可用?

回复 家俊 的帖子

X1.5 插件看这里：https://discuz.dismall.com/thread-1935163-1-1.html