一、插件概述
惠农资金管理是一款基于 WordPress 开发的惠农资金查询管理插件，旨在帮助乡镇、村社等机构高效管理惠农资金，为村民提供便捷的资金查询服务，同时保障资金信息的安全性和可追溯性。插件支持乡镇、村层级管理，资金数据的增删改查、导入导出，前端用户查询，数据统计分析等功能，满足惠农资金管理的全流程需求。
二、核心功能
（一）后台管理功能
1.乡镇管理
￮支持乡镇的添加、编辑、删除操作，可快速维护乡镇基础数据
￮分页展示乡镇列表，支持按乡镇名称搜索，快速定位目标乡镇
￮乡镇删除时自动级联删除下属的村及关联的资金记录，保证数据一致性
2.村级管理
￮支持村的添加、编辑、删除操作，需关联所属乡镇
￮分页展示村列表，支持按村名称或所属乡镇名称搜索
￮村删除时自动级联删除关联的资金记录，确保数据完整性
3.惠农资金管理
￮支持惠农资金记录的添加、编辑、删除操作，涵盖各类惠农补贴：
地力补贴、稻谷补贴、实际种粮农民一次性补贴、农机补贴、森林生态效益补偿资金、退耕还林补贴、低保金、养老金、高龄补贴、特困救助、残疾人生活补贴、残疾人护理补贴、冬春救助、生态护林员补助、公益性岗位补助
￮身份证号格式验证，确保输入的身份证号符合 18 位规范
￮重复记录验证：同一身份证号在同一年度仅能存在一条资金记录，避免数据重复
￮分页展示资金列表，支持按姓名、户号、身份证号、乡镇或村名称搜索，快速定位目标记录
￮编辑资金记录时通过 AJAX 异步加载表单，无需刷新页面，提升操作体验
4.查询记录管理
￮完整记录所有前端查询操作，包括查询条件（乡镇、村、查询方式、查询值、年度）、查询结果、唯一防伪码、查询时间、查询 IP 地址
￮支持查看单条查询的详情，展示完整的查询条件、结果汇总、防伪码信息
￮分页展示查询记录，支持按防伪码、IP 地址或查询内容搜索，便于追溯查询操作
5.数据导入导出
￮导出功能：按年度将资金数据导出为 CSV 文件，支持 Excel 直接打开，通过 UTF-8 BOM 解决中文乱码问题
￮导入功能：导入 CSV 格式的资金数据，自动识别表头，匹配乡镇、村和资金字段，验证数据格式和重复记录
￮提供导入模板下载，用户可按模板格式整理数据，确保导入数据的正确性
（二）前端查询功能
1.查询表单嵌入：通过[****]短码可在任意 WordPress 页面或文章中嵌入查询表单
2.多方式查询：支持户号或身份证号两种查询方式，需选择对应的乡镇、村和查询年度
3.隐私保护机制：
￮未登录用户：姓名第二个字用*替代，身份证号和户号仅显示首尾 2 位，中间部分用*隐藏
￮登录用户：可查看完整的个人信息和资金记录详情
4.防伪验证：每次查询生成唯一的 22 位防伪码，可通过后台查询记录验证该查询结果的真实性
5.结果展示：清晰展示查询到的所有资金记录，自动汇总总金额，分类展示各类补贴的具体金额
（三）数据统计分析
1.数据仪表盘：后台首页展示核心数据统计：
￮乡镇总数、村总数、资金记录总条数、累计查询次数
2.年度资金统计：
￮支持两种统计维度：按乡镇汇总、按 “乡镇 + 村” 汇总
￮展示各类补贴的年度总金额，自动计算所有补贴的总计金额
￮支持切换统计年份，查看不同年度的资金分布情况
（四）系统设置与维护
1.查询配置：
￮服务开关：可开启 / 关闭前端查询服务，关闭后前端查询将提示服务暂停
￮隐私保护：开启 / 关闭用户信息脱敏功能
￮统计控制：开启 / 关闭查询次数统计、查询记录保存功能
2.分页配置：可自定义各管理页面的每页显示条数（乡镇列表、村列表、资金列表、查询记录列表），范围 1-100 条
3.查询限制：设置每个 IP 地址每日的最大查询次数，0 表示无限制
4.数据重置：支持重置查询记录、资金数据、村数据、乡镇数据、所有数据，或重置系统设置为默认值，操作前需确认，防止数据丢失
三、使用流程
（一）后台初始化
1.安装激活：将插件文件上传至 WordPress 插件目录，在 WordPress 后台 “插件” 页面启用该插件，插件将自动创建所需的数据库表
2.基础数据搭建：
a.先添加乡镇信息：进入 “惠农资金管理 – 乡镇管理” 页面，添加所有乡镇
b.再添加村信息：进入 “惠农资金管理 – 村级管理” 页面，为每个乡镇添加对应的村
c.录入资金数据：可选择手动添加（进入 “惠农资金管理 – 惠农资金管理” 页面添加单条记录）或批量导入（进入 “惠农资金管理 – 数据导入导出” 页面，下载模板，整理数据后导入）
3.系统配置：进入 “惠农资金管理 – 插件设置” 页面，根据实际需求配置查询设置、分页设置、IP 限制等
（二）前端查询使用
1.嵌入查询表单：在需要展示查询功能的页面或文章中插入短码[huinong_fund_query]，发布后页面将显示查询表单
2.村民查询操作：
a.选择所在的乡镇和村
b.选择查询方式（户号 / 身份证号），输入对应的查询值
c.选择查询年度，提交查询
d.查看查询结果，记录防伪码用于验证结果真实性
（三）日常维护
1.数据更新：定期在 “惠农资金管理 – 惠农资金管理” 页面更新或补充资金记录
2.数据备份：定期导出资金数据作为备份，进入 “惠农资金管理 – 数据导入导出” 页面按年度导出
3.查询管理：在 “惠农资金管理 – 查询记录” 页面查看查询记录，处理异常查询
4.系统调整：根据需求在 “惠农资金管理 – 插件设置” 页面调整系统配置
四、技术特性
1.WordPress 原生兼容：基于 WordPress 开发，完全适配 WordPress 后台界面和权限体系，无需额外配置
2.响应式设计：采用 Bootstrap 框架构建界面，适配手机、平板、电脑等不同设备屏幕
3.安全防护：
￮权限控制：仅具备manage_options权限的管理员可访问后台管理功能
￮输入验证：对身份证号、户号等敏感信息进行格式验证，防止非法输入
￮SQL 注入防护：使用 WordPress 内置的数据库操作方法，避免 SQL 注入风险
4.数据本地化：所有数据存储在 WordPress 本地数据库，数据可控性高，支持自主备份和恢复
5.体验优化：
￮AJAX 异步交互：编辑表单、查看详情等操作采用 AJAX 加载，减少页面刷新
￮数据脱敏：自动对用户隐私信息进行脱敏处理，保护用户信息安全
￮清晰的统计展示：通过仪表盘和统计表格直观展示数据情况，便于快速掌握资金情况
