广告位运维管控

一、插件简介

广告位插件支持后台投放与用户自助购买。位置包括左侧栏、右侧栏、幻灯片轮播图下。创意样式支持图片、文字、背景叠加文字、图标+标题。自助购买可用积分、金币或在线支付（需支付中心）；积分/金币价格文案读取支付中心名称，未填写时默认「积分」「金币」。用户投放默认待审核，通过后展示；后台可续期。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/ads/。
2. 在应用中心安装「广告位」。
3. 安装时创建 ads_item、ads_package、ads_order 表，注册后台「广告位」菜单。
4. 硬依赖：社区插件（侧栏与信息流插槽、会员登录）。
5. 软依赖：支付中心（现金购买、积分/金币名称、沙箱模拟）；社区资产（积分/金币扣款）。未开支付中心时仍可用积分/金币（若套餐定价了对应价）及后台投放。

四、应用中心基础配置

在应用中心 → 广告位 → 配置，字段来自 configSchema：

位置、样式、价格、库存均在后台「广告位 / 自助广告位」中配置，不在应用中心弹窗。

五、后台重点配置

广告条目

/admin/ads：新增后台投放或处理用户订单转成的条目。设置位置、样式、尺寸（大图/小图）、图片/文案/链接、排序、显隐、到期时间。用户投放需审核通过才会输出。

自助广告位（套餐）

/admin/ads_package（从广告位权限进入，不单独占一级菜单）：

• 名称、投放位置、创意样式、购买说明
• 大图位数量、小图位数量、每行显示数量
• 阶梯时长 JSON：天数 + 积分价 + 金币价 + 现金价（0 表示该支付方式不可用）
• 上架后，对应位置空位出现购买按钮

审核与续期

待审条目审核通过或拒绝。对已购广告可续期（延长 expire_time）。

六、前台用户流程

1. 购买：在空位点击购买 → 选择时长档与支付方式（积分/金币/在线支付，以套餐定价为准）→ 上传或填写创意与跳转链接 → 提交。
2. 余额支付：即时扣款生成待审广告；通过后展示至到期。
3. 在线支付：创建支付订单，回调或确认页完成后进入待审；沙箱可模拟支付。
4. 展示：仅审核通过、未隐藏、未过期的条目按排序渲染。

七、后台审核与运维

前台路由

八、特殊说明

• 插槽：社区布局按 ad_left / ad_right / ad_feed_below_slider 输出；历史别名（如 plaza_left_mid）会迁移到新 slot。
• 静态资源：/static/ads/ads.js 等，购买弹窗与深色样式由社区引入。
• 数据表：ads_item.review_status 0 待审 / 1 通过 / 2 拒绝；ads_order.status 0 待支付 / 1 已完成 / 2 已取消；pay_type 为 coins / gold / alipay / wechat / qqpay 等。
• 菜单：不再单独挂「自助广告位」一级菜单，避免重复；权限仍挂在「广告位」下。
• 名称约定：套餐价格单位随支付中心积分/金币名称变化。

九、推荐上线清单

• 开启「启用广告输出」
• 至少配置一个上架套餐：位置、大/小图数量、至少一种有效价格档
• 抽检空位购买按钮与弹窗（含深色模式）
• 积分/金币购买核对扣款流水；现金购买需支付中心通道可用
• 走通待审 → 通过 → 前台展示 → 到期下架
• 到支付中心确认币种展示名称
• 明确审核人员，避免用户付款后长期待审

十、常见问题

Q：前台完全看不到广告？ 检查「启用广告输出」、条目是否审核通过、未隐藏、未过期，以及套餐/条目位置是否对应侧栏或轮播下方。

Q：没有购买按钮？ 对应套餐需上架，且大图或小图仍有空位。

Q：只有积分价没有现金？ 该档 price_cash 为 0 则不提供在线支付；需支付中心启用通道。

Q：买了为什么不展示？ 用户投放默认待审，需在广告列表审核通过。

Q：价格单位名称不对？ 到支付中心修改积分名称、金币名称后刷新。

Q：找不到自助广告位菜单？ 已并入「广告位」权限，地址为 /admin/ads_package。

Q：关闭输出后后台套餐还在吗？ 在。仅前台不渲染，数据与编辑不受影响。