betoalien / chatify-esp
为Laravel PHP框架提供的西班牙语包,用于添加完整的实时聊天系统。
Requires
- pusher/pusher-php-server: ^3.4@dev
This package is auto-updated.
Last update: 2024-09-26 11:33:51 UTC
README
Chatify Laravel 包 西班牙语版本
这是一个Laravel包,通过一条命令行即可将完整的实时聊天系统添加到您的应用程序中。
要求
- PHP >=5.3.2。
- Laravel >=5.4
- Pusher Api账户。
功能
- 用户/群组(即将推出)聊天系统。
- 实时联系人列表更新。
- 收藏联系人列表(类似故事风格)和添加到收藏按钮。
- 保存消息到在线保存您的消息,如Telegram消息应用。
- 搜索功能。
- 联系人项的最后一条消息指示器(例如:您: ....)。
- 实时用户的活跃状态。
- 实时输入指示器。
- 实时已读消息指示器。
- 实时网络连接状态。
- 上传附件(照片/文件)。
- 共享照片,删除对话等(用户信息右侧)。
- 响应式设计,适用于所有设备。
- 用户设置和聊天定制:用户个人照片、暗黑模式聊天颜色,以及简洁而美观的UI设计。
演示
安装
YouTube上的视频教程 - 点击此处
或者
按照以下步骤操作
1. 在您的Laravel应用程序中安装包
快速提示:如果您在一个新项目中安装此包,请确保安装了Laravel提供的默认用户认证系统Laravel。
$ composer require munafio/chatify
2. Pusher Api设置
此包使用Pusher Api,因此您需要
- 创建账户并使用您的API凭证修改Laravel应用程序的
.env文件。 - 此包使用Pusher客户端事件,并且客户端事件必须在应用程序中启用。您可以在Channels仪表板中的应用程序的
设置标签中完成此操作。
阅读有关Pusher '触发客户端事件'的更多信息
3. 发布资产
要发布的包资产
重要资产
- config
- assets
- migrations
以及可选资产
- controllers
- views
要发布资产,请使用以下命令行,并更改标签值(即,在--tag=后写入chatify- + 如上所述的资产名称)。
示例
$ php artisan vendor:publish --tag=chatify-config
- 注意:发布资产意味着(例如,config)将包的配置文件复制到您的Laravel应用程序的
config文件夹中,以及其他资产(包的视图、控制器、迁移等)。
4. 迁移
迁移之前步骤中添加的新migrations
$ php artisan migrate
5. 存储符号链接
在public文件夹中创建对storage文件夹的快捷方式或符号链接
$ php artisan storage:link
6. 应用程序配置
对于不支持包自动发现的Laravel <=v5.4,将以下提供程序添加到config/app.php提供者数组列表中
... /* * Package Service Providers... */ \Chatify\ChatifyServiceProvider::class, ...
并将以下别名添加到config/app.php别名中
... /* * Class Aliases */ 'Chatify' => Chatify\Facades\ChatifyMessenger::class, ...
- 安装包后,您可以通过默认路径(路由路径)访问消息传递器,该路径是
/chatify,您可以在配置文件config/chatify.php中更改路径名称,如下所述的配置中。
就是这样 .. 享受吧:)
配置
您可以在安装步骤第2步发布的 config/chatify.php 文件中找到并修改包的默认配置。所有配置都有良好的文档说明,以便其他开发者理解。
- 所有包的文件都有文档说明,以便理解整个代码。
信使名称
此值是应用在视图或其他应用位置使用的应用名称。
... 'name' => env('CHATIFY_NAME', 'Chatify Messenger'), ...
应用中的信使路径
此值是包的路径,或者说,它是该包中所有已注册路由的前缀。
例如(yourapp.domain/chatify)
... 'path' => env('CHATIFY_PATH', 'chatify'), ...
包的Web路由中间件
此值是该包中所有已注册路由的中间件,默认为:auth。
... 'middleware' => env('CHATIFY_MIDDLEWARE', 'auth'), ...
Pusher API凭证
您不需要在此处修改Pusher的凭证,因为您已经在Laravel应用的.env文件中添加了凭证。
用户头像
这是用户的头像设置,包括
... 'user_avatar' => [ 'folder' => 'users-avatar', ... ], ...
这是上传和获取用户头像的默认文件夹名称。
... 'user_avatar' => [ ... 'default' => 'avatar.png', ], ...
这是数据库中存储用户的默认头像文件名。当您发布assets时,头像照片的副本将被复制到您的存储路径。
默认附件
此数组包含在此包中使用的重要默认值
... 'attachments' => [ 'folder' => 'attachments', ... ], ...
这是存储中attachments的默认文件夹名称,其中所有附件都将存储在此,也将在视图中的附件URL中使用。
... 'attachments' => [ ... 'route' => 'attachments.download', ], ...
这是下载附件方法的路由名称。