QUX 主题内置短代码使用教程

QUX主题原生内置了多种实用短代码，无需安装额外插件，即可快速实现提示框、折叠面板、内容权限控制、下载面板等效果。所有短代码均可在文章编辑页右侧「短代码」面板中快速选择、一键复制到编辑区使用。

一、快捷使用方式

编辑文章时，可通过右侧「短代码」 metabox 快速插入，无需手动记忆代码：

1. 在「选择短代码」下拉菜单中，选中需要的短代码类型
2. 下方预览框会自动生成对应短代码模板
3. 复制预览框内的完整代码，粘贴到正文编辑器中
4. 替换模板中的文字、参数为自己的内容即可生效

二、提示通知类短代码

用于突出显示注意事项、通知提示、警告信息等，不同配色对应不同场景，视觉区分清晰。

1. 蓝色提示框 [ v_blue]

• 适用场景：普通说明、操作引导、信息提示
• 使用示例：

[ v_blue]这是一条蓝色提示信息，用于普通操作引导和内容说明[ / v_blue]

2. 绿色通知框 [ v_notice]

• 适用场景：成功通知、公告说明、正确操作提示
• 使用示例：

[ v_notice]配置已保存生效，刷新前台页面即可查看效果[ / v_notice]

三、折叠展开类短代码

折叠面板 [ collapse]

将长内容、次要内容默认收起，用户点击标题后展开，优化长文章阅读体验，适合教程步骤、补充说明、FAQ等场景。

• 参数说明：
  • title：折叠面板显示的标题文字
• 使用示例：

[ collapse title='点击查看详细安装步骤']
1. 下载主题安装包，无需解压
2. 进入后台 → 外观 → 主题 → 上传安装
3. 启用主题后完成基础配置
[ / collapse]

四、内容权限类短代码

用于控制内容的可见范围，实现登录可见、回复可见、付费/VIP可见等效果，是资源站、付费教程站的核心功能。

1. 登录可见 [ qltv]

• 功能：仅登录后的注册用户可查看内容，游客访问时会显示登录引导
• 使用示例：

[ qltv]此部分为会员专属内容，请先登录账号后查看[ / qltv]

2. 回复可见 [ reply]

• 功能：用户评论回复本文章后，才可解锁查看隐藏内容，用于提升文章互动量和评论数
• 使用示例：

[ reply]隐藏的资源链接和提取码，评论回复后即可显示[ / reply]

3. 付费/VIP可见 [ quxpay]

核心变现短代码，支持设置普通用户价格、不同等级会员专属折扣，用户支付后可查看隐藏的资源、教程等内容。

• 参数说明：
  

  参数	说明
  tid	唯一标识ID，提交文章时自动生成，生成后请勿更改，否则导致购买信息错乱
  price	普通用户购买价格
  currency	支付方式，可选 credit（积分）或 cash（现金）
  vip1price ~ vip4price	对应等级会员的专属价格，设为0表示该等级免费查看

• 使用示例：

[ quxpay tid price='5' currency='cash' vip1price='4' vip2price='3' vip3price='0' vip4price='0' ]
这里是付费隐藏的内容，可放置下载链接、源码、高清教程等专属资源。
[ / quxpay]

• 补充说明：
  • 会员等级从低到高为 vip1 ~ vip4，上级权限自动覆盖下级
  • 对应等级价格设为 0，该等级会员即可免费查看
  • 使用前需在主题后台完成支付接口、会员体系的基础配置

4. 商品购买可见 [ buy]

• 功能：绑定站点内已发布的商品，用户购买对应商品后，即可解锁查看隐藏内容。适合单资源单独售卖、多文章复用同一商品的场景。
• 参数说明：
  

  参数	说明
  product_id	商品的文章ID，即商品页对应的 Post ID，可在后台商品编辑页的浏览器地址栏查看

• 使用示例：

[ buy product_id='123']
此处为购买对应商品后可见的专属内容，可放置高清素材、完整源码、专属教程附件等。
[ / buy]

• 补充说明：
  • 使用前需先在后台发布对应商品，并完成支付接口、商品价格的配置，短代码才能正常生效
  • 与 [ quxpay] 的区别：[ quxpay] 直接在短代码内设置价格，适合单篇文章内的零散内容付费；[ buy] 绑定独立商品，适合统一管理商品信息、多文章复用同一商品的运营场景

五、下载展示类短代码

下载信息面板 [ dltable]

生成规范美观的下载说明面板，统一展示文件名、大小、免责声明和下载链接，适合资源下载类文章。

• 参数说明：
  

  参数	说明
  file	显示的文件名称
  size	显示的文件大小
  text	底部的提示/免责声明文字

• 使用示例：

[ dltable file='QUX主题安装包' size='2.5MB' text='本站资源均收集自互联网，仅供学习交流，如有版权问题请联系删除']
<a href="https://www.qyblog.cn/redirect/aHR0cHM6Ly/kvaDnmoTkuIvovb3lnLDlnYAuemlw" target="_blank" target="_blank">点击下载安装包</a>
[ / dltable]

六、使用注意事项

1. 所有短代码的方括号、单引号均为英文半角符号，使用中文符号会导致解析失效
2. 短代码内部支持嵌套普通文本、图片、列表、链接等内容，不建议多层嵌套同类型短代码
3. 付费、会员类短代码，需先在主题后台完成支付接口、会员等级配置后才能正常使用
4. 短代码在「可视化」和「代码」编辑模式下均可编辑，修改参数建议切换到代码模式，避免格式错乱