原创【插件】WP博客文章角标插件（置顶/原创/高亮/热帖）

================================================================
Zibll 子比文章角标插件（置顶 / 原创 / 热帖 / 高亮）
安装与使用说明
适配主题：Zibll 子比主题 V9
版本：1.0.0
作者：启点无盘网络
================================================================

一、插件简介
—————————————————————-
本插件专为 Zibll 子比主题 V9 开发，为文章提供「置顶 / 原创 /
热帖 / 高亮」四种角标标签。

· 角标样式与子比原生角标（img-badge / jb-* 渐变）完全一致；
· 支持子比亮色 / 深色（暗色）模式自动切换；
· 完美兼容子比的 AJAX 分页、排序、下拉加载更多；
· 与子比自带的「置顶」图片角标自动去重，不会重复显示；
· 支持手动勾选，也支持按置顶、评论数、浏览量自动判定；
· 卸载时自动清理全部数据，不在数据库残留。

显示位置（共三处，可单独开关）：
1. 文章列表卡片缩略图左上角的角标；
2. 文章列表标题前的内联小角标；
3. 文章详情页标题前的角标。
其中「高亮」标签还会让列表卡片显示金色边框并让标题变色。

二、运行环境要求
—————————————————————-
· WordPress 5.6 及以上（已在 WordPress 6.7 实测）；
· PHP 7.2 及以上（推荐 7.4 / 8.0 / 8.1 / 8.2）；
· 推荐主题：Zibll 子比主题 V9。
– 缩略图角标依赖子比的列表结构；
– 标题前内联角标在其他主题下也可正常显示。

三、安装方法（两种，任选其一）
—————————————————————-

【方式一：后台上传 zip 安装，推荐】
1. 登录 WordPress 后台；
2. 进入「插件 → 安装插件 → 上传插件」；
3. 选择本插件压缩包 zibll-post-badges.zip，点击「现在安装」；
4. 安装完成后点击「启用插件」。

提示：必须上传 zip 压缩包，不要先在本地解压；也不要把
zibll-post-badges 文件夹再套一层文件夹后压缩。

【方式二：FTP / 宝塔等手动安装】
1. 将 zibll-post-badges.zip 解压，得到 zibll-post-badges 文件夹；
2. 把该文件夹上传到站点的
/wp-content/plugins/ 目录下；
3. 确保最终路径为
/wp-content/plugins/zibll-post-badges/zibll-post-badges.php；
4. 进入后台「插件」页面，找到「Zibll 文章角标（置顶/原创/
高亮/热帖）」，点击「启用」。

【升级旧版本】
先停用并删除旧版本，再按上面任一方式安装新版即可。
文章标签数据和设置在升级时不会丢失。

四、启用后基本配置
—————————————————————-
进入后台左侧菜单「设置 → 子比文章角标」即可打开设置页，
分为「显示设置」「自动规则」「标签设置」三个部分，详见
第七节。

五、四种标签说明
—————————————————————-
1. 置顶（红色渐变 #fd7a64 → #fb2d2d）
用于重要公告、推荐内容。可手动勾选，也可自动跟随
WordPress 内置置顶文章。子比主题本身已给置顶文章显示
图片角标，插件会自动去重并补充标题角标，不会重复。

2. 原创（蓝色渐变 #59c3fb → #268df7）
用于标注原创内容，需手动勾选；也可开启「新文章默认原创」。

3. 热帖（橙红渐变 #ff9a3c → #ff4d4d）
用于标注热门内容。可手动勾选，也可按评论数、浏览量阈值
自动判定。

4. 高亮（金黄渐变 #ffd86b → #ff9d00）
用于突出重点内容。除角标外，列表卡片会出现金色边框、
标题变色，视觉最醒目。需手动勾选。

一篇文章可同时使用多个标签，显示顺序固定为：
置顶 → 原创 → 热帖 → 高亮。

六、如何给文章打标签
—————————————————————-

【方法一：编辑文章（古腾堡 / 经典编辑器均支持）】
1. 进入「文章 → 所有文章」，点击文章标题进入编辑；
2. 查看右侧（古腾堡）或右下角（经典编辑器）的「文章角标」
面板；
3. 勾选需要的标签（置顶 / 原创 / 热帖 / 高亮）；
4. 点击「更新 / 发布」即可。

【方法二：快速编辑（适合批量操作）】
1. 在「文章 → 所有文章」列表中，将鼠标悬停在某篇文章上；
2. 点击「快速编辑」；
3. 中部会出现「文章角标」的四个勾选项，勾选后点击「更新」。

【方法三：列表中查看状态】
文章列表新增了「角标」一列，会直接显示每篇文章当前的
全部标签，方便快速核对。

七、设置页逐项说明（设置 → 子比文章角标）
—————————————————————-

