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

民审-M · 发表于 2017-9-5 14:56:05

本帖最后由民审-M 于 2017-9-6 15:21 编辑

本插件实现的功能

安装本插件后，可在线阅读论坛帖子内/门户文章内/群组帖子内的本地PDF附件（手机端不支持群组和门户，因dz不存在手机门户和手机群组的插件钩子，故插件无法起作用），不依赖浏览器，无需安装浏览器插件，支持现代主流浏览器，如IE9、IE10、IE11、chrome、firefox、edge、以及基于chrome的各种国内浏览器。
不支持远程附件

功能特点

1、支持论坛帖子、群组内帖子和门户文章内的pdf附件在线阅读（手机端不支持门户和群组）
2、使用插件内置pdf引擎或浏览器自带引擎阅读,不对上传的pdf文件做任何修改或转换操作
3、支持手机端阅读(微信和app中可能无法在线阅读pdf)
4、支持TXT格式附件在线阅读
5、支持后台设置在附件名处显示或隐藏下载链接
6、支持游客阅读pdf附件：附件会自动显示到帖子内容顶端或固定在原位置。门户文章页面中，附件自动插入到文章末尾。
7、插件设置页面可选择是否显示PDF界面上方的工具条

安装前特别注意：

本插件只在内容页面起作用，其他页面不起作用也无影响，如果你上传附件时提示上传失败，比如服务器IO错误、500错误、不可上传零字节文件、上传附件过大等，是你自己的网站或服务器问题，与本插件无关，不要向我们咨询此类问题

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默认，我们不处理冲突问题(愿意额外付费除外)

5、手机端不支持群组和门户，因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

常见的附件上传出错解决方法

本插件只在内容页面起作用，其他页面不起作用也无影响，如果你上传附件时提示上传失败，比如服务器IO错误、500错误、不可上传零字节文件、上传附件过大等，是你自己的网站或服务器问题，与本插件无关

1、提示附件大小超过限制？
原因：文件太大，超过了后台设定的尺寸或超过了服务器上php设置的尺寸
解决方法：首先请到后台-用户-用户组-需要设置的组-编辑-论坛相关-附件相关-设置论坛附件最大尺寸，然后修改服务器上 php.ini 中的文件上传尺寸，可联系你的空间商修改或自行百度“php文件上传大小”

2、提示服务器IO错误或Server IO 错误等？
原因：你服务器上临时文件夹权限不足或不可写，或者硬盘空间不足导致的.
解决方法：联系你的空间商或服务器管理员修改

3、提示500错误？
原因：可能是 php 环境配置有问题或者php版本太低，或者你的dz系统有修改导致的
解决方法：联系你的空间商或服务器管理员修复环境配置或者升级php到5.4以上

4、提示不可上传零字节错误？
原因：可能是你上传的附件尺寸大于后台或php配置中限定的尺寸，请参照第1条修改，也可能有其他原因，具体未知，如遇到这种问题，可使用【添加视频】按钮，直接填写mp3 mp4文件的url地址方式添加

使用方法

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附件在线读专业版2.0-3.jpg