Yojack 出品的 Z-BlogPHP 高颜值商业广告位矩阵挂件。支持图片与文字双重类型自适应广告矩阵排布，支持广告位独立高度（继承全局、自适应、经典比例、自定义）与文字广告色彩自定义，并具备防缓存影响的 Ajax 展示量上报及点击重定向统计系统。
基础启用：进入博客后台的「插件管理」，启用「黄金广告位矩阵」插件。
排版与样式：在后台选择所需的广告网格布局（支持单列、双列、四格及混合布局），微调卡片圆角，设置全局卡片默认高度。
广告条目编辑：在「广告内容配置」平铺卡片列表中编辑条目。支持图片广告和文字广告。配置图片链接、文字内容、目标跳转网址、广告位独立高度及投放期限。支持后台 Ctrl + S 快速保存。
挂件展示上线：前往「模块管理」，将「黄金广告位」挂件拖拽入左侧对应的侧边栏分组中并保存。
监控投放效果：通过「数据统计报表」实时查看各广告位的展示量、点击量及精准计算的点击率 (CTR)。
广告网格布局 (Layout)：可选 1x1（单图横幅，单列平铺）、1x2（双格并排）、2x2（四格矩阵）、混合排列（hybrid，首张全宽，后续双列）。
过期或空置广告处理策略 (ShowVacancy)：可选择“展示招租占位卡片”（前端渲染虚线框和呼吸加号）或“直接下架隐藏对应空位”（对应卡片不渲染，网格自适应收缩）。
招租卡跳转链接 (VacancyUrl)：当展示招租占位卡时，访客点击将跳转到此链接，若不填默认回退为站长邮箱链接。
招租卡文案 (VacancyText)：招租占位卡上显示的提示文案，若不填默认显示“广告招租”。
图片缩放适应模式 (ImageFit)：可选：裁剪填充（cover，等比铺满，推荐）、等比缩放（contain，显示全图但可能留白）、拉伸铺满（fill，易变形）。
卡片圆角大小 (CardRadius)：全局设定前台所有广告卡片、文字底板以及招租卡片的圆角半径（支持 0px - 50px，默认 6px）。
默认卡片高度 (CardHeight)：可选自适应（auto）、16:9、3.5:1、4:3、1:1 或自定义高度（如输入 120px）。
广告备注名称 (ad_name)：用于站长在后台标识该广告，不输出到前台。
广告类型选择 (ad_type)：可独立设为“图片广告”或“文字广告”。
图片广告字段：包括图片网址（ad_image，支持媒体库上传）、悬停描述（ad_image_desc，悬停提示）和图片跳转链接（ad_image_url）。
文字广告字段：文字内容（ad_text）、背景类型（ad_text_bg_type，纯色或渐变）、主文字色（ad_text_color）、背景颜色1（ad_text_bg）、背景颜色2（ad_text_bg2，仅渐变时有效）和文字跳转链接（ad_text_url）。
投放期限配置：包括永久投放开关（ad_forever，勾选后一直在线）和下架日期（ad_expire_date，在非永久时生效，到期自动下架）。
独立卡片高度 (ad_height_type / ad_height_custom)：支持每个卡片独立控制高度。可选继承全局（inherit）、自适应（auto）、16:9、3.5:1、4:3、1:1 或自定义高度（如输入 130px）。
色彩材质模式 (BgType)：可选“自动适配当前博客主题”（theme，推荐，融入主题外壳，背景透明）或“手动自定义色彩”（custom）。
一键应用配色方案：提供 5 组配色预设（自适应主题、夜空暗色、薄荷淡绿、暖阳淡橙、魅幻暗紫），可一键填充下方配色细节。
主调高亮色 (AccentColor)：手动自定义模式下生效，控制招租虚线呼吸框、加号图标、悬停高亮等强调色的色值。
卡片背景色 (BgColor)：手动自定义模式下外壳卡片的整体背景色。
主文字颜色 (TextColor)：手动自定义模式下外壳卡片的主文字颜色。
尺寸高度权重（局部优先）：
• 规则：广告独立卡片高度 > 全局默认高度。
• 细节：仅当卡片高度设为“继承全局默认 (inherit)”时，全局 CardHeight 才会生效。若在卡片内设定了其他高度或自定义像素值，则覆盖全局默认高度。
• 兜底保护：文字广告和招租占位卡在自适应（auto）高度下，限制最低高度限制（min-height: 54px;）以保证排版平整，不发生内容塌陷。
时效期判定权重（永久优先）：
• 规则：“永久投放”开关 > “下架日期”判定。
• 细节：若勾选“永久投放”，系统将完全忽略该卡片的下架日期设定，广告永远在线；若关闭该开关，下架日期设定才具备检查权重，到期则下架。
空置兜底与策略权重（状态优先于策略）：
• 规则：广告内容填写状态 / 是否过期 > 全局过期处理策略。
• 细节：系统首先判定广告位内容是否未填写（图片广告无图或文字广告无文字）或已过期。一旦广告无效，系统再依据全局策略（ShowVacancy）决定是显示招租卡还是在前台隐藏。
配色渲染权重（配色模式优先）：
• 规则：配色模式 (BgType) 决定自定义配色参数的生效权重。
• 细节：设为「自适应主题」时，外壳直接退化为透明并继承主题样式，自定义背景色 BgColor 和文字色 TextColor 将不生效；设为「手动自定义色彩」时，自定义背景色和文字色生效覆盖主题色。无论何种模式下，全局强调色 AccentColor 和文字广告独立的背景及文字色均会以最高优先级呈现。
跳转网址同步权重（广告类型优先）：
• 规则：广告类型 (ad_type) 决定跳转网址字段的实际读取。
• 细节：后台表单为图片广告和文字广告提供独立的网址输入项，前端通过 JS 实时在两字段间双向同步。后端保存时根据 ad_type 读取对应项，合并写入数据库的单个 url 配置中。当该网址为空时，前端自动忽略 <a> 链接包裹，退化为无点击交互的纯展示卡片，避免空链接跳转。
| 参数/配置项名称 | 核心作用 | 生效权重与优先规则 |
|---|---|---|
| 网格布局 (Layout) | 控制挂件前台网格排版 | 提供 1x1、1x2、2x2 及 hybrid（混合布局）。前台会根据当前处于激活状态的广告卡片个数自动递补或铺满网格。 |
| 全局卡片高度 (CardHeight) | 设置前台全局广告位高度 | 受制于独立高度。仅在单个卡片高度类型选择“继承全局默认”时有效。 |
| 广告独立高度 (ad_height_type) | 定制单个广告位卡片高度 | 优先级高于全局高度。可覆盖全局默认高度，设为自定义 (custom) 时，使用独立自定义高度字段的值。 |
| 永久投放开关 (ad_forever) | 控制该广告位的到期逻辑 | 优先级高于到期日期。若开启则广告无限期生效，忽略下架日期的设定；若关闭则检查“下架日期”决定是否到期下架。 |
| 下架日期 (ad_expire_date) | 限时投放广告的到期日期 | 受制于永久开关。仅在“永久投放”关闭时有效。格式为 YYYY-MM-DD，次日零点判定到期。 |
| 配色模式 (BgType) | 配置视觉色彩的继承规则 | 决定自定义色彩的生效权重。设为自适应主题 (theme) 时，自定义背景色和文字色不生效。 |
| 过期处理策略 (ShowVacancy) | 广告判空或到期后的渲染行为 | 受制于内容填写状态。未投放或过期的卡片，根据此策略决定是显示“广告招租”呼吸虚线卡还是直接完全隐藏。 |
| 广告类型选择 (ad_type) | 控制单个槽位输出形态 | 决定显示字段与跳转网址合并逻辑。为图片广告或文字广告提供独立的渲染模板。 |
为应对全页面静态化缓存插件的影响，本插件的数据监控系统分为两部分：
1. 异步展示量上报 (Impression Tracking)
前台 DOM 载入后通过 JS 动态检索带有有效 data-ad-id 属性的展示卡片，合并为一个数组发起 Ajax 请求上报： GET /zb_users/plugin/premium_ad_grid/track.php?ids=1,2,3
2. 精准点击跳转路由 (Click Tracking)
前台广告卡片实际链接均指向重定向代理，点击后后端计数加 1 并更新 HTML 静态挂件缓存，随即重定向： GET /zb_users/plugin/premium_ad_grid/redirect.php?id=1
黄金广告位矩阵 v1.0.5 · by Yojack · PHP 7.0+ · Z-BlogPHP 1.7+
1. 您在购买应用前，须要先确认该应用是否符合您的使用需求，数字化商品不支持试用。依据《消费者权益保护法》第二十五条规定，该应用为在线下载的数字化商品，在购买后一经下载安装不能退款。
2. 您在应用中心购买的应用，仅是该应用的许可使用权，该应用的所有权仍归应用提供方所有。
3. 一个应用仅可用于单一账号使用，未经本站和应用提供方同意，不得二次发布、赠送、转售、租让、盗版等，否则我们将永久关闭用户账号并保留继续追究相关责任的权利。
4. 如包含该应用的网站被转售或赠送、租让等，请另用新账号购买该应用或移除该应用，否则将视为违反使用协议被永久取消该账号的使用权利。
5. 如无特殊说明，已购买应用仅包括相关使用权及免费更新服务，应用中心及应用提供方不提供额外售后安装等服务。
6. 您使用应用中所存在的风险，完全由用户自己承担，包括系统受损、资料丢失以及其它任何风险。
7. 用户不得利用该应用以任何方式从事违反法律法规及社会公序良俗的行为，用户须对其不当使用行为可能带来的后果负全部法律责任，本站及应用提供方不承担任何责任。
8. 应用提供方和本站如发现用户将应用安装于黄赌毒诈等非法网站，将停止用户相关的使用权和服务，并将用户相关违法信息上报至网络监管部门。
9. 本站及应用提供方保留在不通知您及不对您承担责任的情况下变更、限制、冻结或终止您对某些内容的使用的权利。
1. 请先注册账号，然后登录“应用中心”。
2. 直接点击“购买应用”，跟随指引即可。
1. 购买者在自己的Z-Blog网站登录，进入后台，在左侧菜单栏点击“应用中心”菜单。
2. 在“应用中心”的首页，使用应用中心注册账号进行登录。
3. 进入“我的应用仓库”，即可看到已购买成功的应用，点击“下载”即可下载安装。
1. 如果通过自己网站后台无法正常访问应用中心，请谨慎购买，因为这将可能导致应用无法顺利下载安装。
2. 如已购买收费应用无法正常下载，请在自己网站后台检查Z-Blog及应用更新，如均已更新至最新版本仍无法下载请及时与我们联系。
3. 应用更新时有可能覆盖本地设置，请在更新前做好备份。
