Z-BlogPHP广告管理插件,后台投放广告位

Z-BlogPHP广告管理插件可以让你在后台集中创建广告位,再通过模板标签把广告展示到文章页、首页或侧边栏。
本文按零基础操作顺序,讲清插件安装、广告位配置、模板调用和显示验证,最终能独立完成广告位投放。

适用场景与准备工作

这个插件适合需要手动管理多个广告位的个人站长,比如在文章顶部、底部或侧边栏轮换投放图片和代码。
开始前确认三件事:

  • Z-BlogPHP 后台能正常登录,且当前账号有插件管理权限。
  • 已经准备好广告代码或图片地址,例如一段 HTML 或一张 728x90 的横幅图。
  • 建议先备份网站数据库和主题文件,避免误改模板后无法恢复。

如果你用的是宝塔面板,可以在 网站 -> 根目录 找到 Z-BlogPHP 安装目录,后续模板文件都在 zb_users/theme/当前主题/template/ 下。

安装广告管理插件

Z-BlogPHP 安装插件有两种常见方式,优先用后台应用中心。

  1. 登录后台,进入 应用中心 -> 插件。
  2. 搜索“广告管理”或“广告位”,找到对应插件后点击 安装。
  3. 安装完成后,在 插件管理 中启用它,左侧菜单通常会出现广告相关入口。

如果应用中心无法访问,可以手动上传:从官方或可信来源下载插件压缩包,解压后把整个插件文件夹上传到 zb_users/plugin/,再回后台 插件管理 点击 启用。

启用后进入插件设置页,先看是否有全局开关和广告位数量限制。
部分插件需要先添加“广告位”,再往广告位里放具体广告。

创建广告位并投放广告

广告位是广告的容器,调用时用的是广告位标识,不是单个广告。
建议按位置命名,例如 index_top、article_bottom、sidebar_300x250,方便后续维护。

操作路径大致如下,不同插件界面文字可能略有差异:

  1. 进入 广告管理 -> 广告位管理,点击 新建广告位。
  2. 填写广告位名称和标识。标识只能用英文、数字或下划线,例如 article_footer。
  3. 选择广告类型,常见有图片广告、代码广告、文字链接。图片广告需要上传图片并填写跳转链接,代码广告直接粘贴 HTML 或 JS。
  4. 设置展示范围,例如全站、首页、文章页或某个分类。
  5. 保存后记下广告位标识,模板调用时会用到。

如果插件支持直接插入,可以在文章编辑页底部找到广告选项,勾选后发布即可。
但更稳定的做法是通过模板标签调用,下面单独说明。

在主题模板中调用广告位

Z-BlogPHP 常用模板标签调用广告位,一般形式是 {zbp_ad('广告位标识')} 或类似函数。
具体标签名以插件说明为准,不要直接照搬其他插件写法。

以文章页底部投放为例,编辑 zb_users/theme/当前主题/template/post-single.php,在合适位置加入:

{if $zbp->Config('广告插件ID')->广告开关}
    {zbp_ad('article_footer')}
{/if}

如果插件提供的是 PHP 函数,则写成:

保存后回后台 清空缓存并重新编译模板。
修改模板前一定先备份原文件,改错会导致页面空白或报错。

侧边栏广告通常改 sidebar.php,首页顶部改 index.php。
每次只改一个位置,刷新前台确认显示正常后再改下一个。

广告不显示时的排查顺序

广告位创建成功但前台看不到,按下面顺序检查,多数问题能定位到。

  • 确认插件已启用,且广告位状态是“启用”而不是“草稿”。
  • 检查广告位标识是否和模板中调用的标识完全一致,大小写敏感。
  • 清除 Z-BlogPHP 缓存和浏览器缓存,再强制刷新 Ctrl+F5。
  • 查看广告代码是否被浏览器拦截,或图片地址是否 404。
  • 如果模板报错,临时切换默认主题测试,判断是主题兼容还是插件问题。

还有一个常见坑:广告位设置了展示范围,但当前页面不在范围内,自然不显示。
把范围临时改成“全站”测试,能显示再逐步收紧。

验证与后续维护

投放完成后,用无痕窗口打开首页、文章页和分类页,分别确认广告出现在预期位置。
手机端也要检查,避免图片宽度撑破布局。

建议在插件里给每个广告位加备注,例如“文章底部-2025-06 上线”,方便日后替换。
广告代码不要直接粘贴来源不明的脚本,避免拖慢页面或被浏览器拦截。

如果广告位需要按分类展示不同内容,优先用插件自带的条件设置,少改模板代码,降低升级主题时被覆盖的风险。

常见疑问

广告位标识可以随便改吗?
标识一旦被模板调用,改动后必须同步修改模板,否则广告不显示。建议创建时就规划好命名。

图片广告和代码广告能放同一个广告位吗?
多数插件支持一个广告位下添加多条广告并轮换,具体以插件界面为准。如果不支持,就建两个广告位分别调用。

主题升级后广告不见了怎么办?
主题升级可能覆盖模板文件,升级前备份修改过的模板,升级后重新加入调用代码并清缓存。

插件停用后广告位数据会丢吗?
通常停用不会删除数据,但卸载可能清理配置表。卸载前先导出或截图广告位设置。

分享到:
上一篇
Typecho文章阅读统计,增加浏览计数功能
下一篇
Z-BlogPHP sitemap自动生成
1
系统公告

泽御云中秋国庆双节活动上线:新购8折,拼团3.99元起

尊敬的用户:
泽御云“月满中秋·礼贺国庆”双节活动现已开启,活动时间为2026年9月23日至10月10日。 活动期间可享以下福利:
1. 常规云服务器新购使用优惠码“泽御中秋国庆同乐”,符合条件的订单享8折优惠。
2. 香港精品云服务器5人拼团低至3.99元,部分4核4G套餐3人拼团年付388元,续费同价。
3. 新用户购买年付云服务器,符合活动规则可赠送2个月使用时长。
4. 老用户续费季度赠15天,续费年度赠2个月;活动期间升级配置免收配置迁移手续费。
5. 推荐好友成功下单,符合条件的推荐人可获赠7天服务器使用时长。
6. 活动期间享宕机补偿标准翻倍、简单网站迁移协助及技术工单优先处理权益。
温馨提示:优惠码不适用于拼团套餐、活动轻量产品、年付订单及续费订单;拼团套餐为独立特价活动,不与赠时类福利叠加。赠送时长不可折现、退款或跨账户转移,具体规则以活动页面说明为准。
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意