Shop 虚拟资源商城主题

面向 源码 / 素材 / 网盘资源 / 数字商品 站点的 Hope CMS（希望CMS）商城主题。把「文章」变成可售卖、可鉴权的下载资源：前台完成选购、支付、会员开通与下载；后台用文章自定义字段配置权限与价格。

适合谁用

源码站、模板站、素材站、课程资料站
需要 单篇付费 + VIP / SVIP 会员 的资源站
希望沿用 Hope CMS 文章体系管理商品，而不是另搭商城系统

不适合

实物电商（物流、库存 SKU、多规格购物车）
需要完全脱离主题的独立商城核心（商业能力目前主要在本主题内）

核心能力

资源售卖与鉴权

访问权限：登录可见 / 评论可见 / 付费可见 / VIP 专属 / SVIP 专属
多源下载：网盘与直链，可带提取码、解压码；前台签发短时签名地址，避免明文链被转发
发货方式：下载链接或 卡密 / 激活码 自动发货
合集打包：买一篇自动开通多篇文章下载权
会员体系：VIP / SVIP 开通、续费、折扣、免费特权与到期提醒
隐藏内容：正文 [Shophide]…[/Shophide] 与侧栏下载共用同一套权限
限时特价 / 优惠券：特价可与会员折扣叠加；券支持百分比 / 立减、范围与次数限制
演示与说明：演示地址、资源参数表、版本号与更新说明、详情轮播图、亲测可用标记

支付与订单

支付宝 / 微信 / QQ / 余额支付（个人中心充值后即时扣款）
免登录短时购买；登录后自动或手动绑定游客订单
退款后自动撤销资源权 / VIP，余额单退回账户
个人中心：资源订单、会员订单、卡密、已购资源

前台体验

首页筛选、分类导购、置顶推荐、列表样式
文章侧栏购买 / 下载区（移动端自动下沉到正文末）
夜间模式、公告弹窗、QQ / 微信客服入口
下载频率限制（按 UID / IP）

后台与扩展

CSF 主题设置：配色、首页、支付、优惠风控、广告、分润等
Shop 运营后台：简报、下载分析、卡密管理、作者提现、发票
自动注册文章预设字段；作者分成与提现
邀请奖励可赠送 VIP 天数（可与系统余额奖励叠加）
对接 Hope CMS 支付订单（shop_log 等业务类型）

技术说明

项目	说明
适用系统	Hope CMS 1.0.0+
版本	1.0.2
类型	主题（theme）
别名	`Shop`
依赖	建议启用站点支付能力；会员与商业表由主题自动创建

亮点一览

商品即文章：写文章 = 上架资源，学习成本低
变现路径齐：单篇付费、会员包场、卡密、合集、优惠券都能覆盖
链路更安全：签名下载 + 频率限制，降低白嫖与刷量
运营可闭环：订单、退款、卡密库存、分润提现集中在主题与运营后台
与系统打通：用户中心、支付、侧边栏、伪静态均可沿用 Hope CMS 能力

Shop 主题使用说明

面向源码 / 素材 / 网盘资源站的付费下载主题（Hope CMS · 希望CMS）。支持单篇付费、VIP/SVIP、余额支付、优惠券、卡密发货、合集打包与运营后台。

支付网关密钥在系统「支付设置」中配置；本主题负责前台售卖规则与运营能力。
须同时启用插件「会员交易中心」（hp_core）。商业库不再内嵌于主题。

1. 安装与启用

将主题目录放入 content/theme/Shop
确保存在插件目录 content/plugin/hp_core，并在后台 → 插件中启用 会员交易中心
后台 → 外观 / 主题 → 启用 Shop（会自动创建/同步会员表与文章预设字段）
后台 → 设置 → 更新缓存（建议执行一次）
打开 Shop 设置 → 支付展示，确认已勾选需要的支付方式（含「余额支付」），保存一次以同步新选项

若文章侧栏看不到 Shop 字段：打开任意文章编辑页，或刷新前台任意页面触发主题自动安装；也可在「管理预设字段」中确认已存在 Shop_* 字段。

2. 基础配置（Shop 设置）

路径：后台 → Shop 设置（主题选项）

建议先配

分区	先做这些
基本配置	LOGO、Favicon、主题色、公告
支付展示	勾选支付宝 / 微信 / QQ / 余额支付；设置免登录购买天数
VIP 价格	VIP/SVIP 价格与有效天数、会员折扣、到期提醒天数
优惠与风控	优惠券列表、下载频率限制、邀请送 VIP 天数
作者分润	全局分成比例、最低提现（可选）
文章配置	QQ/微信客服、版权声明
首页配置	头部背景、搜索文案、置顶文章/分类

支付说明

