织页CMS 3.1 广告教程

横幅 / JS 广告配置、ads.txt 写法、素材路径与日志查看(按 3.1 编写)。

如何启动广告设置

你有两种启动方式:

  • yiye:直接在终端输入,然后选择 [3] 广告设置
  • 进入安装目录后运行:./yiye.sh,然后选择 [3] 广告设置(内部会调用 sh/yiye-ads-manager.sh

如果你不知道安装目录在哪,可以从安装记录里查看:

# root 用户
cat /etc/yiye/install.env

ads.txt:选择哪些站点要加广告

ads.txt 在 织页CMS 安装目录里(与 yiye.sh 同级)。一行一个域名,例如:

linjiadiaosu.com
2.com
重要:必须先建站
脚本会检查每个域名是否存在:/opt/1panel/www/sites/<域名>/index/config/ads/ads.yml。如果不存在,会在终端汇总为“未建站/缺少 ads.yml”。

菜单功能说明(3.sh)

  • [1] 关闭广告:把站点 enabled 设为 false
  • [2] 仅开启广告:把站点 enabled 设为 true,不改变现有广告类型/素材
  • [3] 横幅模式:开启广告 + 设置 driver=banner + 拷贝图片到站点 /assets/ads/ + 自动替换 banner.image.src
  • [4] JS 模式:开启广告 + 设置 driver=custom_js + 拷贝 JS 到站点 /assets/ads/ + 只修改 custom_js.scripts 的第一条脚本(统计脚本不改)
  • [0] 退出

横幅广告(banner)怎么配置

  1. 把你的横幅图片放到安装目录:ads/images/(与 3.sh 同级的 ads/images
  2. 运行广告脚本,选择 [3] 横幅模式,再选择要使用的图片文件

脚本会自动执行:

  • ads/images/ 里的文件拷贝到每个站点:/opt/1panel/www/sites/<域名>/index/assets/ads/
  • 把站点 config/ads/ads.ymldriver 改为 banner,并把横幅 src 改为:/assets/ads/<你选的文件名>
图片格式提示
插件通常只允许:gif/jpg/jpeg/png/webp。脚本会尽量支持任意文件名,但如果你用非常规后缀,站点可能不显示横幅(建议用上述格式)。

JS 广告(custom_js)怎么配置

  1. 把你的广告 JS 文件放到安装目录:ads/js/(例如 ads.js
  2. 运行广告脚本,选择 [4] JS 模式,再选择要使用的 JS 文件

脚本会自动执行:

  • ads/js/ 里的文件拷贝到每个站点:/opt/1panel/www/sites/<域名>/index/assets/ads/
  • 把站点 config/ads/ads.ymldriver 改为 custom_js
  • 只修改 custom_js.scripts 的第一条(例如 /assets/ads/ads.js),并把该条 enabled 设为 true
  • 统计脚本(例如 /assets/ads/statistics.js)不会被修改

示例:一个最小的 JS 文件(你可以按需替换为“覆盖/跳转/iframe”等逻辑):

// /assets/ads/ads.js\n// 示例:输出一行日志(请替换为你的广告逻辑)\nconsole.log('ads loaded');
风险提示
JS 模式的最终效果由你的 JS 代码决定(覆盖/跳转/iframe 等)。请自行评估对用户体验与 SEO 的影响,并只在你明确需要的站点启用。

日志在哪里看

每次运行广告脚本都会生成一份独立日志,路径在终端第一行会显示,默认在安装目录下:

./logs/ads-YYYYMMDD-001.log