谷歌看图Discuz!插件安装手册

图贴是各社区论坛中的热门内容，谷歌看图Discuz!插件是一个基于Flash技术的丰富互联网应用程序，目的在于给 Discuz!论坛的图贴一个崭新的浏览体验。图贴阅读插件为Discuz!中的图贴提供了一种以图片为中心的视图，用更多的空间更好地集中展示帖子中的图片，精简了和图片无关的信息，使用户更方便地浏览查看帖子中的图片。

安装说明

首先：下载安装包google_photoviewer_discuz.zip。解压安装包得到下列文件：

photoviewer
│  README
│  ...
├─docs
│  ...
└─upload
    │  viewthreadfeed.php
    │  downloadfeed.php
    │  crossdomain.xml
    └─plugins
        └─photoviewer
            │  AC_OETags.js
            │  index.htm
            │  PhotoViewer.php
            │  PhotoViewer.swf
            │  playerProductInstall.swf
            │
            ├─history
            │      history.css
            │      history.js
            │      historyFrame.html
            │
            └─images
                    icon.gif

根据PhotoViewer.swf的部署方式，有两种安装方式可供选择：

本地安装：Discuz!服务器上将同时部署图贴feed生成模块和PhotoViewer.swf文件。该方式需要将解压后得到所有文件全部部署到论坛服务器上，论坛管理者可以修改部分初始参数，但会增加部署难度，占用论坛服务器空间，使用时会占用论坛服务器带宽，并且，如本插件flash文件升级，需要论坛管理者手动升级。

Google App Engine 安装：Discuz!服务器上仅部署图贴feed生成模块，PhotoVieweer.swf将引用App Engine上的文件。这种方式部署简单，flash文件可以自动升级。

第一步：

• 本地安装： 将upload目录里的文件上传至论坛的代码目录。即，把upload\viewthreadfeed.phpl文件上传到论坛的根目录；将upload目录里的upload\crossdomain.xml文件上传到服务器的根目录；upload\plugins\photoviewer目录 （包括其中所有文件）上传到论坛的plugins目录。
• App Engine安装： 将upload目录里的upload\viewthreadfeed.php文件上传到论坛的根目录；将upload目录里的upload\crossdomain.xml文件上传到服务器的根目录；把upload\plugins\photoviewer\images\icon.gif文件上传到论坛的plugins目录。

注：

1. 网站根目录，如您论坛的地址为http://www.abcde.com/bbs/，则网站根目录为论坛根目录的上一级目录，如论坛地址为http://bbs.abcde.com/ ，则网站根目录就是论坛根目录。
2. 如网站根目录中存在 crossdomain.xml(关于此文件的详细说明可以参考网站控制--策略文件)文件，可修改该文件，在

<cross-domain-policy>
  ...
  ...
</cross-domain-policy>

中间增加一行

<allow-access-from domain="forum-photo-viewer.appspot.com" />

即可。

第二步：对于在Linux上部署的Discuz!，需要正确设置这些文件（viewthreadfeed.php、photoviewer目录及其中文件）的访问权限（例如：777）

第三步：测试图贴摘要URL。

此前部署的viewthreadfeed.php文件的作用是，生成本插件所需的特定格式的图贴摘要。摘要是一个符合RSS规范的XML文档（关于摘要的详细规范可以参考图贴摘要格式规范）。对于论坛里的每个图贴页面，它都能够生成对应的RSS格式摘要。我们可以用以下方式来测试它是否正常工作：例如，对于以下的一个帖子：

http://www.abcde.com/bbs/viewthread.php?tid=30&page=1

可以用这个URL来得到对应的摘要：

http://www.abcde.com/bbs/viewthreadfeed.php?tid=30&page=1

得到的文件为一个满足图贴摘要格式规范的RSS文件。

第四步：在论坛中加入打开此插件的链接，如果按照上述方式安装。

• 本地安装：则谷歌看图插件的链接为

<论坛域名及路径>/plugins/photoviewer/PhotoViewer.php?photoFeedUrl=<图贴摘要URL>

• App Engine安装：则谷歌看图插件的链接为

http://forum-forum-photo-viewer.appspot.com/?photoFeedUrl=<图贴摘要URL>

<论坛域名及路径> 为论坛的域名及路径，根据您论坛部署的情况，路径可能为根路径或者为您设定的路径，例如 http://www.discuz.net (根路径的情况)或者 http://www.discuz.com/bbs (论坛安装于路径 bbs 下)。

<图贴摘要URL> 指向要被浏览的帖子的RSS摘要，需要经过URI编码（也称为百分号编码）。即参数中的特殊字符，如空格，问号等，需要用%XX的方式代替，其中XX为该字符的ASCII码的十六进制表示。PHP中可以使用rawurlencode 函数对字符进行该编码，关于该编码方式的详细细节，可参考RFC 1738及http://en.wikipedia.org/wiki/Percent-encoding 。

对于链接：

http://www.abcde.com/bbs/viewthreadfeed.php?tid=30&page=1

经过URI编码，应为：

http%3A%2F%2Fwww.abcde.com%2Fbbs%2Fviewthreadfeed.php%3Ftid%3D30%26page%3D1

各位站长可以根据自己站的需求，灵活地在各种位置加入从论坛其他页面到谷歌看图插件的链接。下面给出几种常见做法的例子。

