[插件更新] 文章分类筛选 v0.3.0 使用说明

本文共计1439个字，预计阅读时长5.8分钟。

本次更新

• 插件版本从 0.1.0 更新至 0.3.0（版本资料未注明具体变更内容）。
• 优化了分类筛选与自定义字段的交互逻辑，修复了已知问题（版本资料未注明详细修复项）。

功能介绍

文章分类筛选 允许管理员预先设定文章分类，用户在发帖或编辑主题时必须（可选）选择一个分类。首页和板块页面顶部将出现筛选栏，访客可以按分类快速过滤内容。

插件还支持 自定义字段，可为特定分类附加额外的结构化信息（如下载链接、版本号等），方便资源分享、Bug 反馈等场景。

使用教程

用户端

1. 发帖/编辑主题

在发帖表单的标题下方会出现“分类”下拉框，点击展开并选择所需分类。如果后台开启了“发帖必须选择分类”，则未选择分类时无法提交。

1. 首页筛选

首页顶部会显示所有启用的分类按钮（若后台开启“首页显示筛选”），点击任一分类即可仅显示该分类下的主题。

1. 板块筛选

进入某个板块时，板块页面的筛选栏同样会显示分类按钮（若后台开启“板块显示筛选”），点击即可过滤该板块内属于所选分类的主题。

1. 自定义字段填写

如果所选分类配置了自定义字段，发帖表单中会额外显示对应的输入框、下拉菜单或单选按钮。请按要求填写，必填字段未填写时无法发布。

管理员端

• 进入后台 → 应用 → 文章分类筛选，可进行所有配置（详见下方“后台设置”）。
• 在编辑主题时，管理员可以修改主题的分类以及自定义字段的值（Bug 反馈类主题还可更新“状态”等结构化字段）。

后台设置

在后台插件设置页面（setting.php）中，您可以配置以下选项：

全局开关

| 设置项 | 说明 |

|--------|------|

| 启用分类 | 开启后整个论坛的分类功能生效。 |

| 发帖必须选择分类 | 开启后用户发帖/编辑时必须选择一个分类。 |

| 首页显示筛选 | 开启后首页顶部显示分类筛选按钮。 |

| 板块显示筛选 | 开启后每个板块页面显示分类筛选按钮。 |

分类管理

点击“新增”或编辑已有分类，配置以下字段：

| 字段 | 说明 |

|------|------|

| 唯一标识 | 英文/数字，用于内部识别，不可重复。 |

| 显示名称 | 前台显示的分类名称。 |

| 颜色 | 分类标签的显示颜色（十六进制色值或颜色名称）。 |

| 适用板块 FID | 输入板块 ID，多个用英文逗号分隔。留空表示全站所有板块都可用。 |

| 允许用户组 GID | 输入用户组 ID，多个用英文逗号分隔。留空表示所有可发帖用户组都可选择（管理员和版主始终可选择）。 |

| 发帖模板 | 选择该分类时默认使用的发帖模板（可选）。 |

| 自定义字段 | 启用后，可为该分类添加额外字段。每行格式：字段名\|显示名称\|类型\|是否必填\|选项\|提示文字。类型支持 text（文本框）、textarea（多行文本）、select（下拉选择）、radio（单选按钮）。选项以英文逗号分隔。示例：version\|版本\|select\|1\|v1,v2\|请选择版本。 |

| 排序 | 数字越小越靠前。 |

| 启用 | 勾选后该分类在前台可见可用。 |

操作

• 保存分类设置：点击后保存所有分类配置。
• 删除：删除该分类，已有主题的分类信息会保留，但不可再被选择。

自定义字段还支持在“Bug 反馈”类主题中由管理员编辑状态、问题类型等信息，具体字段定义需在分类设置时按上述格式配置。

注意事项

• 管理员和版主不受“允许用户组”限制，始终可选择任意分类。
• 自定义字段的“选项”仅对 select 和 radio 类型生效，其他类型请留