我花了一个月，给 Discuz! 写了个公益寻亲插件，免费开放给大家

我花了一个月，给 Discuz! 写了个公益寻亲插件，免费开放给大家

---

大家好，我是七夏。

今天想跟大家聊一件不太"技术"的事。

先说个真实的感受。以前刷手机的时候，偶尔会刷到一些寻亲的信息，照片上的人有的已经找了十几年，有的孩子走丢时才几岁，照片还是当年的旧照。每次看到心里都会堵一下，但关掉页面之后，也就过去了。

直到有一天我在想，我每天做的论坛、写的代码，能不能也为这件事做点什么？

我是一个 Discuz! 老用户，写插件也有些年头了。我知道很多站长和我一样，运营着一个小论坛，没多少人，但也算是在互联网上有个小角落。如果这些散落在各处的小角落，都能挂上一块寻亲信息的展示位，哪怕每个论坛每天只有十来个人看到，加在一起也是个不小的数字。

于是就有了这个插件。

它叫「牛马公益寻亲」，数据来源是「让爱回家公益寻人平台」，一个做寻亲信息聚合的公益站点。插件会自动同步他们公开的寻亲信息，然后在你的论坛里展示出来。

不收费，没有付费版，没有功能限制，没有域名授权。

我把代码全部写完了，放在应用市场上，谁都可以下载安装。

一、这个插件能做什么

• 自动同步寻亲信息
  插件内置同步引擎，会定时从公益寻人平台抓取公开的寻亲数据并入库。支持全量同步和增量同步两种模式，日常运行对服务器资源消耗很低，不会拖慢你的论坛。
• 前台寻亲列表页
  插件提供一个独立的前台页面，地址是 plugin.php?id=nm_xunren:nm_xunren，采用杂志式排版，信息密度高但层次清晰。支持按性别、省份、关键字、失踪年份范围组合筛选，翻页组件是纯 JS 渲染的，不受站点模板样式干扰。
• 侧边栏轮播挂件
  这是我最想做的功能。挂件可以嵌入站点任意页面的侧边栏，以紧凑卡片形式循环展示寻亲信息。用户不用专门进寻亲页面，在日常浏览论坛的过程中就能看到。这个挂件支持两种嵌入方式：模板嵌入和 JS 直接嵌入，PC 端和移动端都适配。
• 图片代理服务
  寻亲照片来源于官方平台，插件内置图片代理服务，所有照片通过本站中转获取，不暴露用户 IP 给第三方，也避免了外链防盗链导致图片无法显示的问题。
• 主题色自定义
  内置 6 套主题配色方案，一键切换前台页面与挂件的视觉风格，通过 CSS 变量驱动，不用改代码。
• 后台管理
  包含同步管理、数据管理、同步日志、日志清理等模块，所有操作都有审计记录，寻亲信息可以单条编辑和屏蔽。
• 计划任务
  注册了 Discuz 计划任务，采用文件锁实现原子互斥，支持自动定时同步，不会因致命错误导致任务永久卡死。
• 移动端完整适配
  PC 端和移动端（触屏版）双模板，功能完全一致，移动端有触摸优化样式。
  

二、为什么免费

说实话，写这个插件花了不少时间，从需求分析、接口对接、同步引擎、前台展示、挂件轮播、后台管理、安全防护、移动端适配，前前后后改了好多版。

但我没打算靠它赚钱。

原因很简单，这是公益。寻亲信息不是商品，不该被打上价格标签。如果每个想接入寻亲信息的站长都要先掏钱，那很多人就不会接了，信息的传播面就窄了。

所以我把它做成完全免费的。没有免费版和付费版的区分，没有功能限制，没有域名授权，没有"解锁高级特性"的入口，没有赞助二维码，没有广告植入。

下载地址在应用市场，谁都可以去拿。如果你在别的地方看到有人卖这个插件，那不是我授权的。

三、安装很简单

• 进后台"应用中心"，找到"牛马公益寻亲"，点"安装"
• 到同步管理里手动触发一次分批全量同步，或者等计划任务自动跑
• 想在哪显示挂件，就在哪插入一行模板代码或一段JS代码
  

具体的配置参数和嵌入方式，插件后台有完整的调用说明，照着复制粘贴就行。

四、最后说几句

我不是什么大牛，只是一个普通的 Discuz! 插件开发者。我做这个插件，不为名不为利，只是觉得技术该有点温度，代码该有点用。

如果这个插件能让哪怕一个家庭早一天团圆，我花的这些时间就值了。

如果你是站长，欢迎安装使用，让你的论坛也成为寻亲信息的一个传播节点。哪怕你的论坛很小，哪怕每天只有几个人看到，这都是一份力量。

如果你觉得这个插件还行，不用给我打钱，跟身边的站长朋友说一声就行。让更多人知道，让更多论坛挂上寻亲信息，这就是对我最大的支持。

插件主页

应用市场地址：
https://addon.dismall.com/developer-102775.html

我的小站，牛马论坛，欢迎来坐坐：
https://www.niumabbs.com/

如果安装过程中遇到问题，或者有建议想反馈，可以到牛马论坛发帖告诉我，我会跟进。

---

补充一句：插件展示的所有寻亲信息来源于"让爱回家公益寻人平台"，数据所有权归属官方平台。插件仅用于公益传播，不对数据内容做任何担保。严禁利用本插件从事伪造寻亲信息诈骗、将寻亲信息用于商业推销等违法行为，因违规使用引发的一切后果由使用者自行承担。

---

牛马公益寻亲 - Discuz! X3.4 / X3.5 / X5.0 / X5.1 兼容 - PHP 5.6 至 8.3 - 完全免费 - 开发者：七夏