例：在帖子列表页面（forumdisplay.php）中每个帖子标题后面增加一个到图贴阅读器的链接，以默认模板为例。

修改templates/default/forumdisplay.htm，添加链接。首先找到显示每个帖子的代码段（查找<span id="thread_$thread[tid]">，大概位于276行(7.0版本236行)）：

…
<!--{/if}-->
<span id="thread_$thread[tid]"><a href="viewthread.php?tid=$thread[tid]&amp;extra=$extra"$thread[highlight]>$thread[subject]</a></span>
<!--{if $thread['readperm']}--> - [{lang readperm} <span class="bold">$thread[readperm]</span>]<!--{/if}-->
…

然后在其中插入到图贴阅读插件的链接：

1. 本地安装：

...
<!--{/if}-->
<span id="thread_$thread[tid]"><a href="viewthread.php?tid=$thread[tid]&amp;extra=$extra"$thread[highlight]>$thread[subject]</a></span>

<span>
    <a href="plugins/photoviewer/PhotoViewer.php?photoFeedUrl=..%2F..%2Fviewthreadfeed.php%3Ftid%3D$thread[tid]">
        <img src="plugins/photoviewer/images/icon.gif" class="attach"/></a>
</span>

<!--{if $thread['readperm']}--> - [{lang readperm} <span class="bold">$thread[readperm]</span>]<!--{/if}-->
...

2. App Engine安装：

...
<!--{/if}-->
<span id="thread_$thread[tid]"><a href="viewthread.php?tid=$thread[tid]&amp;extra=$extra"$thread[highlight]>$thread[subject]</a></span>

<span>
    <a href="http://forum-photo-viewer.appspot.com/?photoFeedUrl=http%3A%2F%2Fwww.abcde.com%2Fbbs%2Fviewthreadfeed.php%3Ftid%3D$thread[tid]">
        <img src="plugins/photoviewer/images/icon.gif" class="attach"/></a>
</span>

<!--{if $thread['readperm']}--> - [{lang readperm} <span class="bold">$thread[readperm]</span>]<!--{/if}-->
...

进入帖子列表，即可看到进入图贴阅读插件的链接。如图所示：

点击链接，即可启动此图贴阅读插件。

例：在帖子内容页面（viewthread.php）顶部加入链接，同样以默认模板为例。

首先，编辑templates/default/templates.lang.php，给$language 数组加入一个元素，在文件末尾加入'google_photo_viewer' => '谷歌看图',，该元素指明了链接的文字。

    ...
    'authorinfoitems_location' => '来自',

    'google_photo_viewer' => '谷歌看图',

);

?>

修改templates/default/viewthread.htm。查找<form method="post" name="modactions">，大概位于64行。

...
<form method="post" name="modactions">
	<input type="hidden" name="formhash" value="{FORMHASH}" />
	<div class="mainbox viewthread">
		<span class="headactions">
		<!--{if $discuz_uid}-->
			<!--{if $supe['status']}-->
...

在span元素下，加入一个链接：

1. 本地安装：

...
<form method="post" name="modactions">
    <input type="hidden" name="formhash" value="{FORMHASH}" />
    <div class="mainbox viewthread">
        <span class="headactions">
            <a href="plugins/photoviewer/PhotoViewer.php?photoFeedUrl=..%2F..%2Fviewthreadfeed.php%3Ftid%3D$tid%26page%3D$page" target="_blank">
                <img src="plugins/photoviewer/images/icon.gif"/>{lang google_photo_viewer}
            </a>
        <!--{if $discuz_uid}-->
            <!--{if $supe['status']}-->
...

2. App Engine安装：

...
<form method="post" name="modactions">
    <input type="hidden" name="formhash" value="{FORMHASH}" />
    <div class="mainbox viewthread">
        <span class="headactions">
            <a href="http://forum-photo-viewer.appspot.com/?photoFeedUr=http%3A%2F%2Fwww.abcde.com%2Fbbs%2Fviewthreadfeed.php%3Ftid%3D$tid%26page%3D$page" target="_blank">
                <img src="plugins/photoviewer/images/icon.gif"/>{lang google_photo_viewer}
            </a>
        <!--{if $discuz_uid}-->
            <!--{if $supe['status']}-->
...

结果如图所示。

以上的例子均以默认模板给出，您可以用类似的方法修改其他模板。对于使用FTP方式进行更新的服务器，可以用先将文件下载到本地，修改，然后再上传覆盖的方式进行更新。进行更新前请务必注意备份，以免因更新给网站造成损失。各位站长也可以参照这里的例子，在论坛的其他位置插入至本插件的链接，或动态地根据帖子的内容，决定是否给出链接。

第五步： 插件配置（App Engine方式无此步骤）。

打开plugins/photoviewer/PhotoViewer.php文件，

找到

$tracking = 'true'; // 'true','false'

这个参数是配置是否开启用户统计数据发送功能的。‘true’是开启，'false'为关闭。

再找到

$downloadFeedApi = 'local'; // 'local','appEngine' or user's api

这个参数是配置此插件的下载功能的。'local'是下载时使用本地部署的downloadfeed.php文件为下载api.‘appEngine‘是使用App Engine提供的api进行下载，或者论坛管理者可以使用自己开发的其他api。