支付宝 / 微信等 网关密钥 在系统「支付设置」中配置；主题只控制前台展示哪些入口
余额支付：用户先在个人中心充值，购买时即时扣款完成订单
会员折扣：付费可见文章开启「会员折扣」后，按 VIP/SVIP 折扣计算（先特价再打折）
免登录购买：设置有效天数后，游客可短时购买；登录后可在个人中心绑定订单号

优惠券格式

主题设置 → 优惠与风控 → 优惠券列表，每行一张：

CODE|类型|面值|范围|次数|过期日

字段	说明
类型	`percent` 百分比 / `fixed` 立减元
范围	`all` / `vip` / `post`
次数	`0` = 不限
过期日	如 `2026-12-31`，可留空

示例：VIP10|percent|10|vip|100|2026-12-31

下载风控

下载频率限制：如 8|60 表示 60 秒内最多 8 次（按 UID / IP）
鉴权通过后返回 约 5 分钟签名地址（?user=dl&token=…），不再直接暴露真实网盘/附件链
本地附件（含 resource_alias）走系统下载；外链短时 302

3. 发布一篇可售资源

后台 → 写文章，填写标题、封面、正文
右侧 预设字段 中按需配置：

正文隐藏段落

与侧栏权限一致：

公开介绍内容……

[Shophide]
这里是付费/登录后才可见的正文
[/Shophide]

发布后前台文章页右侧（或移动端正文下方）出现购买 / 下载 / 卡密区。

4. 权限对照

访问权限	下载与隐藏内容条件
（留空）	公开，有下载地址即可下
登录可见	登录用户
评论可见	评论过本文（或已留下评论 Cookie）
付费可见	已购买，或命中会员免费特权；合集子资源以开通记录为准
VIP专属	有效 VIP / SVIP
SVIP专属	有效 SVIP

5. 会员中心与订单

用户中心：站点 /user
- 资料、头像、充值余额
- 资源订单（含待支付）、会员订单
- 我的卡密、已购资源
- 游客订单绑定 / 查询
- VIP 开通与续费；临近到期时前台顶栏 / 导航会提醒
- 邀请奖励（系统余额奖励 + 主题「邀请送 VIP 天数」可叠加）
- 作者收益与提现申请（开启分润时）
主题自带页面模板（新建「页面」时选用）：VIP、标签墙、归档、友链、文章列表等（见 page/）

登录后会自动合并 Cookie 中的游客订单；也可在个人中心手动输入订单号绑定。

6. Shop 运营后台

后台侧栏 → Shop 运营（admin.php?shop_ops=1）

页签	用途
简报	销量、收入、优惠券核销、卡密库存等概览
下载分析	下载行为统计
卡密管理	按文章批量导入 / 查看库存与已售
作者提现	审核提现申请
发票	发票相关处理

7. 侧边栏

后台 → 菜单管理 → 侧边栏
向「默认侧边栏」添加组件（热门文章、最新文章、标签、博主信息等）
未配置时主题会自动兜底显示热门 / 最新 / 标签

文章页的 购买下载模块 由主题自动输出，无需再加侧栏组件。

8. 退款说明

后台对支付订单退款后，主题会自动：

撤销该资源访问权（shop_log），销量 -1
回滚 VIP 时长（会员单）
余额支付订单退回账户余额

第三方渠道退款走系统支付 SDK；退款后用户无法再下载。

9. 常见问题

Q：侧栏没有购买按钮？
A：请确认已填写「下载资源」，或发货方式为「卡密发货」且有库存逻辑；空下载地址不会显示购买区。

Q：付了费仍提示购买？
A：确认登录同一账号；检查订单是否支付成功；权限是否为「付费可见」；游客单是否已绑定。

Q：VIP 打了折但价格不变？
A：文章需开启「会员折扣」，且主题设置中 VIP/SVIP 折扣大于 0；用户需处于有效会员期内。特价与折扣为：先特价再打折。

Q：余额支付选项看不到？
A：到主题「支付展示」勾选「余额支付」并保存；用户需先充值。

Q：下载链接被转发白嫖？
A：正常情况下点击下载拿到的是短时签名链；请勿在文章正文直接粘贴真实网盘地址给未购用户。

Q：卡密发货后用户看不到码？
A：在个人中心「我的卡密」查看；库存为 0 时可能无法自动发卡，需在 Shop 运营补货。

Q：头像不显示？
A：在个人中心上传头像，或开启 Gravatar；默认回退主题 assets/img/avatar.png。

Q：切换主题后字段还在吗？
A：文章自定义字段数据仍保存在文章中；Shop 预设定义会在启用本主题时自动同步展示文案。商业表与运营后台依赖本主题。

10. 目录速查

详见 directory.md。符合 Hope CMS 主题规范：head/foot/archive/single、account/、pages/、widgets/、partials/、assets/{css,js,img}。

商业表 / 入账回调：见插件 content/plugin/hp_core/。

11. 支持

官网：https://www.hopecms.cn/
请从官方渠道获取主题与更新，避免使用不明来源安装包

Shop主题

应用介绍