New plugin API: addUserBadge

app/Events/RenderingBadges.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Events;
+
+class RenderingBadges extends Event
+{
+    public $badges;
+
+    public function __construct(array &$badges)
+    {
+        $this->badges = &$badges;
+    }
+}

app/Services/Hook.php

@@ -53,8 +53,6 @@ class Hook
 
     /**
      * Add routes. A router instance will be passed to the given callback.
-     *
-     * @param Closure $callback
      */
     public static function addRoute(Closure $callback): void
     {
@@ -118,4 +116,14 @@ class Hook
             }
         }, $priority);
     }
+
+    public static function addUserBadge(string $text, $color = 'primary'): void
+    {
+        Event::listen(
+            Events\RenderingBadges::class,
+            function (Events\RenderingBadges $event) use ($text, $color) {
+                $event->badges[] = [$text, $color];
+            }
+        );
+    }
 }

resources/misc/changelogs/en/4.3.0.md

@@ -5,6 +5,7 @@
 - Added configurable "Explore" menu.
 - Custom `PLUGINS_DIR` with relative path is allowed.
 - Added link for editing announcement.
+- New plugin API: [`Hook::addUserBadge`](https://bs-plugin.netlify.com/guide/bootstrap.html#%E6%98%BE%E7%A4%BA%E7%94%A8%E6%88%B7-badge).
 
 ## Tweaked
 

resources/misc/changelogs/zh_CN/4.3.0.md

@@ -5,6 +5,7 @@
 - 添加可自定义的「浏览」菜单
 - 允许在 `PLUGINS_DIR` 配置项中使用相对路径
 - 添加「编辑公告」的链接
+- 新插件 API：[`Hook::addUserBadge`](https://bs-plugin.netlify.com/guide/bootstrap.html#%E6%98%BE%E7%A4%BA%E7%94%A8%E6%88%B7-badge)
 
 ## 调整
 

resources/views/common/user-panel.blade.php

@@ -7,6 +7,11 @@ $roles = [
 ];
 $role = $roles[$user->permission];
 @endphp
+
+@php
+    $badges = [];
+    event(new \App\Events\RenderingBadges($badges));
+@endphp
 <div class="user-panel">
     <div class="pull-left image">
         <img src="{{ url("avatar/45/".base64_encode($user->email).'.png?tid='.$user->avatar) }}" alt="User Image">
@@ -14,5 +19,15 @@ $role = $roles[$user->permission];
     <div class="pull-left info">
         <p class="nickname">{{ $user->nickname ?? $user->email }}</p>
         <i class="fas fa-circle text-success"></i> @lang("admin.users.status.$role")
+        @if (count($badges) === 1)
+            <small class="label bg-{{ $badges[0][1] }}">{{ $badges[0][0] }}</small>
+        @endif
     </div>
 </div>
+@if (count($badges) > 1)
+<div class="user-panel" style="padding-top: 0">
+    @foreach ($badges as $badge)
+    <small class="label bg-{{ $badge[1] }}">{{ $badge[0] }}</small>
+    @endforeach
+</div>
+@endif

tests/ServicesTest/HookTest.php

@@ -84,4 +84,12 @@ class HookTest extends TestCase
         $this->get('/skinlib')
             ->assertSee('<script src="/script/pattern"></script>');
     }
+
+    public function testAddUserBadge()
+    {
+        Hook::addUserBadge('hi', 'green');
+        $this->actAs('normal')
+            ->get('/user')
+            ->assertSee('<small class="label bg-green">hi</small>');
+    }
 }