子比父主题弹幕留言墙功能包

这是独立版留言页面功能包，可直接放到子比父主题 zibll 目录运行，不依赖子主题。

本包已去掉广告模块，保留弹幕留言墙、真实评论展示、前台发布留言、点赞、每人每条最多点赞 3 次、点赞后弹幕暂停、点赞皮肤规则、精选留言弹窗、内置祝福文案生成等功能。

1. 上传文件

将 zibll-message-board-page 文件夹上传到：

/wp-content/themes/zibll/zibll-message-board-page

最终结构应类似：

/wp-content/themes/zibll/zibll-message-board-page/inc/zibll-message-board-page.php
/wp-content/themes/zibll/zibll-message-board-page/template-message-board.php
/wp-content/themes/zibll/zibll-message-board-page/assets/message-board/css/message-board.css
/wp-content/themes/zibll/zibll-message-board-page/assets/message-board/js/message-board.js

2. 在父主题 func.php 引入

打开或创建：

/wp-content/themes/zibll/func.php

写入：

<?php
require_once get_template_directory() . '/zibll-message-board-page/inc/zibll-message-board-page.php';

如果 func.php 里已经有 <?php，只需要追加下面这一行：

require_once get_template_directory() . '/zibll-message-board-page/inc/zibll-message-board-page.php';

子比父主题会自动加载 func.php。

3. 创建留言页面

进入 WordPress 后台：

页面 -> 新建页面 -> 模板选择“弹幕留言墙” -> 开启评论 -> 发布

留言墙读取当前页面自己的真实评论。用户在这个页面发布的留言，会作为当前页面评论保存；审核通过后显示到弹幕墙。

4. 后台设置

进入：

子比主题设置 -> 扩展&增强 -> 弹幕留言墙

可配置：

• 发布按钮文字
• 弹窗标题和说明
• 留言输入提示
• 提交按钮文字
• 读取留言数量
• 弹幕行数
• 弹窗最大宽度
• 点赞皮肤开关
• 点赞皮肤规则，例如 10 赞、20 赞、100 赞
• 精选留言弹窗开关、标题和切换间隔

5. 功能说明

• 弹幕内容来自当前页面已审核评论。
• 游客和登录用户都可以提交留言，具体审核规则遵循 WordPress 评论设置。
• 每个用户或游客对同一条弹幕最多点赞 3 次。
• 点赞后当前弹幕会暂停滚动，其他弹幕继续滚动。
• 点赞数量达到后台设置规则后，会自动使用对应皮肤。
• 精选留言弹窗可在全站前台展示，内容来自已达到点赞皮肤规则的留言。
• “AI智能祝福”按钮在独立包内使用内置祝福文案库随机生成，不依赖子主题 AI 写作模块。

6. 注意事项

• 这是直接放父主题的方式，父主题更新可能覆盖文件，请提前备份 zibll-message-board-page 文件夹和 func.php。
• 如果你当前子主题里也启用了同类留言墙功能，不建议两个版本同时开启，避免 AJAX 动作、样式或模板重复。
• 本包不包含广告模块，也不依赖子主题的违禁词扩展；留言安全和审核默认走 WordPress 评论系统。