首页幻灯片

📅 2026-11-21 👁️ 1

首页幻灯片

首页幻灯片用于维护首页 Banner 图片及其链接、ALT 和简介,按分组管理,供模板调用展示。

入口路径

后台顶部菜单 →「设置」→「首页幻灯片」。实际地址:/system/setting/banner,需要管理员权限(canAdmin)。

功能说明

页面按分组展示 Banner 列表(源码默认分组为 default),支持添加、修改、删除和预览。每条 Banner 包含图片、链接、ALT 文本和简介。

界面截图

首页幻灯片

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
幻灯片分组 决定这组 Banner 归属哪个位置 select,可在下拉内新增;默认 default [源码+实测] 多位置轮播时按位置命名,如 home、activity 模板用 type 指定分组,大小写敏感;未提交时前端兜底 default [源码]
幻灯片图片 Banner 图片 图片上传,无默认 [源码] 按模板要求尺寸上传;同组保持相同宽高比 图片过大影响加载,建议开启 Webp 与压缩
链接地址 点击 Banner 的跳转地址 URL,留空则不可点击 [源码] 填完整 URL 或站内**路径 外链是否新开窗口由模板决定
ALT 图片替代文字 文本,无默认 [源码] 简明描述图片内容 有利于 SEO 和无障碍访问;源码另有兼容字段 title 但前端未暴露
介绍 Banner 的文字说明 文本,无默认 [源码] 写简短活动说明 是否输出由模板决定

配置项详解

幻灯片分组

出现条件:页面顶部分组标签 + 新增弹窗中的「幻灯片分组」下拉 [实测]。

源码默认 default(config/setting.go:111,116,120);新增分组名必填,可在下拉框中直接新增 [源码]。

推荐值:单位置站点保持 default;多轮播位按位置命名,模板用 {% bannerList banners with type="分组名" %} 调用。

填错后果:模板 type 与分组名不一致(含大小写)会读不到数据。

操作步骤

  1. 进入「设置 → 首页幻灯片」。
  2. 选择分组,点击「添加」。
  3. 上传图片并填写链接、ALT、简介。
  4. 点击预览确认效果,再保存。
  5. 需要修改时点「修改」,不再使用点「删除」(有确认弹窗)。

适用场景与建议

  • 多位置轮播:为首页、活动页分别建分组,模板按分组调用,互不干扰。
  • 图片尺寸:同一分组的 Banner 使用相同宽高比,避免轮播时页面跳动。

前台调用示例

{% bannerList banners with type="default" %}
  {% for item in banners %}
    <a href="{{ item.Link }}" target="_blank">
      <img src="{{ item.Image }}" alt="{{ item.Alt }}" />
    </a>
  {% endfor %}
{% endbannerList %}

不传 type 时输出默认分组。循环内可用 forloop.Counter 判断是否为**张。

注意事项

  • 分组名要与模板调用时的 type 完全一致,大小写敏感。
  • 删除 Banner 有确认弹窗,删除后前台会立即少一条数据。
  • 图片 URL 变更后如果前台仍显示旧图,清理缓存。

相关文档

相关文章

AI 统一配置

AI 统一配置用于集中管理 AI 写作/翻译接口、AI 助手接口,以及 MCP 开放接口的权限与安全策略。

2026-11-21

网站导航设置使用帮助

网站导航设置网站的导航链接,并用于网站前台的展示。除了设置默认的顶部导航内,还可以根据自身需要,添加其他的位置导航,比如页脚导航、侧边栏导航等形式的自定义导航内容。导航列表中,可以支持最多2级的导航链接,也就是只支持一级下拉导航链接。导航类别管理默认设置中,系统内容了默认导航这一个类别,如果你有需求

2022-06-20

首页TDK设置使用帮助

首页TDK设置可以设置网站首页的title、keywords、description 三个标签的内容。首页TDK设置中可以设置的有:首页标题首页标题将在首页中的 标签中显示,为首页优化带来更好的体验。首页关键词首页关键词将在首页中的 标签中显示,用于设置需要优化整站的核心关键词。适当设置关键词可以

2022-06-20

联系方式设置使用帮助

联系方式设置默认可设置联系人、联系电话、联系地址、联系邮箱、微信号、微信二维码信息,如果觉得默认的设置项不能满足需要,还可以自定义新的设置项。默认的设置项可以设置的有:联系人一般上用于设置显示在前端联系方式上,用于给客户称呼使用的联系人,比如:王先生联系电话联系电话一般填写为用户可以联系上你的电话,

2022-06-20

联系方式设置

联系方式设置用于维护联系人、电话、地址、邮箱、微信、社交媒体和店铺信息,供模板在前台调用展示。

2026-11-21

内容设置

内容设置用于控制文档的编辑器、URL 生成规则、列表分页、图片处理与缩略图策略,影响全站内容的录入方式和前台展示效果。

2026-11-21

货币设置

货币设置用于定义商城展示和订单接口返回的货币名称、国际代码与符号。

2026-11-21

导航设置

导航设置用于维护网站前台的导航链接,支持自定义导航类别和两级导航结构。

2026-11-21