✨ 功能特性
📦
小工具卡片网格
WordPress 后台拖入「玖源社软件下载」小工具，选择分类自动生成横版卡片网格，支持自定义标题、副标题、右侧按钮
✏️
文章元数据面板
文章编辑页新增「下载信息设置」面板，填写评分/版本/大小/语言/系统/更新日期/简介/下载链接
📄
文章内嵌下载框
在设置了下载信息的文章内容最上方，自动注入横排下载信息框（图标+标题+星级+信息行+按钮）
⬇️
下载详情弹窗
点击卡片「下载」按钮弹出详情弹窗，展示版本·大小·语言·系统·更新·简介，含立即下载和查看详情操作
📋
短代码支持
使用 [jiuys_xiaz] 短代码可在任意文章或页面中嵌入卡片网格，支持 category_id / count / columns / gap 参数
🖥️
页面模板
内置「软件下载列表页」页面模板，蓝色渐变横幅 + 卡片网格 + 分页，侧边栏可配置分类和标题
🎨
智能图标获取
文章特色图 → 正文首图 → 渐变色首字母头像，三层降级确保每张卡片都有视觉标识
⭐
星级评分渲染
支持整星/半星/四分之三星渲染，从 jx_rating 字段读取（1~5），无数据时按评论数智能兜底
🌙
暗色模式适配
CSS 变量驱动，跟随子比主题 .dark-theme 类名自动切换暗色样式，所有组件完美适配
🔗
标题可点击跳转
卡片标题链接到文章详情页，弹窗内「查看详情」也跳转文章，形成完整的浏览路径
📐
灵活的间距控制
卡片间距通过 CSS 变量 --jx-gap 控制，后台可输入 8~30px 自定义间距值
🎯
分类自动筛选
后台下拉选择任意 WordPress 分类，自动读取该分类下所有已发布文章作为卡片数据源
👁️ 卡片布局预览
小工具前端实际效果 —— 横版三栏卡片，左图标 + 中信息 + 右下载按钮：
常用软件下载
高效办公必备工具合集
更多软件 ›
微信 PC 版
★★★★☆ 4.0
QQ
★★★★★ 5.0
钉钉
★★★☆☆ 3.0
📄 文章内嵌下载框演示 Auto Inject
编辑文章并填写下载信息后，访问文章时正文顶部自动显示如下下载信息框（首字母头像兜底示例）：
WPS Office 2024 v12.8.0
立即下载
★★★★★
WPS Office 2024 是一款专业的办公套件，支持文字、表格、演示三大功能模块，兼容 MS Office 格式，内置 PDF 工具和云文档同步。
🖥️ 页面模板演示 Page Template
新建页面 → 选择「软件下载列表页（玖源社）」模板 → 发布后显示如下：
WPS Office
★★★★★
Chrome 浏览器
★★★★★
VS Code
★★★★★
← 上一页 1 2 3 下一页 →
⬇️ 下载详情弹窗演示 Modal
点击卡片「下载」按钮后弹出的详情弹窗：
×
WPS Office 2024
★★★★★
版本：v12.8.0
大小：286 MB
语言：中文
系统：Windows
更新：2026-06-20
WPS Office 2024 专业办公套件，支持文字/表格/演示三大模块，兼容 MS Office 格式，内置 PDF 工具与云文档同步。
🚀 部署安装
-
下载插件包
获取jiuys-xiaz.zip安装包文件 -
WordPress 后台上传安装（推荐）
后台 → 插件 → 安装插件 → 上传插件 → 选择jiuys-xiaz.zip→ 现在安装 → 启用 -
FTP 手动上传（备选）
解压jiuys-xiaz.zip得到jiuys-xiaz/文件夹，上传至服务器/wp-content/plugins/目录，然后在后台启用 -
确认启用成功
启用后在后台「外观 → 小工具」中应能看到「玖源社软件下载」小工具，文章编辑页会出现「下载信息设置」面板 -
（可选）使用方式
方式一：拖入小工具到侧边栏；方式二：短代码[jiuys_xiaz]嵌入文章/页面；方式三：新建页面选「软件下载列表页」模板；方式四：填写文章 Meta 自动内嵌
环境要求：WordPress 5.0+，PHP 7.0+，建议配合子比主题（Zibll 8.x）使用以获得最佳效果。不依赖子比主题也可正常运行，CSS 变量会回退到默认值。
📁 文件结构
jiuys-xiaz/
├── jiuys-xiaz.php # 主插件文件 · Widget类 · Shortcode · Meta Box · 内嵌注入 · 弹窗JS · 页面模板注册
├── css/
│ └── style.css # 前端全部样式 · 卡片网格 · 弹窗 · 内嵌框 · 页面模板 · 暗色模式
└── templates/
└── page-software-list.php # 软件下载列表页模板 · 蓝色横幅 + WP_Query + 分页
⚙️ 小工具后台配置项
| 标题 | 小工具顶部显示的标题文字（如「常用软件下载」），留空则不显示 |
| 副标题 | 标题下方的小字说明（如「高效办公必备工具合集」），留空则不显示 |
| 按钮文字 | 标题右侧按钮上的文字（如「更多」「查看全部」），留空则不显示按钮 |
| 按钮链接 | 按钮点击后跳转的 URL 地址 |
| 图标类名 | FontAwesome 图标类名（如 fa fa-angle-right），留空默认箭头 |
| 选择文章分类 | 下拉选择 WordPress 分类，自动读取该分类下的文章作为卡片数据 |
| 显示文章数量 | 1 ~ 50 篇，默认 12 篇 |
| 卡片间距(px) | 8 ~ 30 px，默认 16 px，控制卡片之间的间隔距离 |
📝 文章元数据面板字段
在文章编辑页的「下载信息设置」面板中可填写以下字段：
| 评分 (1-5) | 数字输入，步进 0.5，显示为星级评分（如 4.5 = 四星半）。未填时根据评论数智能兜底 |
| 版本号 | 文本输入（如 v12.8.0），显示在内嵌框标题和弹窗中 |
| 文件大小 | 数字 + 单位选择器（MB / GB），如「128 MB」「2.1 GB」 |
| 语言 | 下拉选择：中文 / English / 其他 |
| 系统要求 | 下拉选择：Windows / 安卓(Android) / 苹果iOS / 苹果Mac / Linux |
| 更新日期 | 日期选择器（YYYY-MM-DD 格式） |
| 简介 | 多行文本，软件功能描述，显示在内嵌框和弹窗中 |
| 下载链接 | URL 输入，「立即下载」按钮跳转地址 |
📟 短代码参考
最简用法
[jiuys_xiaz category_id="1"]
显示分类 ID 为 1 的文章，其余参数使用默认值（数量12、间距16px等）
完整参数
[jiuys_xiaz
title="常用办公软件"
category_id="3"
count="8"
columns="4"
gap="16"
]
| 参数 | 默认值 | 说明 |
|---|---|---|
title | 空 | 卡片网格上方显示的标题 |
category_id | 0 | 文章分类 ID（必填，否则不显示） |
count | 12 | 显示文章数量（1 ~ 50） |
columns | 4 | 每行列数（用于 CSS 参考和小工具内部传递） |
gap | 16 | 卡片间距（px） |
🔗 数据流 — Post Meta 字段
所有软件信息存储在文章的自定义字段（Post Meta）中，前缀统一为 jx_：
jx_rating | 评分 (1~5 浮点数) → 卡片星级渲染 + 弹窗星级 |
jx_version | 版本号字符串 → 内嵌框标题组合 + 弹窗版本行 |
jx_size | 文件大小（如 "286 MB"）→ 卡片 meta 行 + 弹窗大小行 |
jx_language | 语言（中文/English）→ 卡片 meta 行 + 弹窗语言行 |
jx_system | 系统要求 → 卡片 meta 行 + 弹窗系统行 |
jx_update_date | 更新日期（Y-m-d）→ 内嵌框更新行 + 弹窗更新行 |
jx_desc | 简介文本 → 内嵌框描述区块 + 弹窗描述区 |
jx_download_url | 下载链接 URL → 「立即下载」按钮跳转目标 |
🔬 技术参数
| 插件名称 | 玖源社软件下载小工具 |
| 插件别名（目录 / Text Domain） | jiuys-xiaz |
| 主文件 | jiuys-xiaz.php |
| 版本 | v1.0.0 |
| 作者 | 玖玖 QQ：366818451 |
| 插件主页 | https://www.jiuys.cn/ |
| 适用 WP 版本 | WordPress 5.0+ |
| PHP 要求 | PHP 7.0+ |
| 依赖主题 | 推荐子比主题（Zibll 8.x）；纯 WP 可运行，部分 CSS 变量需自行适配 |
| 小工具 ID | jiuys_xiaz_widget |
| Widget 类名 | Jiuys_Xiaz_Widget extends WP_Widget |
| 短代码 | [jiuys_xiaz category_id="1" count="12"] |
| Meta 前缀 | jx_（共 8 个字段） |
| CSS 类名前缀 | jx-（卡片/弹窗/内嵌框/页面模板均使用此前缀） |
| 暗色模式 | 跟随子比主题 .dark-theme 类名切换 |
| 图标优先级 | 特色图片 → 正文首图 → 首字母彩色头像 |
⚠️ 注意事项
图标获取优先级：卡片图标优先使用文章特色图片 → 其次提取正文第一张图片 → 最后使用软件名首字母生成彩色圆形头像兜底。确保文章有特色图片可获得最佳显示效果。
FontAwesome 图标：小工具标题右侧按钮支持 FontAwesome 图标类名（如
fa fa-angle-right、fa fa-external-link 等）。子比主题已内置 FontAwesome，无需额外引入。文章内嵌触发条件：只有同时填写了「下载链接」或「版本号」至少一项时，才会在文章内容页顶部注入下载信息框。两项都为空则不注入。
⚡ 快速调用参考
/* 小工具：后台拖入即可 */
/* 短代码 — 三种常见用法 */
[jiuys_xiaz category_id="1"] # 最简：显示分类1的文章
[jiuys_xiaz cat="软件资源"] # 按分类名称（需额外开发解析）
[jiuys_xiaz category_id="3" count="8"] # 分类3 + 显示8篇
[jiuys_xiaz title="设计工具" category_id="5"] # 自定义标题 + 分类5