BBS社区内容
BBS 社区（community）——独立社区插件，支持版块、多内容类型、互动与 SEO 配置。
免费
详情介绍
一、插件简介
BBS 社区是 Zsens Admin 的核心内容插件，提供前台论坛/社区广场、发帖回帖、版块与标签、用户互动及完整后台内容管理。应用中心负责运行开关与 URL 路由；站点品牌、主题、互动开关等在后台「社区内容 → 社区配置」维护。
| 入口 | 路径 |
|---|---|
| 前台首页（广场） | /community（默认，可改 route_entry） |
| 后台管理 | /admin/community_config（社区配置）；同级还有分类、帖子、回复等子菜单 |
URL 后缀说明：默认伪静态后缀为 html，下文路径示例写作 /community.html、/topic/1.html 等；实际以应用中心「BBS社区」配置项「伪静态后缀」为准，留空则无后缀。URL 模式（普通 / PATHINFO / 伪静态）亦在同处配置。
二、核心能力
| 能力 | 说明 |
|---|---|
| 多内容类型 | 讨论、文章、问答、图集、音乐、软件等 Hub 页与开关 |
| 版块与标签 | 分类管理、推荐、侧栏；标签独立列表样式 |
| 发帖与回帖 | 登录控制、联系方式绑定校验、版主操作 |
| 用户互动 | 点赞、收藏、关注、打赏、举报 |
| 积分金币 | 新用户赠送、行为奖励、金币流水 |
| 单页系统 | 关于/条款等独立页，页脚 @page:别名 链接 |
| 路由可配 | 首页/版块/详情及扩展路由可在应用中心自定义 |
| 主题与布局 | 多主题、单列/双列/三列、列表样式与翻页模式 |
| SEO | 首页标题、关键词、描述；站点域名后缀 |
| 插件生态 | 为签到、任务、消息等插件提供前台基座与 URL 后缀 |
三、依赖与安装
- 在应用中心安装并启用
community（BBS社区）。 - 安装时自动执行
install.sql，创建社区相关数据表，并写入默认版块与后台菜单。 afterInstall()会写入标准顶部导航（不含其他插件入口）。- 无硬依赖其他插件；部分配置项（如发帖需绑定联系方式）软依赖
mail/sms插件。 - 卸载会删除社区全部数据表（帖子、回复、收藏等），操作不可逆，请先备份。
四、应用中心基础配置
在应用中心 → BBS社区 → 配置，字段来自 CommunityPlugin::configSchema()：
| 配置项 | 类型 | 说明 |
|---|---|---|
运行状态 enabled | 开关 | 关闭后前台社区入口不可访问 |
URL 模式 url_mode | 下拉 | normal 普通 / pathinfo PATHINFO / rewrite 伪静态 |
伪静态后缀 url_suffix | 文本 | 填 html 则链接带 .html；默认 html |
首页路由 route_entry | 文本 | 广场首页路径，默认 community |
版块路由 route_path_category | 文本 | 须含 :id，默认 category/:id |
详情路由 route_path_topic | 文本 | 须含 :id，默认 topic/:id |
其他路由 route_extras | 路由扩展 | 搜索、发帖、用户主页等；未配置则用系统默认 |
五、后台/重点配置
后台路径：社区内容 → 社区配置（admin/community_config），字段来自 adminConfigSchema()，主要分组如下：
基础与导航
- 站点名称 / LOGO / 域名 / 副标题：品牌展示与 SEO 后缀
- 顶部导航 `nav_items`：可视化配置，格式
标题|链接|标识|可见性|图标|布局|子导航
SEO 与展示
- SEO 标题 / 关键词 / 描述（仅首页）
- 前台主题 `theme`、广场列表样式、默认布局（单列/双列/三列）、布局切换开关
- 每页帖子数、列表翻页样式（常规翻页 / 下拉加载）
注册与发帖
- 开放前台注册、发帖需登录、发帖需绑定联系方式（需 mail/sms）
互动功能
- 点赞 / 收藏 / 关注 / 举报 / 金币打赏及固定金额
- 帖子高亮及色板
- 各内容类型开关（讨论、文章、问答、图集、音乐、软件、视频）及 Hub 封面/样式
页脚
- 页脚简介、社交链接、栏目（支持
@page:别名）、ICP/公安备案
行为奖励
- 后台 行为奖励（
admin/behavior_reward）配置发帖/回帖等行为的积分金币奖励
内容管理子菜单
社区配置、内容模型、分类管理、帖子管理、回复管理、标签管理、单页管理、举报管理。
六、前台用户流程
- 访客进入广场首页
/community.html，浏览全部动态或各 Hub（文章、问答等）。 - 点击版块进入
/category/{id}.html，按分类浏览帖子。 - 注册/登录（可在社区配置中控制是否开放注册）。
- 发帖：访问发帖页 → 填写标题与正文（可经
editor插件富文本）→ 选择版块与类型 → 提交。 - 帖子详情
/topic/{id}.html：阅读、点赞、收藏、打赏、举报、回复；问答帖可采纳最佳回复。 - 用户主页
/u/{type}/{id}.html：查看 TA 的主题与互动。 - 会员中心：我的主题、收藏、关注等（路由可在
route_extras中配置）。
七、后台审核与运维
| 模块 | 说明 |
|---|---|
| 帖子/回复管理 | 审核、隐藏、删除；支持状态切换 |
| 举报管理 | 查看举报记录，处理并更新状态 |
| 分类/标签/单页 | 日常内容结构维护 |
| 内容模型 | 控制各类型字段与展示 |
| 社区配置 | 运营策略、互动开关、页脚与 SEO 一次性调整 |
八、特殊说明
路由
- 前台路由由
FrontRoute::register()动态注册，路径取自配置合并默认值。 - 其他插件（如
taskcenter、verify）通过FrontRoute::urlSuffix()继承相同 URL 后缀。
钩子
- 社区模板广泛使用
hook_slot()，供广告、编辑器、签到、邀请等插件注入。 - 发帖页：
compose_body、compose_assets；布局：bar_actions_before_post、layout_body_end、member_nav_extra等。
数据表
- 含
community_topic、community_reply、community_category、community_like、community_coin_log等；卸载全部删除。
兼容迁移
ensureSchema()/ensureMenus()在已安装站点自动补表、补菜单；旧版导航会自动升级。
九、推荐上线清单
- 应用中心开启社区，确认 URL 模式与服务器 Rewrite 一致
- 配置站点名称、LOGO、ICP 备案
- 设置 SEO 标题与描述
- 创建版块并设置推荐分类
- 确认注册/发帖策略（登录、验证码、联系方式绑定）
- 配置互动开关（点赞、打赏、举报类型）
- 检查页脚单页链接（关于、隐私政策）
- 安装
editor、captcha、message等配套插件并测试发帖流程
十、常见问题
Q：前台 404，后台正常？ 检查 url_mode 是否与 Nginx/Apache 重写规则匹配；伪静态模式需配置 Rewrite 到 index.php。
Q：链接没有 `.html` 或多了 `.html`？ 修改应用中心「伪静态后缀」，与服务器规则保持一致。
Q：卸载社区后其他插件报错？ 多数运营插件依赖社区会员体系，请勿单独卸载社区，或先停用依赖插件。
Q：发帖页仍是纯文本框？ 安装并启用 editor 插件，在应用中心选择编辑器类型。
Q：行为奖励不生效？ 确认「行为奖励」开关开启，且在 admin/behavior_reward 中配置了对应行为规则。
更新记录 （22）
-
v1.2.2
2026-09-02
1、Toast 层级上调，避免被签到/版主等弹窗遮挡 2、布局 <head> 增加签到、抽奖插件 CSS 预加载开关，减少侧栏刷新闪烁 3、FrontBase 增加 enable_signin / enable_lottery 视图变量 4、修复 layout 编码损坏导致的前台脚本/头像菜单异常（恢复可用布局）
-
v1.2.1
2026-08-31
1、优化整体单列布局UI宽度 2、新增板块列表版主申请入口
-
v1.2.0
2026-08-30
1. 修复后台安装 / 升级报错`fields not exists:[show_plaza]`，在`install.sql`新增`show_plaza`字段，执行顺序为先补字段，再导入种子数据 2. 图库详情页改版为瀑布流，最大 3 列，遵循 2/3 倍数排版规则，单张图片做通铺展示 3. 单列整页布局统一适配，和双列、三列保持一致，按屏幕宽度 80% 做居中自适应 4. 清理`base.css`内部注释乱码，移除内测标记、全角冒号等异常内容 5. 删除`minify.mjs`、`base.min.css`文件，仅保留维护源文件`base.css`
-
v1.1.9
2026-08-29
优化卡片二级导航弹窗不自动关闭问题
-
v1.1.8
2026-08-29
1、视频弹窗：接口拆分 lite/side、避免误报「加载失败」、减轻 play() 打断报错；弹窗打开时不再误触发列表无限滚动导致 500。 2、整站访问速度：AJAX/JSON 跳过整页壳层、侧栏/分类/作者统计短缓存、列表作者链接去掉逐条查库。 3、左侧公告：只要帖子勾了「公告」就显示，不再按版块过滤，也不依赖全局置顶。 4、体验相关修复：无限滚动 AJAX 不再被当成 JSON 接口跳过 View（修线上 500）；资源版本号随 JS 更新便于刷新缓存。
-
v1.1.7
2026-08-28
1、优化聚合页封面加载方式 2、优化列表封面加载 3、其他问题优化
-
v1.1.6
2026-08-28
1、优化发帖速度缓慢问题 2、优化视频列表弹窗加载问题 3、优化媒体直链/代理方式 4、新增分类后台推送首页动态
-
v1.1.5
2026-08-28
1、优化发帖下拉样式 2、修复手机端上传视频获取不到封面
-
v1.1.4
2026-08-28
优化返回报错问题
-
v1.1.3
2026-08-28
优化视频图片上传逻辑
-
v1.1.2
2026-08-27
1、优化网盘储存加载速度 2、优化前端UI样式细节 3、优化视频列表手机端弹出播放
-
v1.1.1
2026-08-27
优化视频列表弹窗UI
-
v1.1.0
2026-08-27
1、新增内容模型 视频（video），字段：video_url / video_cover / video_duration 2、新增路由：/videos、视频上传、预览、流代理、弹窗数据 API 3、新增 VideoHelper：支持 mp4 直链、B站、YouTube；封面解析与镜像存储 4、后台可开关视频模型，版块可设为「视频」类型
-
v1.0.9
2026-08-26
优化自适应适配问题
-
v1.0.8
2026-08-26
修复装扮商城适配问题
-
v1.0.7
2026-08-26
1、新增支持列表、功能卡片两种展示样式 2、新增后台自定义导航排序 3、后台支持配置导航子项、卡片色系，可配置「最新 / 热门」等 feed 标签 4、二级导航改为下拉展开 / 收起交互，移除遮罩层 5、修复下拉面板定位，下拉与主体左右对齐，解决 100vw 引发的横向滚动问题 6、修复筛选条 (动态 / 新帖 / 精华) + 单列 / 双列切换布局对齐异常 7、修复单列壳层场景下，二级下拉菜单相对 “发现” 等标题居中显示；双列、三列 8、带二级菜单的顶级导航项，统一渲染前置图标 + 后置下拉箭头
-
v1.0.6
2026-08-26
1、新增分类发帖审核权限 2、优化适配头像框商城插件
-
v1.0.5
2026-08-25
1、新增「板块置顶」：字段 is_category_top，板块内排序优先于时间；广场/全站不抬升；前后台可操作，列表徽章文案为「置顶」、样式与全局置顶区分。 2、管理字段权限映射迁入插件：新增 TopicModPerm，含板块置顶等完整字段→权限映射；帖子页与管理接口改走插件判断。 3、清理核心重复映射：从 CommunityPerm 去掉已无用的 TOPIC_FIELD_PERMS / canManageTopicField 等；等级、角色、can() 等仍保留。 4、修复手机点输入框整页放大：移动端输入控件统一 ≥16px，并刷新 CSS 缓存。
-
v1.0.4
2026-08-24
优化图片加载方式，修复外链图片链接失效问题
-
v1.0.3
2026-08-24
优化弹窗信息提示样式
-
v1.0.2
2026-08-24
发帖/编辑保存时按版块同步 content_type 前台只能选同内容模型版块，禁止跨模型换版 后台可跨模型改版，并同步内容模型 后台编辑页传入 only_active_extras，只展示该帖已启用的拓展
-
v1.0.1
2026-08-24
首次发布