From 8bd1fe1201906bdee51cb10f97fb70f45052a301 Mon Sep 17 00:00:00 2001
From: yiqiu <yiqiu@ycyaw.com>
Date: Fri, 21 Nov 2025 00:20:08 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=92=E4=BB=B6=E9=85=8D=E7=BD=AE=E8=BD=AE?=
 =?UTF-8?q?=E6=92=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 index.html                                 |  4 +-
 js/index.js                                | 81 ++++++++++++++++++----
 plugins/addon/theme_configurator/README.md | 23 +++++-
 3 files changed, 88 insertions(+), 20 deletions(-)

diff --git a/index.html b/index.html
index e03d8ee..9013f81 100644
--- a/index.html
+++ b/index.html
@@ -13,8 +13,8 @@
 
   <!-- banner -->
   <section class="section banner">
-    <div class="swiper banner-cont">
-      <div class="swiper-wrapper">
+    <div class="swiper banner-cont">
+      <div class="swiper-wrapper" id="bannerWrapper">
         {if ( isset($data.banner) ) }
         {foreach $data.banner as $key=>$value}
         <div class="swiper-slide">
diff --git a/js/index.js b/js/index.js
index 2b97141..983ba79 100644
--- a/js/index.js
+++ b/js/index.js
@@ -32,12 +32,71 @@ $(function () {
     }
   }
   isRecommend();
-  // 设置首页函数
-  function setIndexData() {
-    const commentObj = JSON.parse(sessionStorage.commentData);
-    if (commentObj.honor.length > 0) {
-      commentObj.honor.forEach((item) => {
-        $("#certBox").append(`<div class="cert-item">
+  let bannerSwiper = null;
+  const initBannerSwiper = () => {
+    if (bannerSwiper) {
+      bannerSwiper.destroy(true, true);
+    }
+    bannerSwiper = new Swiper(".swiper", {
+      loop: true,
+      autoplay: true,
+      pagination: {
+        el: ".swiper-pagination",
+        clickable: true,
+      },
+    });
+  };
+
+  const renderBannerSlides = (list = []) => {
+    const wrapper = document.getElementById("bannerWrapper");
+    if (!wrapper) {
+      return;
+    }
+    if (!Array.isArray(list) || list.length === 0) {
+      initBannerSwiper();
+      return;
+    }
+    wrapper.innerHTML = "";
+    list.forEach((item) => {
+      const slide = document.createElement("div");
+      slide.className = "swiper-slide";
+      const title = item.title ? `<h1>${item.title}</h1>` : "";
+      const desc = item.description
+        ? `<p class="banner-desc">${item.description}</p>`
+        : "";
+      let buttonHtml = "";
+      if (item.button_text) {
+        const link = item.button_link || "javascript:;";
+        const target = item.button_blank ? "_blank" : "_self";
+        buttonHtml = `<a class="btn btn2 btn-normal" href="${link}" target="${target}">${item.button_text}</a>`;
+      }
+      const targetAttr = item.blank ? "_blank" : "_self";
+      const imgHtml = `<img class="img-responsive img center-block" src="${
+        item.img || ""
+      }" alt="${item.alt || item.title || "banner"}">`;
+      const mediaBlock = item.url
+        ? `<a href="${item.url}" target="${targetAttr}">${imgHtml}</a>`
+        : imgHtml;
+      const contentBlock =
+        title || desc || buttonHtml
+          ? `<div class="section-content">${title}${desc}${buttonHtml}</div>`
+          : "";
+      slide.innerHTML = `
+        ${mediaBlock}
+        ${contentBlock}
+      `;
+      wrapper.appendChild(slide);
+    });
+    initBannerSwiper();
+  };
+
+  // 设置首页函数
+  function setIndexData() {
+    const commentObj = JSON.parse(sessionStorage.commentData);
+    renderBannerSlides(commentObj.banner);
+    if (commentObj.honor.length > 0) {
+      commentObj.honor.forEach((item) => {
+        $("#certBox").append(`<div class="cert-item">
           <img src=${item.img} alt="">
           <p class="mt-20">${item.name}</p>
         </div>`);
@@ -106,15 +165,7 @@ $(function () {
     viewer.show();
   });
 
-  const mySwiper = new Swiper(".swiper", {
-    loop: true, // 循环模式选项
-    autoplay: true,
-    // 如果需要分页器
-    pagination: {
-      el: ".swiper-pagination",
-      clickable: true,
-    },
-  });
+  initBannerSwiper();
   function formateTimeFun(time) {
     const date = new Date(time * 1000);
     Y = date.getFullYear() + "-";
diff --git a/plugins/addon/theme_configurator/README.md b/plugins/addon/theme_configurator/README.md
index 31b9c9f..7634860 100644
--- a/plugins/addon/theme_configurator/README.md
+++ b/plugins/addon/theme_configurator/README.md
@@ -3,7 +3,7 @@
 此插件演示如何通过后台插件的方式为 BlackFruit-UI 主题提供可配置能力，支持设置导航、页脚、站点信息、SEO、首页轮播以及右侧浮窗，并提供 `/console/v1/theme/config` 接口与前端联动。
 
 ## 功能
-- 后台界面（`template/admin/index.php`）以 JSON 的形式集中维护所有主题参数；
+- 后台界面（`template/admin/index.html`）以 JSON 的形式集中维护所有主题参数；
 - 接口 `GET/POST /{DIR_ADMIN}/v1/theme/config` 提供配置读取与保存；
 - 前台接口 `GET /console/v1/theme/config` 输出与 `/console/v1/common` 相同结构的数据，BlackFruit-UI 可以直接接入；
 - 插件安装时创建 `addon_theme_configurator` 表并写入默认配置。
@@ -16,7 +16,7 @@ plugins/addon/theme_configurator
 │   ├── ThemeController.php        # 后台 API
 │   └── clientarea/ThemeController.php # 前台 API
 ├── model/ThemeConfigModel.php     # 主题配置模型
-├── template/admin/index.php       # 后台可视化页面
+├── template/admin/index.html      # 后台可视化页面
 ├── route.php                      # 自定义路由定义
 ├── sidebar*.php                   # 前后台导航
 ├── auth.php                       # 权限配置
@@ -26,5 +26,22 @@ plugins/addon/theme_configurator
 ## 使用步骤
 1. 将目录复制到业务系统的 `public/plugins/addon` 下；
 2. 在后台启用插件，安装脚本会自动创建 `addon_theme_configurator` 表；
-3. 进入“插件 > 主题配置”页，按 JSON 结构维护导航、SEO、轮播、侧边栏等；
+3. 进入“插件 > 主题配置”页（`index.html`），按 JSON 结构维护导航、SEO、轮播、侧边栏等；
 4. 前端 BlackFruit-UI 请求 `/console/v1/theme/config` 以获取运行时配置。若需要兼容现有 `/console/v1/common`，可在 Nginx 或网关层做转发。
+
+### banner 字段示例
+```json
+"banner": [
+  {
+    "title": "中小企业的云计算底座",
+    "description": "自定义文案",
+    "img": "/upload/banner-1.png",
+    "url": "/cloud.html",
+    "blank": false,
+    "button_text": "立即查看",
+    "button_link": "/cloud.html",
+    "button_blank": false
+  }
+]
+```
+BlackFruit-UI 会在首页读取 `banner` 数组动态渲染轮播图，`url/blank` 控制整张 Banner 的跳转，`button_*` 控制右下角按钮。