Zibll评论表情包管理插件，支持多分组表情展示、后台可视化上传与自动分组识别，可自定义默认分组、控制上传格式数量，实现评论内容自动渲染与输入框即时显示，兼容AJAX场景，让评论区更生动有趣。
Zibll 评论表情包管理插件的核心功能特点如下（不涉及 CSS/字体等样式细节）：
1. 评论区表情分组展示
- 支持表情按分组在评论面板中横向切换展示。
- 通过
zibll_additional_demo01_get_emoji_data()获取分组及表情数据，并传递至前端 JS 实现动态切换。
2. 保留/自定义默认分组
- 可选择是否保留主题自带的默认表情组。
- 支持自定义默认分组的显示名称（通过设置项
default_group_label）。
3. 后台可视化上传
- 在 WordPress 后台（基于 CSF 框架）提供上传界面，支持多图批量选择。
- 上传时自动创建以英文命名的分组文件夹，并将图片存入对应目录。
- 上传成功后自动更新分组配置，无需手动操作文件系统。
4. 自动识别目录分组
- 自动扫描配置的表情根目录下的所有子文件夹，将每个子文件夹视为一个分组，文件夹名作为分组标识。
- 新增文件夹无需手动注册即可自动出现在前台分组列表中。
5. 分组手动覆盖配置
- 支持通过后台配置界面（
emoji_groups组字段）手动指定目录的显示名称，或添加非自动扫描到的分组。 - 兼容旧版基于文本域（
group_lines）的分组定义方式，并自动合并迁移至新格式。
6. 表情资源路径自动兜底
- 若用户配置的
smilies_root目录不可用（不存在、不可读写），插件自动回退到wp_upload_dir()/zibll-comment-emoji/smilies。 - 回退后自动更新选项中的路径，减少因权限问题导致的表情失效。
7. 上传格式与数量控制
- 可配置允许的图片扩展名（如
gif,png,jpg,jpeg,webp），上传时自动校验。 - 可限制每组最多读取的表情数量（1～500），避免单组表情过多影响性能。
8. 评论内容自动渲染
- 评论中保存的
[g=token]标记会在前台展示时自动替换为对应的<img>表情图片。 - 通过
comment_text过滤器实现，优先级设置为1，确保尽早渲染。
9. 输入框即时替代显示
- 在评论输入区，用户选择或输入表情后，前端 JS 会将
[g=token]文本即时替换为表情图片显示，避免原始标记干扰输入体验。
10. AJAX 场景兼容
- 支持评论异步加载、提交后重新初始化表情面板，确保动态加载的内容中表情仍可正常切换和渲染（由前端脚本处理）。
11. 布局稳定性修正
- 包含对评论区高度异常的兜底处理，避免启用插件后出现大面积留白或页面抖动（由前端样式/脚本实现）。
适用场景
- 将 Zibll 主题评论区改造为“表情包评论区”，支持多分组、可扩展表情库。
- 运营或站长可在后台可视化维护表情素材，无需 FTP 或修改文件。
- 既保留评论中可存档的 token 结构（
[g=xxx]），又在前台显示为美观的图片效果。
