Mercurius 项目介绍
关于 Mercurius
Mercurius 是一款基于 Laravel 和 Vue.js 的实时消息系统。这个完整的应用程序可以轻松地集成到任何 Laravel 项目中,让开发者能够在他们的应用中加入实时通讯功能。
功能特色
- 实时消息传递:用户可以即时接收和发送信息。
- 响应式设计:在各种设备上都有良好的显示效果。
- 多语言支持:能够适应全球用户的语言需求。
- 浏览器通知:在有新消息时给用户发送提醒。
- 独特的用户体验:提供黑色主题以迎合不同用户的喜好。
- 输入提示:可以看到对方是否正在输入信息。
- 删除对话和消息:保持信息的私密性。
- 智能搜索:通过自动完成功能快速找到收件人。
预览与截图
Mercurius 提供了一些界面截图,例如主界面、对话视图、信息悬停效果、撰写信息界面以及用户设置等,展示了应用程序的外观和使用方式。
在线演示
用户可以通过访问 在线演示地址 来体验 Mercurius。在两个不同的浏览器中使用不同的用户名登录以测试信息的发送和接收功能。测试账户包括:ian@launcher.host
,noa@launcher.host
,lua@launcher.host
,密码统一为password
。
安装指南
-
设置 Pusher:首先确保已在 pusher.com 上创建账户,并在应用程序中配置 API 凭证。
-
注册
BroadcastServiceProvider
:在config/app.php
文件中取消对App\Providers\BroadcastServiceProvider::class,
行的注释。 -
Laravel 验证:要确保已经设置了身份验证,未设置的话可以使用命令
php artisan make:auth
。 -
安装 Mercurius:通过命令
composer require launcher/mercurius
安装包。 -
配置(可选):通过
php artisan vendor:publish --tag=mercurius-config
指令发布配置文件,并在/config/mercurius.php
中进行定制。 -
进一步安装:执行命令
php artisan mercurius:install
和composer dump-autoload
完成安装。 -
用户特性:在
User
模型中添加Launcher\Mercurius\MercuriusUser
特性。 -
安装模拟数据:通过
php artisan db:seed --class=MercuriusDatabaseSeeder
添加测试用户和消息。
定制和支持
Mercurius 提供了详尽的定制指南,更多信息可参见 Customization 文档。如果有任何问题或者需要支持,可以在 issue 页面创建新的问题,或者加入我们的 Slack 频道。
开发与贡献
欢迎用户参与 Mercurius 的开发与改进,详情请参见 CONTRIBUTING 文档。
更新日志与版权
Mercurius 的变更信息记录在 CHANGELOG 中,项目由 Bruno Torrinha 创建,并遵循 MIT License 协议开源。
通过上述的介绍和指南,希望大家对 Mercurius 项目有一个全面的了解,并能够轻松地在自己的项目中实现实时通讯功能。