西风-PDF附件在线读专业版1.9.6 DZ学习研究交流

民审-M · 发表于 2017-5-7 09:52:03

本帖最后由民审-M 于 2017-5-10 11:15 编辑

本插件实现的功能

安装本插件后，可在线阅读帖子内/门户文章内的本地PDF附件（不支持门户文章移动端，因dz没有移动端门户模板，所有移动端门户均是第三方实现的），不依赖浏览器，无需安装浏览器插件，支持现代主流浏览器，如IE9、IE10、IE11、chrome、firefox、edge、以及基于chrome的各种国内浏览器。
远程附件是否支持依赖于浏览器本身，不支持的时候点击会弹出提醒对话框

功能特点

1、支持论坛帖子和门户文章内的pdf附件在线阅读（不支持门户文章移动端，因dz没有移动端门户模板，所有移动端门户均是第三方实现的）
2、使用插件内置pdf引擎或浏览器自带引擎阅读,不对上传的pdf文件做任何修改或转换操作
3、支持手机端阅读(微信和app中可能无法在线阅读pdf)
4、支持TXT格式附件在线阅读
5、支持后台设置在附件名处显示或隐藏下载链接（远程附件会强制在pdf阅读界面中显示下载图标，不受插件控制，且点击该图标后下载的文件扩展名为attach，默认无法打开，需要自行修改扩展名为pdf）
6、支持游客阅读pdf附件：附件会自动显示到帖子内容顶端或固定在原位置。门户文章页面中，附件自动插入到文章末尾。

安装前特别注意：

0、远程PDF附件有限支持且依赖浏览器：即如果用户使用的浏览器本身支持PDF，则支持阅读远程PDF附件，否则不支持，不支持的时候，点击阅读会弹出提醒对话框。因此为保证兼容性，请尽量使用本地附件

1、如果你网站使用的是IIS服务器，可能需要手动添加一个MIME类型，扩展名为.attach，MIME类型为 application/octet-stream，如果不会添加，请按照这个网址中的教程添加 http://www.kafan.cn/edu/48984151.html，分享前请注意，如果你是iis服务器但不能或不愿进行此操作，请勿分享，一旦分享不可退款

2、插件要依赖模板中的插件钩子才可执行，如果你使用的模板缺失钩子，则插件无法使用，请自行切换回dz默认模板，或联系你的模板开发者添加钩子，我们没有义务为你处理此问题。(用到的钩子【PC】viewthread_top，viewthread_posttop，view_article_content。【手机】viewthread_top_mobile)

3、支持手机触屏版(不缺少钩子)，但不支持微社区，也不支持在其他插件页面中使用本插件，如果你的帖子内容页地址包括 http://域名/plugin.php? 这种形式，说明你的页面是由其他插件显示的，不支持使用本插件

4、本插件兼容dz默认模板、功能，可确保正常使用，但其他第三方模板或插件有可能与本插件形成冲突，因各家均独自开发，无法提前预知他人的编码，因此有时某些冲突无法避免，若有冲突，请自行关闭其应用或使用dz默认，我们不处理冲突问题(愿意额外付费除外)

演示站
演示站地址

http://demo.xf512.com/thread-3-1-1.html

用户名 ceshi001 密码 20162016

常见问题
1、安装并启用了但是不起作用？
答：后台-更新缓存。如果更新缓存后仍然不起作用，后台-界面-风格管理-切换到默认模板。

2、已经更新缓存并切换到了默认模板，但是仍不显示pdf，点击也不显示或者显示加载pdf错误？
答：
第一：检查你是否安装了其他文库类插件，比如 DSU 文库之类的，如果安装了，请卸载，同时必须注意，此类插件可能在你服务器上安装了某些转换程序，也必须卸载或者停止此类程序
第二：检查是否安装了附件类插件，如果有，请关闭或卸载
第三：是远程附件且浏览器不支持pdf
第四：如果你是IIS服务器，请添加 MIME 类型，扩展名为 .attach ，mime类型为 application/octet-stream
如果不会添加，请按照这个网址中的教程添加 https://www.kafan.cn/edu/48984151.html

使用方法

0：使用前，首先到后台-应用-插件列表--本插件--设置页面完成各项设置

1、安装并启用

2、后台-应用-插件列表-本插件--设置--启用的版块，在此项中选择要在哪些版块中启用，只有选择的版块中的帖子，才可使用本插件的功能

3、后台-应用-插件列表-本插件--设置-自动打开首个pdf，这项如果选择【是】，当主题帖子内有当前登录用户有权限阅读的pdf时，将自动打开第一个pdf文件如果选择【否】，则不自动打开，需要手动点击pdf文件名才打开。

注意：判断一个用户是否有权限阅读pdf文件，取决于以下因素
------- 未登录---无权限阅读
------- 已登录---如果登录用户就是帖子作者，有权限阅读
+++++++已登录---登录用户的阅读权限低于pdf附件设置的阅读权限，则无权限阅读
+++++++已登录---登录用户的阅读权限大于pdf附件设置的阅读权限，如附件免费，则有权限阅读
+++++++已登录---登录用户的阅读权限大于pdf附件设置的阅读权限，如附件收费，若已分享则有权限阅读，否则无权阅读。移动端不判断附件是否收费，一律视为免费

4、后台-应用-插件列表-本插件--设置--pdf阅读界面高度，在此项设置pdf阅读时界面的显示高度，单位是像素px，在此处只填写纯整数数字即可，不要加px，也不要填写小数或者负数

5、后台-应用-插件列表-本插件--设置--是否允许下载PDF，此项如果选择【是】，则在pdf文件名字后面显示下载链接，有权限的用户可选择下载

6、后台-应用-插件列表-本插件--设置--是否启用手机端阅读，如果此项选择【是】，则可在手机页面阅读pdf文件，但必须注意：如果启用了手机端阅读，则只要当前登录用户的阅读权限大于附件设置的阅读权限，就可以阅读pdf，不论此pdf附件是否设置了售价或者当前用户是否分享了此pdf

7、完成设置后，前台发帖上传附件，上传成功后，点击附件名字插入到编辑框中

8、点击帖内pdf文件名字，如果有权限阅读，则会自动打开，如果需要分享，则会显示分享对话框

9、点击pdf文件名字后的下载链接，可进行下载
西风-PDF附件在线读专业版1.9.8-1.jpg