xnx_fields 自定义字段插件

功能

• 为版块配置自定义字段，支持分类管理、字段定义、版块绑定、付费查看

• 5 张表：字段分类 / 字段定义 / 版块绑定 / 字段值存储 / 付费购买记录

• 字段类型：text / textarea / number / radio / checkbox / select / date / url / image

• 字段属性：必填、是否付费、付费积分类型（credits/golds/rmbs）、付费金额、占位符、排序

• slug 校验：分类 slug 全局唯一，字段 slug 在分类内唯一，仅允许 [a-z0-9_-]

• 版块绑定：一个版块绑定一个分类，支持批量绑定

• 付费查看：作者/管理员/版主免费查看，其他用户扣积分购买后可见，按字段类型渲染 HTML

• 发帖页 AJAX 切换版块时自动加载对应字段表单

• 帖子详情页展示字段值（付费字段未购买时显示购买按钮）

• 缓存机制：分类/字段/版块绑定 3600s 缓存，字段值用版本号机制失效

• 级联删除：删分类级联删字段 + 数据 + 购买记录 + 版块绑定；删字段级联删数据 + 购买记录

• 排序：分类和字段均支持手动排序

文件结构

plugin/xnx_fields/
├── conf.json
├── install.php / uninstall.php
├── setting.php                   # 重定向到管理页面
├── model/
│   ├── FieldsService.php         # 字段分类/定义/版块绑定/字段值 CRUD
│   └── FieldsPurchaseService.php # 付费购买流程（扣费/退款/HTML 渲染）
├── route/
│   ├── admin_xnx_fields.php      # 后台管理（分类/字段/版块绑定）
│   └── xnx_fields.php            # 前台路由（购买付费字段 / AJAX 取版块字段 HTML）
├── hook/
│   ├── model_inc_file.php
│   ├── model_route_table_end.php
│   ├── admin_index_route_case_end.php  # 注册后台 xnx_fields-{action} 路由
│   ├── index_route_case_end.php        # 注册前台 xnx_fields-{action} 路由
│   ├── thread_create_thread_end.php    # 发帖时保存字段值
│   ├── post_update_post_end.php        # 编辑帖子时更新字段值
│   ├── model_thread_delete_end.php     # 删帖时级联删字段值+购买记录
│   ├── post_subject_after.htm          # 帖子标题后注入字段展示
│   ├── thread_message_after.htm        # 帖子内容后注入字段展示
│   ├── post_js.htm / thread_js.htm     # 注入字段交互 JS
│   ├── forum_start.htm                 # 发帖页注入字段表单容器
│   ├── lang_zh_cn_bbs.php
│   ├── lang_zh_tw_bbs.php
│   └── lang_en_us_bbs.php
├── static/
│   ├── css/xnx_fields.css
│   └── js/
│       ├── post_fields.js        # 发帖页字段表单交互
│       ├── thread_fields.js      # 详情页字段展示与购买
│       └── xnx_fields_admin.js   # 后台分类/字段/绑定管理
└── view/htm/
    ├── setting.htm
    ├── post_fields.htm           # 发帖页字段表单模板
    ├── thread_fields.htm         # 详情页字段展示模板
    ├── xnx_fields_category_list.htm  # 后台分类列表
    ├── xnx_fields_field_list.htm     # 后台字段列表
    └── xnx_fields_forum_list.htm     # 后台版块绑定列表

配置流程

1. 后台启用插件

2. 进入「插件设置」（自动跳转到管理页面）→「分类管理」→ 新增字段分类（slug 仅小写字母数字下划线连字符）

3. 进入「字段管理」→ 为分类新增字段（选类型、是否必填、是否付费、付费金额等），可拖拽排序

4. 进入「版块绑定」→ 选择分类批量绑定到多个版块

5. 测试：在已绑定版块发帖，表单应出现字段；详情页查看字段值；付费字段需扣积分购买后可见