wajxy_xunren 插件介绍

基本信息

• 插件名称：公益寻亲

• 插件目录：wajxy_xunren

• 当前版本：1.0.5

• 插件类型：XIUNOX 插件

• 适配版本：XIUNOX 1.1

• 作者：金小颖论坛

• 数据来源：让爱回家公益寻人平台

• 项目版权页：https://www.52jiny.com/

插件用途

wajxy_xunren 用于同步公益寻人平台公开发布的寻亲信息，并在 XIUNOX 中提供独立寻亲页面、条件筛选、首页轮换挂件及后台同步管理。插件仅用于公益信息展示和线索引导，原始数据及详情内容归来源平台所有。

主要功能

数据同步

• 支持手动增量同步和全量同步。

• 支持 XIUNOX 每日计划任务自动增量同步。

• 正确使用源站分页参数 p-page。

• 仅解析指向 /xunren/view/ 的有效寻亲记录。

• 按真实 DOM 容器读取姓名、性别、籍贯、失踪地点、出生日期和失踪日期。

• 支持“失联地点／发现地点”“失联日期／发现日期”等兼容字段。

• 使用源站记录 ID 作为唯一键，通过原子 UPSERT 新增或更新数据。

• 同步结果展示解析、新增、更新、未变化、失败及库内有效数量。

前台寻亲页面

• 四列响应式人物卡片，适配桌面端、平板和移动端。

• 支持性别、地区、失踪年份范围和姓名关键词筛选。

• 支持 SQL 分页与总数统计。

• 显示照片、姓名、性别、籍贯、失踪地点和失踪日期。

• 点击人物卡片可前往来源平台查看完整信息或提交线索。

• 浅色与深色主题均使用 Bootstrap 主题变量，保证文字和背景对比度。

首页挂件

• 可选择随机展示或按最新记录展示。

• 可设置候选记录数量和自动轮换间隔。

• 显示寻亲总数及“查看全部”入口。

• 使用原生 JavaScript 安全创建节点，不使用 innerHTML。

后台管理

• Hero 信息区、环境状态卡、胶囊 Tab、开关行、胶囊输入框、粘性保存栏和居中版权栏。

• 可配置插件开关、自动同步、首页挂件、分页大小、轮换参数和前台文案。

• 可配置用户组访问范围、图片域名白名单和图片缓存时间。

• 可手动执行增量同步、全量同步、屏蔽或恢复记录、清理历史同步日志。

• 显示 cURL、DOM、PHP 环境状态及数据库统计。

安全设计

• 所有后台 POST 操作均进行 CSRF 校验。

• 动态内容使用 esc_html()、esc_attr() 或整数化输出。

• 图片代理只接受 HTTPS 地址，并执行域名白名单、TLS、响应大小和 MIME 类型校验。

• 不关闭 TLS 证书验证，不跟随远程跳转。

• 不存储用户密码，不修改 XIUNOX 用户表。

• 不使用 jQuery、Alpine.js、idiomorph 或不安全的 HTML 字符串拼接。

数据表

wajxy_xunren_person

保存来源 ID、姓名、性别、出生日期、失踪日期、地点、省份、照片、详情链接、展示状态及更新时间。source_id 为唯一索引，用于幂等同步。

wajxy_xunren_sync_log

保存同步类型、开始和结束时间、分页数、新增数、更新数、失败数、状态、详情及操作用户 ID。

安装与升级

1. 将压缩包内的 wajxy_xunren/ 上传至 XIUNOX 的 plugin/ 目录。

2. 在后台安装或升级插件。

3. 清理 XIUNOX tmp/ 编译缓存。

4. 进入插件设置页检查 cURL 和 DOM 环境。

5. 首次安装或字段解析升级后执行一次全量同步。

6. 浏览器强制刷新一次，确保加载最新前端资源。

卸载说明

标准卸载会删除插件的两张数据表，并删除 wajxy_xunren 设置项。卸载前如需保留数据，请先自行备份数据库。

使用声明

本插件是公益信息展示工具，不对来源数据的实时性、完整性和准确性作额外保证。发现有效线索时，请通过来源平台的官方详情页面联系相关公益机构，避免公开传播敏感个人信息。