一、这是什么
在 WordPress 评论区加一个「夸夸」按钮：点击弹出一句夸奖语，可「换一个」，也可一键填入评论框。原本依赖特定主题私有钩子的部分已全部改为 WordPress 标准接口，因此在 OneNav 及其子主题、其他遵循标准评论模板的主题下都能用。
二、安装
- 后台「插件 → 安装插件 → 上传插件」，选择 kuakua-comment.zip，启用；
- 启用后去「设置 → 夸夸评论」调整：按钮文字、颜色、弹窗标题、两个按钮文案、语录（每行一条）。
三、按钮位置
按钮按三级兜底插入，互斥不会重复：
级别 | 方式 | 适用情况 |
一级 | comment_form_defaults 拼进 submit_button | 主题用标准 comment_form() 且保留默认提交按钮 |
二级 | comment_form 动作在提交按钮前直接输出 | 主题传了空的 submit_button、自己画按钮 |
三级 | 前端 JS 在评论框所在表单里补 | 主题完全自绘评论表单 |
插入后脚本还会做一次对齐：若按钮与提交按钮不在同一容器，会把按钮挪到提交按钮左侧；父容器是块级且按钮是 display:block 时，给容器补 .kuakua-submit-row 变成右对齐 flex 行。目标效果是 [ 夸夸 ] [ 发表评论 ] 同一行。
四、装完怎么验证
访问任意文章页，在网址后加 ?kuakua_debug=1：
- 页面源代码最底部会出现 <!– kuakua 2.3.0 –>，说明插件文件已是新版；
- 浏览器控制台会有 [kuakua] 初始化 {…}，含版本、评论框数量、弹窗数量、按钮数量；
- 若按钮位置仍不对，控制台还有一行「已插入提交按钮左侧 / 未能定位提交按钮 / 父容器 display=」，据此判断断在哪一环。
常见原因：
- 页面没有评论框（导航类主题首页通常没有，必须到文章页或详情页）；
- 旧插件仍在启用，两个按钮叠在一起；
- JS 被合并、压缩或延迟加载插件吞掉，控制台没有任何 [kuakua] 输出；
- 深色主题下按钮文字与背景同色，检查 .kuakua-btn 是否被主题的 a 规则覆盖。
五、自定义
- 外观：覆盖 .kuakua-btn、.kuakua-color-*、.kuakua-submit-row，建议写在子主题样式里，插件更新不会丢；
- 语录接口：GET /wp-json/kuakua/v1/random；AJAX action=kuakua_random_text（需 nonce）。可在「设置 → 夸夸评论」里整体关闭；
- 弹窗出现条件：过滤器 kuakua_should_render_modal，返回 false 即可不输出弹窗；
- 手动插入按钮：在主题模板里调用 echo kuakua_button_html();。
六、评论
填入评论框后不自动提交—— 点击「夸夸 TA」会直接替你发布评论，这一条在安全评估里属于高风险的刷评路径，已默认关闭。如需还原，在 functions.php 的 kuakuaData 数组里把 ‘auto_submit’ => false 改成 true。
七、边界
- 卸载会删除 kuakua_settings 与版本记录，不留残留；
- 语录接口默认对访客开放（只返回夸夸语，无敏感数据）。如需收紧，用 kuakua_rest_permission 过滤器返回 WP_Error；
- 没有 PHP 运行时的环境下无法做语法自检，本包已人工逐文件核对括号配平与 BOM，若站点报错请把报错行号发来。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论...