Z-Blog应用中心 > PHP插件 > 黄金广告位矩阵

黄金广告位矩阵

  • ID: premium_ad_grid
  • 版本: 1.1.5
  • 系统要求: 以上
  • 更新日期: 2026-06-24 14:09:51
  • PHP版本: 5.2或更高
  • 大小: 187KB

请登录

黄金广告位矩阵 - 配置说明与使用手册

黄金广告位矩阵

Yojack 出品的 Z-BlogPHP 高颜值商业广告位矩阵挂件。支持图片与文字双重类型自适应广告矩阵排布，支持广告位独立高度（继承全局、自适应、经典比例、自定义）与文字广告色彩自定义，并具备防缓存影响的 Ajax 展示量上报及点击重定向统计系统。

推荐工作流程（5 步上手使用）

  1. 基础启用：进入博客后台的「插件管理」，启用「黄金广告位矩阵」插件。

  2. 排版与样式：在后台选择所需的广告网格布局（支持单列、双列、四格及混合布局），微调卡片圆角，设置全局卡片默认高度。

  3. 广告条目编辑：在「广告内容配置」平铺卡片列表中编辑条目。支持图片广告和文字广告。配置图片链接、文字内容、目标跳转网址、广告位独立高度及投放期限。支持后台 Ctrl + S 快速保存。

  4. 挂件展示上线：前往「模块管理」，将「黄金广告位」挂件拖拽入左侧对应的侧边栏分组中并保存。

  5. 监控投放效果：通过「数据统计报表」实时查看各广告位的展示量、点击量及精准计算的点击率 (CTR)。

image.pngimage.pngimage.png

配置项详细说明与生效权重

SECTION 1                    全局配置项说明

  • 广告网格布局 (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）。

SECTION 2                    单广告卡片 (Ad Card) 配置项说明

  • 广告备注名称 (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）。

SECTION 3                    外观配色配置说明

  • 色彩材质模式 (BgType)：可选“自动适配当前博客主题”（theme，推荐，融入主题外壳，背景透明）或“手动自定义色彩”（custom）。

  • 一键应用配色方案：提供 5 组配色预设（自适应主题、夜空暗色、薄荷淡绿、暖阳淡橙、魅幻暗紫），可一键填充下方配色细节。

  • 主调高亮色 (AccentColor)：手动自定义模式下生效，控制招租虚线呼吸框、加号图标、悬停高亮等强调色的色值。

  • 卡片背景色 (BgColor)：手动自定义模式下外壳卡片的整体背景色。

  • 主文字颜色 (TextColor)：手动自定义模式下外壳卡片的主文字颜色。

SECTION 4                    配置生效权重与判定规则

  1. 尺寸高度权重（局部优先）：                            
    • 规则：广告独立卡片高度 > 全局默认高度。                            
    • 细节：仅当卡片高度设为“继承全局默认 (inherit)”时，全局 CardHeight 才会生效。若在卡片内设定了其他高度或自定义像素值，则覆盖全局默认高度。                            
    • 兜底保护：文字广告和招租占位卡在自适应（auto）高度下，限制最低高度限制（min-height: 54px;）以保证排版平整，不发生内容塌陷。

  2. 时效期判定权重（永久优先）：                            
    • 规则：“永久投放”开关 > “下架日期”判定。                            
    • 细节：若勾选“永久投放”，系统将完全忽略该卡片的下架日期设定，广告永远在线；若关闭该开关，下架日期设定才具备检查权重，到期则下架。

  3. 空置兜底与策略权重（状态优先于策略）：                            
    • 规则：广告内容填写状态 / 是否过期 > 全局过期处理策略。                            
    • 细节：系统首先判定广告位内容是否未填写（图片广告无图或文字广告无文字）或已过期。一旦广告无效，系统再依据全局策略（ShowVacancy）决定是显示招租卡还是在前台隐藏。

  4. 配色渲染权重（配色模式优先）：                            
    • 规则：配色模式 (BgType) 决定自定义配色参数的生效权重。                            
    • 细节：设为「自适应主题」时，外壳直接退化为透明并继承主题样式，自定义背景色 BgColor 和文字色 TextColor 将不生效；设为「手动自定义色彩」时，自定义背景色和文字色生效覆盖主题色。无论何种模式下，全局强调色 AccentColor 和文字广告独立的背景及文字色均会以最高优先级呈现。

  5. 跳转网址同步权重（广告类型优先）：                            
    • 规则：广告类型 (ad_type) 决定跳转网址字段的实际读取。                            
    &bull; 细节：后台表单为图片广告和文字广告提供独立的网址输入项，前端通过 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+

访客您好，Z-Blog相关网站已开启实名制，请登录后绑定您的手机，再发表评论，谢谢您的支持。


ZBLOG应用中心-软件购买及使用协议


1. 您在购买应用软件前，须要先确认该应用软件是否符合您的使用需求。依据《消费者权益保护法》第二十五条规定，该软件为在线下载的数字化商品，在购买后一经下载安装不能退款。

2. 您在应用中心购买的软件，仅是该软件的许可使用权。除软件外应用中心不提供任何形式的有偿提供信息或网页制作、服务器空间租用等服务。

3. 一个软件仅可用于单一账号使用，未经本站同意，不得二次发布、赠送、转售、租让、盗版等，否则我们将永久关闭用户账号并保留继续追究相关责任的权利。

4. 本应用为通用型产品，除解决BUG外不提供个人定制和其它修改服务。

5. 您使用软件中所存在的风险，完全由用户自己承担，包括系统受损、资料丢失以及其它任何风险。

6. 用户不得利用该软件以任何方式从事违反法律法规及社会公序良俗的行为，用户须对其不当使用行为可能带来的后果负全部法律责任，本站不承担任何责任。

7. 如发现用户将软件用于黄赌毒诈等非法用途，将停止用户相关的使用权，并将用户相关违法信息上报至网络监管部门。


购买指南


1. 请先注册账号，然后登录“应用中心”。
2. 直接点击“购买应用”，跟随指引即可。


下载指南


1. 购买者在自己的Z-Blog网站登录，进入后台，在左侧菜单栏点击“应用中心”菜单。
2. 在“应用中心”的首页，使用应用中心注册账号进行登录。
3. 进入“我的应用仓库”，即可看到已购买成功的应用，点击“下载”即可下载安装。


其它注意事项


1. 如果通过自己网站后台无法正常访问应用中心，请谨慎购买，因为这将可能导致应用无法顺利下载安装。
2. 如已购买收费应用无法正常下载，请在自己网站后台检查Z-Blog及应用更新，如均已更新至最新版本仍无法下载请及时与我们联系。
3. 应用更新时有可能覆盖本地设置，请在更新前做好备份。