DZ插件网» Discuz!下载中心 »插件 » Discuz! 牛马公益寻亲公益版(nm_xunren)

收藏 Discuz! 牛马公益寻亲公益版(nm_xunren)

分类插件

来源： 应用中心

更新日期2026-07-13

适配编码UTF8SC

兼容版本X3.4 X3.5 X5.0 X5.1

PHP版本7.0 ~ 7.4

移动属性该版本安装后自带手机版（触屏版）

售价：0

浏览6 次

下载6 次

下载地址 QQ咨询 1909859577 免责声明

详细内容

牛马公益寻亲

写在前面

本插件完全免费，不设任何付费门槛、功能限制或商业授权。

开发的初衷很简单：让每一个 Discuz! 站点都能零成本接入公益寻人信息，让更多失散家庭有机会被看见。每一条寻亲信息都可能点亮一个家庭的团圆之路，这正是本插件存在的全部意义。

如果你觉得插件对你有帮助，我们能给你的只有一句感谢，没有付费入口、没有赞助二维码、没有解锁高级版的引导。把插件用起来，让信息传播出去，就是对我们蕞大的支持。

请务必阅读下方的【使用须知与免责声明】

---

一、插件定位

本插件是一个面向 Discuz! 社区的公益信息聚合与展示工具。它自动同步让爱回家公益寻人平台公开的寻亲信息，并在论坛前台以杂志式排版呈现，同时提供侧边栏轮播挂件，让寻亲信息出现在站点的各个角落。

插件不收集用户数据、不接入第三方统计、不植入任何商业推广。它只做一件事：把公益寻亲信息展示出去。

---

二、核心功能

1. 寻亲信息自动同步

插件内置同步引擎，可定时从让爱回家公益寻人平台抓取公开的寻亲信息并入库。
支持全量同步与增量同步两种模式
全量同步采用分批次抓取策略，避免单次请求量过大触发源站防护
增量同步仅拉取上次同步后的新增数据，日常运行对服务器资源消耗极低
同步过程设有单任务执行时间保护，接近上限时自动安全退出，避免网关超时
请求间隔可配置，默认 1 秒一次，对源站保持友好
支持 User-Agent 自定义标识，便于源站识别本插件的合法请求
同步异常时自动记录告警日志，便于站点管理员排查问题

2. 前台寻亲列表页

插件提供独立的前台寻亲页面，访问地址为 plugin.php?id=nm_xunren:nm_xunren。

页面采用杂志式排版风格，信息密度高但层次清晰：
顶部报头横幅，展示站点标题与公益引导文案
多维度筛选：按性别、省份、关键字、失踪年份范围组合查询
卡片式列表，每张卡片包含照片、姓名、性别、籍贯、失踪地点、失踪日期、简要情况
卡片点击跳转至官方详情页，支持白名单域名校验，防止开放重定向风险
图片懒加载，使用 IntersectionObserver 按需加载，首屏不阻塞

3. 侧边栏轮播挂件

挂件可嵌入站点任意页面的侧边栏或任意位置，以紧凑卡片形式循环展示寻亲信息。用户无需进入寻亲列表页，在日常浏览论坛的过程中就能看到寻亲信息。

4. 图片代理服务

寻亲信息中的照片来源于官方平台，直接外链存在两个问题：一是源站可能防盗链导致图片无法显示，二是外链会暴露用户 IP 给第三方。
插件内置图片代理服务，所有寻亲照片通过本站中转获取

5. 主题色自定义

内置 6 套主题配色方案，一键切换前台页面与挂件的视觉风格
主题色通过 CSS 变量驱动，前台页面与挂件同步生效，无需修改任何代码。

三、常见问题

Q：插件安装后看不到数据？

A：插件安装后默认不会自动同步数据。请到后台同步管理手动触发一次全量同步，或等待计划任务首次执行。

Q：挂件不显示或样式错乱？

A：请检查两点：一是挂件 JS 是否正确加载（浏览器开发者工具 Network 面板），二是 Discuz 模板缓存是否已清理。插件升级后建议清理一次模板缓存。

Q：图片显示不出来？

A：可能是图片代理服务被限制。检查后台图片代理白名单域名配置，确保包含 rangaihuijia.com。同时检查缓存目录 data/plugin/nm_xunren/cache 是否存在且可写。

Q：同步一直失败怎么办？

A：到后台同步日志查看失败原因。常见原因包括：源站临时不可用、服务器网络出口受限、PHP allow_url_fopen 或 curl 扩展未启用。日志中会记录具体错误信息。

Q：可以修改寻亲信息的内容吗？

A：可以。后台数据管理支持单条编辑。但请注意，修改后的内容不会与源站同步更新，下次增量同步时若源站数据有变更，可能会覆盖你的修改。（注：请勿随意变更寻亲数据，因此而产生的后果本人概不负责）

Q：挂件可以嵌入到非 Discuz 页面吗？

A：可以。使用挂件独立页面地址 plugin.php?id=nm_xunren:nm_xunren&amp;amp;amp;amp;op=widget，通过 iframe 嵌入即可。也可直接引用 widget.js 在任意 HTML 页面中初始化。

---

四、数据来源声明

本插件展示的所有寻亲信息来源于让爱回家公益寻人平台（rangaihu

相关截图添加图片