xnx_ad_selfbuy 广告位自助购买

功能

• 用户使用积分自助购买首页/版块/主题页右侧栏广告位（图片 + 文字两种类型）

• 按 天 / 周 / 月 / 年 四种周期计费，支持自定义时长与最大购买天数上限

• 可选审核模式：开启后新购/编辑订单进入 pending，后台审核通过才上线；拒绝时自动退还积分并下发通知

• 续费与编辑：未过期订单续费顺延 expire_time；编辑广告内容（标题/链接/图片/文字）会重审

• 到期自动下架：每次访问广告区触发 checkExpire，将过期 active 订单置为 expired；即将到期订单按 remind_days 提前每日推送一次提醒通知

• 后台管理：广告位 CRUD、订单审核/下架/删除、价格与展示页配置、初始化默认广告位

• 多页面注入：首页 index_site_brief_after、版块列表 forum_threadlist_after、版块管理 forum_mod_after、主题页 thread_user_after、用户中心 user_nav_end

• 完整缓存：广告位列表 600 秒、活跃订单映射 300 秒，写操作统一通过 CacheHelper::pluginDeletePrefix 清理

文件结构

plugin/xnx_ad_selfbuy/
├── conf.json
├── install.php / uninstall.php
├── setting.php  (转发到 admin/route/ad_selfbuy.php)
├── admin/
│   ├── route/ad_selfbuy.php  (后台路由：slot/rules/pages/list/audit)
│   └── view/htm/ad_selfbuy.htm
├── route/ad.php              (前台路由：list/buy/my/edit/renew/upload)
├── model/AdSelfbuyService.php
├── hook/
│   ├── model_inc_file.php
│   ├── model_route_table_end.php
│   ├── index_route_case_end.php
│   ├── index_site_brief_after.htm
│   ├── forum_threadlist_after.htm
│   ├── forum_mod_after.htm
│   ├── thread_user_after.htm
│   ├── user_nav_end.htm
│   ├── lang_zh_cn_bbs.php
│   ├── lang_zh_tw_bbs.php
│   └── lang_en_us_bbs.php
├── view/htm/
│   ├── ad_list.htm
│   ├── ad_buy.htm
│   ├── ad_edit.htm
│   └── ad_my.htm
└── static/js/ad.js

配置流程

1. 后台启用插件（自动建表 xnx_ad_selfbuy_slot / xnx_ad_selfbuy_order 并插入 9 个默认广告位）

2. 进入「插件设置」→「规则」配置积分类型、4 种周期单价、最大时长、是否开启审核、提醒天数

3. 切换到「页面」勾选展示广告位的页面（index/forum/thread）

4. 切换到「广告位」按需新增/编辑/删除广告位（有活跃订单时拒绝删除）

5. 测试：用户在前台 ?adselfbuy-list 选择广告位购买 → 后台「审核」标签审核 → 广告位出现在勾选页面侧栏