（一）显示设置
· 列表标题内联角标：在列表标题文字前显示小角标。
· 列表缩略图角标：在列表卡片缩略图左上角显示角标（与子比
原生置顶样式一致），并自动兼容 AJAX 分页。
· 文章详情页角标：在文章正文页标题前显示角标。
· 高亮卡片效果：为「高亮」文章的列表卡片增加金色边框与
标题变色。

（二）自动规则（手动勾选始终优先于自动规则）
· 自动识别置顶文章：文章被设为 WordPress 内置置顶时，自动
显示「置顶」角标，并自动避开子比自带的置顶图片角标。
· 热帖·评论数阈值：评论数达到该值时自动标记为热帖；
设为 0 表示关闭按评论判定。默认 20。
· 热帖·浏览量阈值：浏览量达到该值时自动标记为热帖；
设为 0 表示关闭按浏览量判定。默认 0（关闭）。
· 浏览量字段名：子比主题默认使用 views，一般无需修改；
若使用其他统计插件，请填写对应的自定义字段名。
· 新文章默认原创：勾选后，新发布的文章默认带上「原创」。

（三）标签设置
每个标签（置顶 / 原创 / 热帖 / 高亮）都可单独设置：
· 启用：关闭后该标签在全站不再显示；
· 文字：自定义角标上的文字，例如把「热帖」改为「热门」；
· 颜色：可填写自定义颜色，留空则使用默认渐变配色
（支持 # 开头色值，如 #ff0000）。

八、自动规则与手动标签的关系
—————————————————————-
· 置顶：手动勾选，或命中「自动识别置顶文章」；
· 原创：仅手动勾选（或开启「新文章默认原创」）；
· 热帖：手动勾选，或评论数达到阈值，或浏览量达到阈值；
· 高亮：仅手动勾选。
只要任一条件成立即显示该标签；手动勾选的优先级最高。

九、兼容性说明
—————————————————————-
· 深色模式：自动跟随子比主题的暗色模式，无需额外设置；
· AJAX 分页 / 下拉加载：新追加的文章会自动渲染角标；
· 缓存：插件输出随页面缓存生效。若修改设置或标签后前台
没有变化，请清理页面缓存、CDN、对象缓存（如 WP Rocket、
W3 Total Cache、Redis 缓存等）后刷新；
· 若使用子比之外的主题，缩略图角标可能不显示，此时
标题前内联角标、详情页角标仍可正常使用。

十、卸载与数据清理
—————————————————————-
· 直接在后台「停用」插件不会删除任何数据；
· 在后台「插件」页面停用后再「删除」插件，会自动清理：
– 每篇文章的四个角标自定义字段；
– 后台的插件设置项。
如需彻底重置，删除后重新安装即可恢复默认设置。

十一、常见问题
—————————————————————-
问：浏览量自动热帖不生效？
答：子比默认把浏览量写入自定义字段 views，插件默认读取该
字段。若使用其他浏览统计插件，请在「设置 → 子比文章角标
→ 浏览量字段名」中填写对应字段名，并把「热帖·浏览量阈值」
设为大于 0 的数字。

问：为什么置顶文章只显示一个角标，不会重复？
答：子比主题本身会给置顶文章显示「置顶」图片角标。插件检测
到后会自动去重，仅在标题前补充内联角标，其余标签自动下移
排版。

问：修改设置或勾选标签后，前台没有变化？
答：通常是缓存导致，请清理页面缓存、CDN 与对象缓存，
并强制刷新浏览器（Ctrl + F5）。

问：后台保存文章时提示「不是合法的 JSON 响应」？
答：请确认使用的是本修复版（v1.0.0）。旧版本曾因文件头
混入不可见字符导致该提示，当前版本已修复。如仍出现，请
临时停用其他插件排查是否存在冲突，并联系作者。

问：安装时提示「插件文件不存在」？
答：一般是压缩包结构问题（多套了一层文件夹，或在 Linux
服务器解压时路径异常）。请使用本说明随附的
zibll-post-badges.zip，在后台直接上传安装，不要二次压缩。

十二、文件结构（供技术人员参考）
—————————————————————-
zibll-post-badges/
├─ zibll-post-badges.php 插件主文件（入口）
├─ uninstall.php 卸载清理脚本
├─ readme.txt 插件说明
├─ includes/
│ ├─ class-zblb-core.php 核心数据与自动规则
│ ├─ class-zblb-frontend.php 前台角标输出
│ ├─ class-zblb-admin.php 后台 Meta 框 / 快速编辑 / 列表列
│ └─ class-zblb-settings.php 后台设置页
└─ assets/
├─ frontend.css 前台样式
├─ frontend.js 前台脚本（AJAX 适配 / 去重）
├─ admin.css 后台样式
└─ admin.js 后台快速编辑脚本

================================================================
如在使用中遇到问题，可在后台「设置 → 子比文章角标」页面
对照本说明检查，或联系作者：启点无盘网络。
================================================================

扫码关注微信并回复“密码”，获取口令输入后查看内容

提交