> 本文整理自平台文档 docs/wujies/5.x/plugins/social.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-eb733b28e484-cover.svg)
应用编码 social,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),license 为 MIT、装载不要凭证,仓库 [wujies-social-plugin](https://gitee.com/wujies/wujies-social-plugin)。
六类行为归它管:关注与粉丝、收藏夹与收藏、评论与回复、点赞、转发、拉黑,另有一份「互动行为」流水和两张统计表。被互动的对象都不在这个应用里,文章在 [内容中心](/docs/wujies/5.x/plugins/cms),图片在 [图床管理](/docs/wujies/5.x/plugins/gallery),商品与视频同理。每张动作表因此只带 target_type 加 target_id 一对引用,标题、封面和「点进去往哪走」交给拥有那个对象的应用。
前台那一屏它也不管:src/main/resources 下只有 mapper/social/,既无 site-templates/,也无 site-styles/。评论区和互动条的版式、挂载点、样式都在 CMS 主题里(post.html 上那串 data-cms-* 属性与 modules/interactions.html),本应用只回 JSON。两截 URL 因此各写了一遍:SocialSiteLinks 的 COMMENT_BASE、INTERACTION_BASE 与 CmsThemeProperties 的 COMMENT_API_BASE、INTERACTION_API_BASE 必须同值,改一边前台就调不到接口。
装它
dependencies 为空、MIT,任何部署都能直接装。装之前看三处:
1. 宿主 application.yml 的 open-api.tenant.path-patterns 要含 /site/(口径见 [部署配置](/docs/wujies/5.x/deploy/configuration))。匿名读评论树靠这条带认出当前租户,少了它前台那一片是空的。 2. 要有评论区与互动条,cms 得在。缺它时这 11 页后台和 /portal/ 照常可用,前台没地方挂载。 3. migrations/01-create-social-tables.sql 建 11 张表,脚本头写明「存量部署上这些表有数据,彻底删除会 DROP 它们」,动手前先备份。
安装过程与「装完菜单为什么没立刻出现」见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps),键归属规则见 [菜单归属](/docs/wujies/5.x/platform/app-market/menu-ownership)。装成功后侧栏多一个「社交互动」,两根枝下共 11 页,每页下面都挂满 query/add/edit/remove/export 五颗按钮:
| 分组 | 菜单 | 路由 | 需要的权限码 |
|---|---|---|---|
| 关注管理 | 关注统计 | followStatistics | social:followStatistics:list |
| 关注管理 | 关注数据 | follow | social:follow:list |
| 关注管理 | 关注分组 | followGroup | social:followGroup:list |
| 关注管理 | 黑名单 | block | social:block:list |
| 关注管理 | 收藏夹 | favoriteFolder | social:favoriteFolder:list |
| 互动管理 | 互动统计 | statistics | social:statistics:list |
| 互动管理 | 互动行为 | userAction | social:userAction:list |
| 互动管理 | 点赞(通用) | like | social:like:list |
| 互动管理 | 评论(通用) | comment | social:comment:list |
| 互动管理 | 收藏(通用) | favorite | social:favorite:list |
| 互动管理 | 转发(通用) | share | social:share:list |
11 页全是远程模块(component 写作 remote:social/social/<路由>),界面来自本仓库 frontend/,加载机制见 [远程应用](/docs/wujies/5.x/platform/architecture/remote-app)。
配它
sys_config 里一行都没有:app.json 的菜单没有「配置」这一项,宿主 ModuleBusinessSettings 认识的分类只有 mall、im、exam、gallery、cms 五个,social 不在其中。能调的量都写死在 Java 常量里,要改就得改代码、重打包、热加载一次。
| 项 | 现值 | 写在哪 | 什么时候要改 |
|---|---|---|---|
| 可被评论的目标 | article、image | SocialSiteCommentService.TARGET_TYPES | 商品详情、视频页要接评论区时放开这一处 |
| 可被点赞/收藏/转发的目标 | article、image | SocialSiteInteractionService.TARGET_TYPES | 与上一行一起放;表是通用的,收窄只发生在常量上 |
| 评论正文字数上限 | 500 | SocialSiteCommentService.CONTENT_MAX,超限报「评论内容最多 500 字」 | 宿主 KCommentSection.vue 的 maxlength 同值,两边要一起动 |
| 评论树每栋预览条数 | 2 | SocialSiteCommentService.REPLY_PREVIEW | 想少发一次「展开更多」请求时调 |
| 转发渠道缺省值 | link | SocialSiteInteractionService#share | 前台那颗「分享」默认记复制链接,渠道全集在 social_share_type 字典里 |
| 点赞/收藏/转发的写入口径 | sync | 宿主 application.yml 的 wujies.social.site-write-mode,环境变量 WUJIES_SOCIAL_WRITE_MODE | 装了 RabbitMQ 的站点改成 mq:请求只投递、先回乐观数,落库由消费端做;投递失败当场退回 sync。值不是 sync/mq 时 social 插件起不来 |
| 队列批量阈值与落库间隔 | 50 条 / 2 秒 | SocialInteractionConsumer 的 BATCH_THRESHOLD 与 @Scheduled(fixedRate = 2000) | 只影响评论计数缓存的刷新节奏 |
目标类型的完整词表在字典 social_target_type(image、album、article、video、comment,由 02-create-social-dictionaries.sql 落库),另有 social_action_type、social_follow_type、social_share_type 三份。往字典里加一个值不会让那个对象变得可互动,公开接口只认上面那两枚常量。
用它
管理员那 11 页都是运营入口,三处口径值得单独说:
- 评论的审核只翻
status(PUT /social/comment/audit、PUT /social/comment/batchAudit,权限码social:comment:edit),0正常、1已删除、2已屏蔽。前台没有审核开关,新评论一进来就是0,也就是先发后审。公开那棵树只回status = '0',屏蔽一条等于把它和它下面的回复一起从访客眼前撤掉,后台列表里还在。 - 删评论按整栋删:
SocialCommentServiceImpl#deleteWithValidByIds先按commentId、rootId、parentId三个条件圈出要陪葬的行,删完再按图片分组回扣gallery_image的评论数。 - 后台手工增删关注(
POST/DELETE /social/follow)不动social_follow_statistics,那张表只有两条写入路:/portal/follow/**的关注与取消关注会同时更新双方那行,POST /social/followStatistics/refresh/{userId}(加/refresh/batch)从明细表现算覆盖。所以「关注数据」与「关注统计」两页数字对不上时,先跑一次 refresh。 social_block只有它自己那套后台 CRUD 在读写,公开评论与互动的任何一条路径都不查它,拉黑目前是一份台账。
会员在会员中心「社交互动」(/member/social)里看四档:我的点赞、我的收藏、我的转发、我的评论,标签上的数字来自 `G
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-eb733b28e484-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。