付费下载
月度会员￥2
终身会员免费卡尼奶主题本身不带广告位——侧栏、内容区、文章页正文上下都没有预留。素材、排期、定向、统计也分散在不同地方。这个插件给卡尼奶主题补上一整套广告管理能力：从建素材到看数据串成一条线。
插件名：小熊猫广告管理（XXM Ad Manager）
版本：1.0.0（本站已发布）
适用：卡尼奶（KNN）主题
维护：有主题源码阁（小熊猫维护）
开源：购买后获得完整开源文件，无任何加密
一、小熊猫广告管理
卡尼奶主题没有内置广告位，站长想要广告位只能改主题模板。插件把广告位、素材、排期、定向、统计统一管起来，解决四类问题：
- 同一张横幅要在文章页、商品页、侧栏反复配置；
- 活动结束后忘记下线，过期素材一直挂着；
- 想知道某个位置到底有没有人点，却只有服务器日志；
- 换个主题或改个模板，广告代码就散落各处。
插件把广告统一存成「广告库」：样式（几列几行、颜色、图片高度）全部在广告里设置，投放只做一件事——在「外观 → 小工具」里选广告 ID、或在「广告位置」页勾选位置、或在文章正文里写短代码，放到哪个位置就在哪显示。
二、三种投放通道
1. 小工具（推荐用于侧栏 / 内容区）
- 在外观 → 小工具里，把「小熊猫广告」拖到任意侧栏 / 内容区；
- 每一行下拉选一条广告（显示为「#ID · 名称 · 类型」），点「+ 新增广告」可加行
- 保存后前台立即显示。同一位置想叠几条横幅，就在这一个小工具里选几条广告，不必再拖第二个。
2. 广告位置（推荐用于文章详情页 / 论坛帖子页正文上下）
卡尼奶主题的文章详情页顶部没有小工具区，论坛帖子页也没有正文内的广告位。插件在后台新增「广告位置」页，直接调用主题提供的正文钩子把广告插到正文上下，不用装小工具：
- 文章详情页：正文上方 / 正文下方，每个位置最多叠 4 条广告；
- 论坛帖子页：帖子正文上方 / 帖子正文下方，走正文过滤器插入。
图片宽度撑满正文、高度随图片比例，与首页拖进小工具的观感一致；要压高度就用广告自身的「图片高度」字段。
3. 短代码
任意页面、文章或小工具文本里写：
[xxm_ad id="1"]
[xxm_ad id="2" title="今日推荐"]
文章正文前后这类没有小工具区、又不想开「广告位置」页的位置，用短代码最直接。
4.部分效果截图
三、广告自带栅格
不再有「位置级积木」。一条文字广告自己决定长相：
- 样式：内置三款，列宽始终等分。
- 色块：每格铺满、文字居中，默认蓝底白字（
#2563eb/#ffffff）。 - 描边：透明底、细边空心，默认蓝字（
#2563eb），边框跟随字色。 - 简约：保持原来的圆点链接列表，不铺色。
- 色块：每格铺满、文字居中，默认蓝底白字（
#2563eb/#ffffff）。 - 描边：透明底、细边空心，默认蓝字（
#2563eb），边框跟随字色。 - 简约：保持原来的圆点链接列表，不铺色。
- PC 列数：2 / 3 / 4 列，手机端自动降为 2 列 / 1 列。
- 行数：0 = 不限；超出「列数 × 行数」的链接不显示。
- 虚位以待：打开后，链接不够时补空格子，把栅格填整齐。一条有效链接都没有时也会整块铺出占位格（设了行数铺满列 × 行，没设铺满一行），可以直接拿来招租；这种纯占位没有可点地址，不计曝光。
- 配色：底色 / 字色留空就用当前样式的默认色，填了就用你填的；只填底色时按亮度自动配白字或深字。广告级颜色是每一格的默认值，单条链接还能各自覆盖。简约样式忽略广告级颜色。
- 图片高度：四档预设一键选——自适应（按图片比例）、横幅 90、通栏 120、矩形 250，也能手填像素值；填了固定高度按
object-fit: cover居中裁切，宽度始终撑满所在位置。横幅图（宽高约 10:1 到 16:1）选自适应最稳，固定高度留给比例和位置不符的素材。
改这条广告的列数 / 行数 / 颜色，所有引用它的位置一起变，不用逐个位置重排。
四、五种素材
| 类型 | 说明 |
|---|---|
| 图片 | 媒体库附件（自动 srcset）或外链图；宽度撑满容器，可设固定高度（cover 裁切）或按图片比例 |
| 文字 | 一屏多条链接，支持普通 / 加粗 / 热色；可选色块 / 描边 / 简约三款样式，可设列数、行数、虚位以待与默认底色 / 字色（留空用样式默认色）；每条链接还能单独覆盖配色，拖动排序，逐条点击统计 |
| 短代码 | 只接受方括号形式，尖括号标签会被拒绝 |
| 受控 HTML | 白名单标签与属性；script、iframe、form、on* 事件、javascript: 会被剥离 |
| 高级代码 | 原样输出 HTML / JS，默认关闭，开启需二次确认并记录操作人 |
编辑弹窗在画面居中、宽约 1040px，带实时预览，可切换桌面 / 手机 375px / 深色三种状态。预览是近似效果，最终以实际前台为准。
五、投放控制
- 排期：开始日期留空立即生效，结束日期到了自动停投。
- 页面类型：首页 / 文章详情 / 归档 / 搜索 / 商城 / 论坛 / 其他，可多选；一条都不选 = 全站。首页和详情是互斥判定，只在详情页的广告不会漏到首页。
- 同页只出一次：单条广告勾选后，同一页面无论出现在几个小工具里都只输出第一次。
- 设备：全部 / 仅电脑 / 仅手机，按请求实时判定，不会被页面缓存固化。
- 角色：勾选后只对对应登录角色可见，游客不可见。
- 分类 / 标签：支持「包含」和「排除」，排除优先。
- VIP 免看：付费会员看不到该条广告。
- 单页关闭：在文章 / 页面编辑页侧栏勾选「本页不显示广告」。
- 预算上限：展示或点击达到设定值后自动停投，0 = 不限。
同一广告在同一侧栏只输出一次；不同侧栏可以各放一次。
六、统计怎么算
- 曝光：广告 50% 进入视口并持续 800ms 记一次。
- 点击：点击链接时上报，同一链接每个会话最多 3 次。
- 去重：同一广告同一渠道每天只报一次曝光（浏览器本地记录）。
- 服务端：签名令牌 + 单 IP 限流；可选服务端二次去重。
- 聚合表：
{前缀}xxm_ad_stats，按「广告 × 渠道 × 链接 × 日期」，不存访客明细。渠道只有两种：小工具、短代码。 - 报表：今日展示 / 点击 / 点击率，7 天与 30 天趋势，文字广告可展开看每条链接的点击，支持 CSV 导出。
统计数据是近似值：广告拦截器、隐私模式、页面缓存、网络中断都会造成丢失，不适合财务结算。被页面缓存超过 2 小时的页面可能无法上报。
七、后台怎么操作
后台只做三件事：管广告、选位置、看数据。侧栏位置交给 WordPress 自己的小工具系统，文章详情页 / 论坛帖子页的正文上下交给「广告位置」页。
- 一张大卡片装下整个后台：白色顶栏、浅灰左侧导航、浅灰内容画布连成一张圆角大卡片，参考卡尼奶主题设置页的观感；主色沿用 WordPress 蓝，导航选中项是实心蓝胶囊。
- 左侧导航五项：「全站设置」「广告位置」「广告管理」「广告统计」「系统工具」，打开后台默认停在「全站设置」；宽屏下导航底色随内容等高铺满整列，960px 以下自动收成一行横向滚动的按钮条，内容占满整行，手机上也能正常操作。
- 广告管理一条广告一张卡：头部是缩略图（图片广告）或
#ID徽章、广告名、类型、链接数 / 列数行数 / 图片高度和到期时间；文字广告的每条链接单独一行，名称、链接、到期时间按列对齐（宽屏生效，窄屏自动换行），链接列自动占满剩余宽度；编辑和删除固定在右上角。 - 双击就能改：广告名、每条链接的名称与地址、到期日都直接双击行内文字修改，回车写回列表、Esc 取消，不用打开编辑弹窗；改完点右下角「保存设置」落库。
- 空位直接填：文字广告开了「虚位以待」后，广告管理卡片会把空位一起列出来，虚线格就是空位；空位数按「列 × 行 − 已有条目」算，所以你设 3 列 2 行就只有 6 行——填一格少一格，不会越填越长。单击空位里的名称或链接就能填，名字和地址可以分两次填。只填一半的链接会先标成「待补全」，保存后也不会丢，下次回来接着补。
- 三页弹窗：广告编辑在居中的大弹窗里完成，分「基本信息 / 投放设置 / 高级」。基本信息放素材类型与素材本身，广告名称自动生成；投放设置管页面类型、设备、排期、上限和分类 / 标签；高级管打开方式、UTM 和角标。宽屏下链接的文字、地址和颜色输入框随弹窗铺开；手机和窄屏下面板接近全屏，说明与控件上下排列，输入框占满整行。
- 图片广告：选媒体库图片或填外链地址，设落地页与图片高度（自适应 / 横幅 90 / 通栏 120 / 矩形 250 四档预设或手填 px）；alt、说明、按钮和原始尺寸收在「更多选项」里。
- 文字广告：直接编辑链接内容，先选色块 / 描边 / 简约样式，再设 PC 列数、行数、虚位以待与默认底色 / 字色；颜色留空就用样式默认色，每一条链接仍可单独设色和开关。
- 没链接也能招租：一条有效链接都没有、但开了「虚位以待」的文字广告，前台照样整块铺出「虚位以待」占位格（设了行数就铺满列 × 行，没设铺满一行），位子直接亮出来招租。这种纯占位没有可点地址，也不计曝光，不会把统计刷成假数据；没开「虚位以待」的广告仍然一条不出。
- 状态概览六张卡：放在「广告统计」页顶部，直接显示广告素材数、文字广告数、图片广告数、插件投放、主题总闸、统计状态，异常项标红；一行排满六张，退档时按 3 列、2 列分，不会出现落单的孤行。全站设置页只留开关本身。
- 广告位置页：文章详情页与论坛帖子页的正文上下各一个位置，每个位置最多叠 4 条广告；选中的广告按行序从上到下叠放，清空即关闭该位置。图片宽度撑满正文、高度随图片比例，与首页拖进小工具的观感一致。这里的位置不需要装小工具、也不改主题文件；广告编辑器的「页面类型」是过滤不是位置，只决定这条广告允不允许出现在某类页面。
改一次广告素材，所有引用它的小工具和短代码同步更新。
常见问题
Q：前台为什么没有广告？ 按顺序检查：主题设置里的广告总闸 → 插件「全站设置」投放开关 → 外观 → 小工具里是否放了「小熊猫广告」并选中广告，或后台「广告位置」页是否选好了广告 → 排期 / 页面类型 / 设备 / 定向是否命中 → 素材是否可用。图片广告必须有附件或外链图；文字广告一条有效链接都没有时，只有开了「虚位以待」才会铺出占位格。「系统工具」的运行环境自检会逐项标出哪一步没通过。
Q：改完列数 / 底色，前台为什么还是旧的？ 弹窗底部「保存广告」会直接写库并清缓存，保存后刷新前台就是新样式。在广告管理列表里双击改的名称 / 链接 / 到期日只写回列表，需要再点右下角「保存设置」。
Q：怎么让一条广告只在首页、另一条只在详情页？ 在广告编辑器的「投放设置」页勾选「页面类型」：只勾首页就只在首页出现，只勾文章详情就只在详情页出现；一条都不勾是全站。互斥判定保证两者不会串页。
Q：怎么把广告放到文章正文前后？
正文前后没有小工具区，有三种办法：后台「广告位置」页选广告插到正文上下（推荐，不用装小工具、不改主题）；或在文章里写 ；或改主题模板调用短代码固定到全站每篇文章。
Q：和主题自带广告会冲突吗？ 插件不写主题配置，也不改主题文件。同一屏里如果主题面板和插件小工具都开了广告，会各显示各的，属于配置层面的叠加。
Q：换主题后广告会消失吗？ 会。前台只在检测到卡尼奶主题函数时输出；后台配置与统计数据都会保留。
Q：卸载会删数据吗？ 默认不删，只清理定时任务与缓存。「系统工具」页勾选「卸载时彻底清除数据」后卸载，才会删除设置、统计表、小工具配置和签名盐。
Q：支持论坛内容吗？
后台「广告位置」页有「论坛帖子页」分组：帖子正文上方 / 帖子正文下方，走正文过滤器插入。也可以用短代码 放进帖子内容，或把「小熊猫广告」小工具放到论坛侧栏。
Q：为什么点击比服务器日志少？ 每链接每会话最多上报 3 次点击，用于防连点；广告拦截器也可能拦截上报。
- 注意：本站资源多为网络收集和用户投稿，如涉及版权问题请及时与站长联系，我们会在第一时间内删除资源。
- 您购买的只是资源，不提供解答疑问和安装服务。免费源码里的接口不保证一直可以用
- 本站用户发帖仅代表本站用户个人观点，并不代表本站赞同其观点和对其真实性负责。
- 本站资源大多存储在云盘，如发现链接失效，请及时与站长联系，我们会第一时间更新。
- 转载本网站任何内容，请按照转载方式正确书写本站原文地址
- 如果发现侵权可以联系站长删除,站长vx：xiaoxiongmao0504或者邮箱通知3326096692@qq.com
