新增：布局视图页面全局增加 headPrepend section

Author: modstart

config/module.php

@@ -34,7 +34,10 @@
         'VisitStatistic' => [
             'enable' => true,
         ],
-        // 'AdminApi' => [
+        // 'TemplateConverter' => [
+        //     'enable' => true,
+        // ],
+        // 'BlogThemeLightA' => [
         //     'enable' => true,
         // ],
         // 'BlogAdminApi' => [

module/Banner/Docs/module/content.md

@@ -14,45 +14,40 @@
 
 ## 使用方式
 
-在需要使用到的地方通过如下代码调用
-
-```html
-{!! \Module\Banner\View\BannerView::simple('位置') !!}
-```
-
-## 模块位置信息注册
-
-通过以下方式可以实现一个轮播位置，其中name为位置（position），title为标题。
-
 ```php
-class XxxBannerPositionProvider extends AbstractBannerPositionProvider
-{
-    public function name()
-    {
-        return 'wendaHome';
-    }
-
-    public function title()
-    {
-        return '问答首页';
-    }
-}
+// 循环特定位置轮播
+@foreach(\MBanner::all('Xxx') as $banner)
+    @if($banner['type']===\Module\Banner\Type\BannerType::IMAGE)
+        图片
+        <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
+    @elseif($banner['type']===\Module\Banner\Type\BannerType::IMAGE_TITLE_SLOGAN_LINK)
+        图片+标题+描述+链接
+        <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
+    @elseif($banner['type']===\Module\Banner\Type\BannerType::VIDEO)
+        视频
+        <a href="{{ $banner['link'] }}">{{ $banner['video'] }}</a>
+    @endif
+@endforeach
+
+// 循环特定位置轮播（仅包含图片）
+@foreach(\MBanner::allImage('Xxx') as $banner)
+  <a href="{{ $banner['link'] }}">{{ $banner['image'] }}</a>
+@endforeach
 ```
 
-同时在 `ModuleServiceProvider` 中注册轮播位置
+### 不同位置轮播
 
 ```php
-if (class_exists(BannerPositionProvider::class)) {
-    BannerPositionProvider::register(XxxBannerPositionProvider::class);
-}
+// 位置 Blog
+\MBanner::all('Blog')
+// 位置 Cms
+\MBanner::all('Cms')
 ```
 
-如此便可在通用轮播管理的页面进行轮播的管理
-
-## 如何调整轮播的比例和大小
+### 快速渲染
 
