mercurius

Mercurius - Laravel 的 Messenger" style="max-width: 100%;">

目錄

• 關於
• 預覽
• 特徵
• 截圖
• 示範
• 安裝
• 客製化
• 路線圖
• 支援
• 貢獻
• 變更日誌
• 製作人員
• 版權與許可

關於

mercurius是一個使用 Laravel 和 Vue.js 的即時訊息系統，具有完整的應用程序，您可以輕鬆地在任何 Laravel 專案中安裝它。

預覽

Mercurius 預覽" data-animated-image="" style="max-width: 100%;">

特徵

• 即時通訊工具
• 反應靈敏
• 多種語言
• 瀏覽器通知
• 獨特的使用者體驗，深色主題
• 打字指示器
• 刪除對話和訊息
• 使用自動完成功能搜尋收件人

截圖

點擊大拇指放大圖像

示範

您可以嘗試mercurius的示範。使用下列任一憑證進行驗證：

• [email protected]
• [email protected]
• [email protected]

密碼： password

提示：開啟2個不同的瀏覽器並使用不同的使用者名稱登錄，以便您可以測試傳送/接收訊息。

安裝

在繼續之前確保 Laravel 5.6 + 已安裝。

1. 設定推播器

如果您沒有帳戶，請在 Pusher.com 網站上建立免費帳戶。轉到儀表板，建立一個新應用程式並記下 API 憑證。

現在，讓我們將 API 金鑰新增到.env檔案中。另外，將BROADCAST_DRIVER更改為pusher （預設為log ）。

 . . .
BROADCAST_DRIVER =pusher
. . .
PUSHER_APP_ID ="xxxxxx"
PUSHER_APP_KEY ="xxxxxxxxxxxxxxxxxxxx"
PUSHER_APP_SECRET ="xxxxxxxxxxxxxxxxxxxx"
PUSHER_APP_CLUSTER ="xx"

2.註冊BroadcastServiceProvider

開啟config/app.php並取消註解行AppProvidersBroadcastServiceProvider::class, 。

3. Laravel 身份驗證

如果身份驗證已設置，請跳過此步驟，否則鍵入：

php artisan make:auth

4.安裝mercurius

composer require launcher/ mercurius 

5. 配置（可選）

如果要變更預設配置，請鍵入下列命令來發佈設定檔：

php artisan vendor:publish --tag= mercurius -config

若要編輯配置，請開啟/config/ mercurius .php並新增您自己的值。

mercurius Models |-------------------------------------------------------------------------- | | Defines the models used with mercurius , use it to extend mercurius and | create your own implementation. | */ 'models' => [ 'user' => AppUser::class, 'messages' => Launcher mercurius ModelsMessage::class, ], /* |-------------------------------------------------------------------------- | User Table Fields |-------------------------------------------------------------------------- | | You can specify the column names for the user table. The `name` accepts | an array of fields, for building custom names with multiple columns. | */ 'fields' => [ // 'name' => ['first_name', 'last_name'], 'name' => 'name', 'slug' => 'slug', 'avatar' => 'avatar', ], ];">

 return [

    /*
    |--------------------------------------------------------------------------
    | mercurius Models
    |--------------------------------------------------------------------------
    |
    | Defines the models used with mercurius , use it to extend mercurius and
    | create your own implementation.
    |
    */

    ' models ' => [
        ' user ' => App User::class,
        ' messages ' => Launcher  mercurius  Models Message::class,
    ],

    /*
    |--------------------------------------------------------------------------
    | User Table Fields
    |--------------------------------------------------------------------------
    |
    | You can specify the column names for the user table. The `name` accepts
    | an array of fields, for building custom names with multiple columns.
    |
    */

    ' fields ' => [
        // 'name'   => ['first_name', 'last_name'],
        ' name '   => ' name ' ,
        ' slug '   => ' slug ' ,
        ' avatar ' => ' avatar ' ,
    ],
];

6.安裝mercurius

mercurius:install composer dump-autoload">

php artisan mercurius :install
composer dump-autoload

7. 使用者特徵

將Launcher mercurius mercurius User特徵新增至您的User模型：

mercurius User; class User extends Authenticatable { use mercurius User; // ... }">

 // ...
use Illuminate  Foundation  Auth  User as Authenticatable ;
use Launcher  mercurius  mercurius User ;

class User extends Authenticatable
{
    use mercurius User;
    // ...
}

8.安裝虛擬資料（用於測試）

php artisan db:seed --class= mercurius DatabaseSeeder

將向系統新增訊息和用戶，如演示範例所示：

演示用戶：

• 伊恩： [email protected]
• 諾亞： [email protected]
• 盧阿： [email protected]

密碼： password

更新mercurius

每當您更新mercurius時，請確保發布資源以套用新版本的 CSS/JS。

php artisan vendor:publish --tag= mercurius -public --force

客製化

請參閱定制以獲取更多資訊。

路線圖

查看路線圖以獲取更多資訊。

• 單元測試
• 與多個使用者對話 #13
• 網路鉤子#16
• 上傳照片和文件 #14
• 預覽圖像和影片 #15
• 表情符號支持 #18
• 視訊聊天 #19
• 支援socket.io #20
• 搜尋訊息 #17

支援

• 建立一個新問題
• 加入我們的 Slack 頻道

貢獻

請參閱貢獻以獲取更多資訊。

變更日誌

我們保留變更日誌，其中包含已變更的資訊。

製作人員

• 布魯諾託林哈
• 所有貢獻者

版權和許可

版權所有 2018 布魯諾託林哈。 mercurius是根據 MIT 許可證發布的。