广告位运维
广告投放与自助购买：预置广告位、积分/金币/在线支付，支持图片与文字样式。
¥19.90
一次购买，永久使用
详情介绍
一、插件简介
广告位（ads）在社区 左侧栏、右侧栏 按板块智能插入广告（默认第 1、3 个板块下方），并支持 自助购买预置广告位：站长配置套餐后，用户可购买大图/小图位、上传素材、经审核后展示。
- 前台入口：无独立页面；广告嵌入广场列表侧栏与帖子详情区域
- 后台入口：插件列表 → 广告位（含自助广告位管理入口）
二、核心能力
| 能力 | 说明 |
|---|---|
| 投放位置 | ad_left 左侧栏、ad_right 右侧栏（可多选逗号存储） |
| 插入规则 | 默认在第 1、3 个板块下方轮换展示；板块不足时落到最后一块下方 |
| 广告样式 | 图片广告（大图/小图）、文字广告；支持自定义 HTML content |
| 后台直投 | 管理员添加广告，默认已审核、永久或自定义到期 |
| 自助广告位 | ads_package 预置位：大图/小图容量、阶梯时长与价格 |
| 支付方式 | 积分（coins）、金币（gold）、在线支付（alipay/wechat/qqpay） |
| 审核 | 用户购买素材默认待审；后台可审核通过/拒绝 |
| 到期 | expire_time 到期后自动不展示 |
三、依赖与安装
建议环境：
- 已安装 社区（community） 插件（侧栏插槽、上传、登录）
- 在线支付需 支付（payment） 插件
- 积分/金币扣款依赖社区
Coin服务
安装步骤：
- 应用中心安装并启用「广告位」
- 打开「启用广告输出」
- 后台添加直投广告或配置自助广告位套餐
- 前台打开广场首页，确认侧栏出现广告位
数据表：
ads_item：广告条目（含购买用户、套餐、到期、审核状态）ads_package：自助广告位套餐ads_order：购买订单
四、应用中心基础配置
路径：应用中心 → 广告位 → 配置
| 配置项 | 说明 | 建议 |
|---|---|---|
| 启用广告输出 | 关闭后前台所有广告位不渲染（后台仍可编辑） | 上线开启 |
五、后台重点配置
5.1 广告管理（插件列表 → 广告位）
- 新增/编辑：投放位置（左/右多选）、标题、图片、链接、样式、尺寸、排序、状态
- 审核：
review通过/拒绝用户购买的待审广告 - 状态：显示/隐藏
5.2 自助广告位（同页或 ads_package 路由）
| 字段 | 说明 |
|---|---|
| 名称/说明 | 前台套餐标题与「说明」弹窗 |
| 投放位置 | 左栏或右栏（可多选） |
| 大图位数量 / 小图位数量 | 同时展示的容量 |
阶梯时长 tiers | JSON：[{days, price_coins, price_gold, price_cash}] |
| 排序 / 上架 | 控制前台是否出现「购买广告位」空位卡片 |
兼容旧版单价格字段：无 tiers 时自动从 price_coins/gold/cash 与 duration_days 迁移。
六、前台用户流程
- 用户在广场 左侧栏或右侧栏 看到已投放广告或「购买广告位」空位按钮
- 点击 购买广告位 → 选择套餐、尺寸（大/小）、时长阶梯
- 填写图片/文字、跳转链接，选择支付方式
- 积分/金币：扣款成功后创建待审广告（或按规则直接展示）
- 在线支付：跳转支付 → 回调确认（
/ads/confirm）后生效 - 待审期间占用容量；审核通过后正式展示至到期日
七、后台审核与运维
| 操作 | 说明 |
|---|---|
| 广告审核 | 待审条目 → 通过/拒绝 |
| 上下架 | 随时隐藏违规广告 |
| 套餐上下架 | 控制是否开放新购买 |
| 到期 | 到期记录自动不渲染；可手动提前下架 |
八、特殊说明
8.1 前台接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /ads/package | 套餐详情（购买弹窗） |
| POST | /ads/buy | 创建购买订单 |
| GET/POST | /ads/confirm | 支付确认 |
| POST | /ads/simulate | 模拟支付（调试） |
静态资源：/static/ads/ads.css、ads.js；配置注入 window.__ADS_CFG。
8.2 钩子
renderSlot('ad_left'/'ad_right')：按板块计数插入（boot/afterSection）renderAssets()：前台加载购买脚本（需登录时引导登录）
8.3 详情栏
代码保留 ad_detail 区域映射，当前主要投放为 左栏/右栏；历史 slot 名会自动迁移为 ad_left/ad_right。
九、推荐上线清单
- 启用广告输出
- 配置至少一个自助套餐（容量、价格、时长）
- 支付/金币体系测试一笔购买
- 准备默认直投广告作为填充
- 审核流程与素材规范告知用户
- 检查侧栏第 1、3 板块下展示是否正常
十、常见问题
Q：买了广告看不到？ 检查审核状态、expire_time、套餐容量与「启用广告输出」。
Q：空位不显示「购买」？ 套餐需上架且该尺寸仍有 vacantCount；容量被待审+已通过占满时不显示空位。
Q：支付成功未展示？ 查 ads_order 状态与 /ads/confirm 回调；在线支付依赖 payment 插件。
Q：图片上传失败？ 购买弹窗使用社区上传接口（__ADS_CFG.uploadUrl），需登录且上传权限正常。
更新记录 （1）
-
v1.0.1
2026-08-24
首次发布