-```html
-{!! \Module\Banner\View\BannerView::render('位置',['bannerRatio'=>'5-2']) !!}
+```php
+{!! \Module\Banner\View\BannerView::basic('位置') !!}
 ```
 
 默认情况下，轮播使用了 `5-2` 的比例，还支持的内置比例有，调用时候只需要添加 `宽-高` 的 `bannerRatio` 变量即可。
@@ -70,4 +65,31 @@ if (class_exists(BannerPositionProvider::class)) {
 如果需要其他尺寸，可自行在 `module/Banner/View/pc/public/banner.blade.php` 模板文件中调整。
 
 
-{ADMIN_MENUS}
+## 模块位置信息注册
+
+通过以下方式可以实现一个轮播位置，其中name为位置（position），title为标题。
+
+```php
+class XxxBannerPositionBiz extends \Module\Banner\Biz\AbstractBannerPositionBiz
+{
+    public function name()
+    {
+        return 'Xxx';
+    }
+
+    public function title()
+    {
+        return '特定位置';
+    }
+}
+```
+
+同时在 `XxxBannerPositionBiz` 中注册轮播位置
+
+```php
+\Module\Banner\Biz\BannerPositionBiz::register(XxxBannerPositionBiz::class);
+```
+
+如此便可在通用轮播管理的页面进行轮播的管理
+
+{ADMIN_MENUS}

module/Banner/Docs/release.md

@@ -1,5 +1,6 @@
 ## 1.8.0
 
+- 新增：轮播图获取支持近图片过滤方法
 - 优化：视频 `Banner` 概率不播放问题
 
 ---

module/Banner/Helpers/MBanner.php

@@ -1,22 +1,38 @@
 <?php
 
+use Module\Banner\Type\BannerType;
 use Module\Banner\Util\BannerUtil;
 
 /**
  * Class MBanner
  *
- * @Util 通用轮播
+ * @Util 轮播
  */
 class MBanner
 {
     /**
-     * @param string $position
-     * @return mixed
-     *
      * @Util 根据位置获取轮播数据
+     * @param $position string 位置
+     * @return array
      */
     public static function all($position = 'home')
     {
         return BannerUtil::listByPositionWithCache($position);
     }
-}
+
+    /**
+     * @Util 根据位置获取轮播数据（仅包含图片）
+     * @param $position string 位置
+     * @return array
+     */
+    public static function allImage($position)
+    {
+        $records = self::all($position);
+        return array_values(array_filter($records, function ($item) {
+            return in_array($item['type'], [
+                BannerType::IMAGE,
+                BannerType::IMAGE_TITLE_SLOGAN_LINK
+            ]);
+        }));
+    }
+}

module/Blog/Admin/Controller/ConfigController.php

@@ -23,7 +23,6 @@ public function index(AdminConfigBuilder $builder)
             $builder->text('Blog_Slogan', '博客标语');
             $builder->image('Blog_Avatar', '博客头像');
             $builder->text('Blog_ContactQQ', '联系方式-QQ');
-            $builder->text('Blog_ContactEmail', '联系方式-邮箱');
             $builder->text('Blog_ContactWeibo', '联系方式-微博');
             $builder->text('Blog_ContactWechat', '联系方式-微信');
         });

module/Blog/Api/Controller/BlogController.php

@@ -18,6 +18,7 @@
 use Module\Blog\Type\BlogVisitMode;
 use Module\Blog\Util\BlogCategoryUtil;
 use Module\Blog\Util\UrlUtil;
+use Module\HotSearch\Util\HotSearchUtil;
 use Module\Member\Util\MemberUtil;
 
 /**
@@ -95,6 +96,12 @@ public function paginate()
             // Log::info('records-' . json_encode($paginateData['records']));
         }
 
+        if ($keywords) {
+            if (modstart_module_enabled('HotSearch')) {
+                HotSearchUtil::hit($keywords);
+            }
+        }
+
 
         $category = null;
         if ($categoryId > 0) {
@@ -132,6 +139,7 @@ public function get()
         $record['images'] = AssetsUtil::fixFull($record['images']);
         $record['tag'] = TagUtil::string2Array($record['tag']);
         $record['_category'] = BlogCategoryUtil::get($record['categoryId']);
+        $record['_date'] = date('Y-m-d', strtotime($record['postTime']));
 
         $record['_visitVerified'] = false;
         switch ($record['visitMode']) {
@@ -161,14 +169,20 @@ public function get()
             $option = [];
             $option['where']['blogId'] = $record['id'];
             $option['where']['status'] = BlogCommentStatus::VERIFY_SUCCESS;
-
             $option['order'] = ['id', 'desc'];
             $commentPaginateData = ModelUtil::paginate('blog_comment', $commentPage, $commentPageSize, $option);
             $comments = $commentPaginateData['records'];
             $commentTotal = $commentPaginateData['total'];
             if (modstart_module_enabled('Member')) {
                 MemberUtil::mergeMemberUserBasics($comments);
             }
+            foreach ($comments as $i => $comment) {
+                $avatar = 'asset/image/avatar.svg';
+                if (!empty($comment['_memberUser']['avatar'])) {
+                    $avatar = $comment['_memberUser']['avatar'];
+                }
+                $comments[$i]['_avatar'] = AssetsUtil::fixFull($avatar);
+            }
         }
 
 

module/Blog/Core/MBlog.php

@@ -1,20 +1,20 @@
 <?php
 
 use Illuminate\Support\Facades\DB;
-use ModStart\Core\Assets\AssetsUtil;
-use ModStart\Core\Dao\ModelUtil;
-use ModStart\Core\Util\HtmlUtil;
-use ModStart\Core\Util\TagUtil;
 use Module\Blog\Model\Blog;
-use Module\Blog\Type\BlogVisitMode;
 use Module\Blog\Util\BlogCategoryUtil;
 use Module\Blog\Util\BlogTagUtil;
 
 /**
  * @Util 博客操作
+ * 1 统一用单数
  */
 class MBlog
 {
+    /**
+     * @Util 获取分类树
+     * @return array
+     */
     public static function categoryTree()
     {
         return BlogCategoryUtil::categoryTree();
@@ -71,6 +71,7 @@ public static function latestBlog($limit)
         return $paginateData['records'];
     }
 
+
     /**
      * @Util 获取置顶博客
      * @param $limit int 限制条数
@@ -116,6 +117,19 @@ public static function latestBlog($limit)
      *   // ...
      * ]
      */
+    public static function topBlog($limit)
+    {
+        $paginateData = self::paginateBlog(0, 1, $limit, [
+            'isTop' => true,
+        ]);
+        return $paginateData['records'];
+    }
+
+    /**
+     * @param $limit
+     * @return mixed
+     * @deprecated delete at 2024-05-09
+     */
     public static function topestBlog($limit)
     {
         $paginateData = self::paginateBlog(0, 1, $limit, [
@@ -230,6 +244,16 @@ public static function recommendBlog($limit)
         return $paginateData['records'];
     }
 
+    /**
+     * @Util 最新评论
+     * @param $limit int 限制条数
+     * @return array
+     */
+    public static function latestComment($limit)
+    {
+        return \Module\Blog\Util\BlogCommentUtil::latest($limit);
+    }
+
 
     /**
      * @Util 获取最热博客
@@ -398,65 +422,12 @@ public static function randomBlog($limit)
      */
     public static function paginateBlog($categoryId, $page = 1, $pageSize = 10, $option = [])
     {
-        if ($categoryId > 0) {
-            $option['whereIn'][] = ['categoryId', BlogCategoryUtil::childrenIds($categoryId)];
-        }
-        $option['where']['isPublished'] = true;
-        if (!isset($option['order'])) {
-            $option['order'] = [
-                ['isTop', 'desc'],
-                ['postTime', 'desc'],
-            ];
-        }
-        if (!isset($option['whereOperate'])) {
-            $option['whereOperate'] = [];
-        }
-        $option['whereOperate'] = array_merge([
-            ['postTime', '<', date('Y-m-d H:i:s')],
-        ], $option['whereOperate']);
-
-        $paginateData = ModelUtil::paginate('blog', $page, $pageSize, $option);
-        $records = self::buildRecords($paginateData['records']);
-        return [
-            'records' => $records,
-            'total' => $paginateData['total'],
-        ];
+        return \Module\Blog\Util\BlogUtil::paginateBlogsByCategoryId($categoryId, $page, $pageSize, $option);
     }
 
     public static function buildRecords($records)
     {
-        ModelUtil::decodeRecordsJson($records, 'images');
-        TagUtil::recordsString2Array($records, 'tag');
-        foreach ($records as $i => $v) {
-            $records[$i]['_category'] = BlogCategoryUtil::get($v['categoryId']);
-            $records[$i]['images'] = AssetsUtil::fixFull($v['images']);
-            $records[$i]['_images'] = [];
-            $records[$i]['_images'] = array_merge($records[$i]['_images'], $records[$i]['images']);
-            $records[$i]['_cover'] = null;
-            if (isset($records[$i]['images'][0])) {
-                $records[$i]['_cover'] = $records[$i]['images'][0];
-            }
-            if (isset($v['content'])) {
-                $ret = HtmlUtil::extractTextAndImages($v['content']);
-                if (!empty($ret['images'])) {
-                    $ret['images'] = AssetsUtil::fixFull($ret['images']);
-                    $records[$i]['_images'] = array_merge($records[$i]['_images'], $ret['images']);
-                }
-                if (empty($records[$i]['_cover']) && isset($ret['images'][0])) {
-                    $records[$i]['_cover'] = $ret['images'][0];
-                }
-            }
-            switch ($v['visitMode']) {
-                case BlogVisitMode::PASSWORD:
-                    $records[$i]['content'] = null;
-                    break;
-                case BlogVisitMode::OPEN:
-                default:
-                    // do nothing
-                    break;
-            }
-        }
-        return $records;
+        return \Module\Blog\Util\BlogUtil::buildRecords($records);
     }
 
     /**

module/Blog/Docs/release.md

@@ -4,6 +4,7 @@
 - 新增：博客标签数量侧边栏显示数量限制可设置
 - 新增：博客评论是否开启功能开关
 - 新增：博客后台设置页面布局重构
+- 新增：适配 HotSearch 模块，支持热门搜索关键词追踪
 
 ---
 

module/Blog/Model/BlogComment.php

@@ -0,0 +1,17 @@
+<?php
+
+
+namespace Module\Blog\Model;
+
+
+use Illuminate\Database\Eloquent\Model;
+
+class BlogComment extends Model
+{
+    protected $table = 'blog_comment';
+
+    public function blog()
+    {
+        return $this->belongsTo(Blog::class, 'blogId', 'id');
+    }
+}