feat: 博客新增按年获取

Author: modstart

module/Banner/Type/BannerPosition.php

@@ -7,15 +7,13 @@
 use ModStart\Core\Type\BaseType;
 use ModStart\Module\ModuleManager;
 use Module\Banner\Biz\BannerPositionBiz;
-use Module\Banner\Provider\BannerPositionProvider;
 
 class BannerPosition implements BaseType
 {
     public static function getList()
     {
         return array_merge(
             ModuleManager::getModuleConfigKeyValueItems('Banner', 'position'),
-            BannerPositionProvider::allMap(),
             BannerPositionBiz::allMap()
         );
     }

module/Blog/Admin/Controller/BlogController.php

@@ -16,6 +16,7 @@
 use ModStart\Support\Concern\HasFields;
 use Module\Blog\Util\BlogCategoryUtil;
 use Module\Blog\Util\BlogTagUtil;
+use Module\Vendor\Provider\SiteUrl\SiteUrlProvider;
 
 class BlogController extends Controller
 {
@@ -63,6 +64,10 @@ protected function crud(AdminCRUDBuilder $builder)
             ->hookChanged(function (Form $form) use (&$updatedCategoryIds) {
                 RepositoryUtil::makeItems($form->item())->map(function ($item) use (&$updatedCategoryIds) {
                     $updatedCategoryIds[] = $item->categoryId;
+                    SiteUrlProvider::update(modstart_web_url('blog/' . $item->id), $item->title, [
+                        'biz' => 'blog',
+                    ]);
+                    var_dump($item);
                 });
                 if (!empty($updatedCategoryIds)) {
                     $updatedCategoryIds = array_unique($updatedCategoryIds);

module/Blog/Core/MBlog.php

@@ -4,6 +4,7 @@
 use ModStart\Core\Dao\ModelUtil;
 use ModStart\Core\Util\HtmlUtil;
 use ModStart\Core\Util\TagUtil;
+use Module\Blog\Model\Blog;
 use Module\Blog\Util\BlogCategoryUtil;
 use Module\Blog\Util\BlogTagUtil;
 
@@ -80,7 +81,15 @@ public static function paginateBlog($categoryId, $page = 1, $pageSize = 10, $opt
         ], $option['whereOperate']);
 
         $paginateData = ModelUtil::paginate('blog', $page, $pageSize, $option);
-        $records = $paginateData['records'];
+        $records = self::buildRecords($paginateData['records']);
+        return [
+            'records' => $records,
+            'total' => $paginateData['total'],
+        ];
+    }
+
+    private static function buildRecords($records)
+    {
         ModelUtil::decodeRecordsJson($records, 'images');
         TagUtil::recordsString2Array($records, 'tag');
         foreach ($records as $i => $v) {
@@ -90,16 +99,46 @@ public static function paginateBlog($categoryId, $page = 1, $pageSize = 10, $opt
             if (isset($records[$i]['images'][0])) {
                 $records[$i]['_cover'] = $records[$i]['images'][0];
             }
-            if (empty($records[$i]['_cover'])) {
+            if (empty($records[$i]['_cover']) && isset($v['content'])) {
                 $ret = HtmlUtil::extractTextAndImages($v['content']);
                 if (isset($ret['images'][0])) {
                     $records[$i]['_cover'] = AssetsUtil::fixFull($ret['images'][0]);
                 }
             }
         }
+        return $records;
+    }
+
+    
+    public static function listBlogByYear($option = [])
+    {
+
+        $records = Blog::query()->where(['isPublished' => true])
+            ->where('postTime', '<', date('Y-m-d H:i:s'))
+            ->orderBy('postTime', 'desc')
+            ->get(['id', 'images', 'tag', 'title', 'categoryId', 'postTime'])
+            ->toArray();
+        $records = self::buildRecords($records);
+
+        $yearRecords = [];
+        foreach ($records as $i => $v) {
+            $year = date('Y', strtotime($v['postTime']));
+            if (!isset($yearRecords[$year])) {
+                $yearRecords[$year] = [
+                    'count' => 0,
+                    'year' => $year,
+                    'records' => [],
+                ];
+            }
+            $yearRecords[$year]['records'][] = $v;
+        }
+        foreach ($yearRecords as $i => $v) {
+            $yearRecords[$i]['count'] = count($v['records']);
+        }
+
         return [
-            'records' => $records,
-            'total' => $paginateData['total'],
+            'total' => count($records),
+            'records' => $yearRecords,
         ];
     }
 

module/Blog/Docs/release.md

@@ -1,5 +1,6 @@
 ## 2.6.0
 
+- 新增：博客主动URL推送功能
 - 修复：博客列表移动端标题显示异常问题
 
 ---

module/Partner/Type/PartnerPosition.php

@@ -7,15 +7,13 @@
 use ModStart\Core\Type\BaseType;
 use ModStart\Module\ModuleManager;
 use Module\Partner\Biz\PartnerPositionBiz;
-use Module\Partner\Provider\PartnerPositionProvider;
 
 class PartnerPosition implements BaseType
 {
     public static function getList()
     {
         return array_merge(
             ModuleManager::getModuleConfigKeyValueItems('Partner', 'position'),
-            PartnerPositionProvider::allMap(),
             PartnerPositionBiz::allMap()
         );
     }

module/Vendor/Docs/doc/ContentVerify.md

@@ -0,0 +1,54 @@
+# 如何实现一个内容审核提供者
+
+---
+
+## 如何实现一个内容审核提供者
+
+### 第一步，实现一个内容审核提供者
+
+```php
+class XxxPostContentVerifyProvider extends AbstractContentVerifyProvider
+{
+    const NAME = 'XxxPost';
+    const TITLE = '内容发布审核';
+
+    public function name()
+    {
+        return self::NAME;
+    }
+
+    public function title()
+    {
+        return self::TITLE;
+    }
+
+    public function verifyCount()
+    {
+        return ModelUtil::count('post', ['status' => PostStatus::WAIT_VERIFY]);
+    }
+
+    public function verifyRule()
+    {
+        return '\\Module\\Xxx\\Admin\\Controller\\PostController@verifyList';
+    }
+
+}
+```
+
+### 第二步，注册内容提供者
+
+在 ModuleServiceProvider 中注册内容审核提供者和通知提供者
+
+```php
+// 注册内容审核提供者
+ContentVerifyProvider::register(XxxPostContentVerifyProvider::class);
+// 注册通知的目的是为了发送通知链接
+NotifierBizWidget::register(XxxPostContentVerifyProvider::NAME, XxxPostContentVerifyProvider::TITLE);
+```
+
+## 第三步，创建审核任务
+
+```php
+// 创建一个审核任务
+ContentVerifyJob::create(XxxPostContentVerifyProvider::NAME, ['id' => $post['id']], $post['title']);
+```

module/Vendor/Docs/doc/ContentVerifyManual.md

@@ -0,0 +1,4 @@
+# ContentVerifyProvider 内容审核提供者使用教程
+
+---
+

module/Vendor/Docs/doc/ContentVerifyProvider.md

@@ -0,0 +1,31 @@
+# Notifier 通知提供者使用教程
+
+---
+
+可以为网站提供一个即时通知的功能，目前通知提供者支持：
+
+- [邮件消息通知](/m/NotifierEmail)
+- [钉钉消息通知](/m/NotifierDingTalk)
+- [企业微信消息通知](/m/NotifierWorkWeixin)
+
+第一步，注册通知类型
+
+在 `ModuleServiceProvider::boot` 中注册业务
+
+```php
+NotifierBizWidget::register('Xxx_NewOrder', 'XXX-新订单');
+```
+
+第二步，在业务处调用通知
+
+```php
+// 使用单一内容
+NotifierProvider::notify('Xxx_NewOrder', 'XXX-新订单', "订单号：xxx，支付金额：xxx");
+// 或者数组内容
+NotifierProvider::notify('Xxx_NewOrder', '有新的咨询', [
+    '单号' => 'xxxxxxxxx',
+    '时间' => date('Y-m-d H:i:s'),
+    '内容' => '想请问一下消息通知靠谱吗？',
+    'QQ' => '2131311518',
+]);
+```

module/Vendor/Docs/doc/Notifier.md

@@ -2,9 +2,11 @@
 
 「ModStart基础包」提供公共的基础服务，几乎所有的模块都需要依赖该模块的方法和类。
 
-## 提供者 Provider
+## 提供者和使用者 Provider 和 Biz
 
-提供者提供了抽象的服务，可以在模块中实现具体的业务支持。
+提供者（Provider）提供了抽象的服务，可以在模块中实现具体的业务支持。一个简单的例子，系统提供一周抽象的人机验证方式，如果你提供了一个具体的人机验证方式，那么你就可以实现一个人机验证提供者。
+
+使用者（Biz）提供了具体的应用服务，不同的使用者可以注册完成应用服务的使用。 一个简单的例子，系统提供了一个评论使用者，如果你需要评论功能，那么你就可以使用评论使用者。
 
 - Captcha 人机验证提供者
 - CensorImage 图片智能审核提供者
@@ -28,52 +30,5 @@
 - VideoStream 视频点播提供者
 - OCR 图片文字识别
 
-## 使用者 Biz
-
-使用者提供了具体的应用服务，不同的使用者可以注册完成应用服务的使用。
-
-## 使用教程
-
-### ContentVerify 内容审核提供者
-
-可以为网站提供一个审核系统，目前支持人工审核和智能审核，智能审核需要搭配 `CensorImage` 和 `CensorText` 可以实现智能审核
-
-目前图片智能审核提供者支持：
-
-- [魔众图片审核](/m/CensorImageTecmz)
-
-目前文字智能审核提供者支持：
-
-- [魔众文字审核](/m/CensorTextTecmz)
-
-使用方式请参见 [如何实现一个内容审核提供者](/m/Vendor/doc/ContentVerifyManual)
-
-### Notifier 通知提供者
-
-可以为网站提供一个即时通知的功能，目前通知提供者支持：
-
-- [邮件消息通知](/m/NotifierEmail)
-- [钉钉消息通知](/m/NotifierDingTalk)
-- [企业微信消息通知](/m/NotifierWorkWeixin)
-
-第一步，注册通知类型
-
-在 `ModuleServiceProvider::boot` 中注册业务
-
-```php
-NotifierBizWidget::register('Xxx_NewOrder', 'XXX-新订单');
-```
 
-第二步，在业务处调用通知
 
-```php
-// 使用单一内容
-NotifierProvider::notify('Xxx_NewOrder', 'XXX-新订单', "订单号：xxx，支付金额：xxx");
-// 或者数组内容
-NotifierProvider::notify('Xxx_NewOrder', '有新的咨询', [
-    '单号' => 'xxxxxxxxx',
-    '时间' => date('Y-m-d H:i:s'),
-    '内容' => '想请问一下消息通知靠谱吗？',
-    'QQ' => '2131311518',
-]);
-```