| Package Data | |
|---|---|
| Maintainer Username: | musonza |
| Maintainer Contact: | tashtin263@gmail.com (Tinashe Musonza) |
| Package Create Date: | 2016-03-18 |
| Package Last Update: | 2024-07-16 |
| Home Page: | |
| Language: | PHP |
| License: | MIT |
| Last Refreshed: | 2024-11-09 15:00:46 |
| Package Statistics | |
|---|---|
| Total Downloads: | 185,211 |
| Monthly Downloads: | 4,532 |
| Daily Downloads: | 120 |
| Total Stars: | 1,134 |
| Total Watchers: | 36 |
| Total Forks: | 311 |
| Total Open Issues: | 58 |
This package allows you to add a chat system to your Laravel ^5.4 application
From the command line, run:
composer require musonza/chat
Add the service provider to your config\app.php the providers array
Musonza\Chat\ChatServiceProvider::class
Add the Facade to your aliases:
'Chat' => Musonza\Chat\Facades\ChatFacade::class to your `config\app.php`
The class is bound to the ioC as chat
$chat = App::make('chat');
Publish the assets:
php artisan vendor:publish
This will publish database migrations and a configuration file musonza_chat.php in the Laravel config folder.
return [
'user_model' => 'App\User',
/**
* If not set, the package will use getKeyName() on the user_model specified above
*/
'user_model_primary_key' => null,
/*
* This will allow you to broadcast an event when a message is sent
* Example:
* Channel: mc-chat-conversation.2,
* Event: Musonza\Chat\Eventing\MessageWasSent
*/
'broadcasts' => false,
/**
* The event to fire when a message is sent
* See Musonza\Chat\Eventing\MessageWasSent if you want to customize.
*/
'sent_message_event' => 'Musonza\Chat\Eventing\MessageWasSent',
/**
* Automatically convert conversations with more than two users to public
*/
'make_three_or_more_users_public' => true,
];
Run the migrations:
php artisan migrate
By default the package assumes you have a User model in the App namespace.
However, you can update the user model in musonza_chat.php published in the config folder.
$participants = [$userId, $userId2,...];
$conversation = Chat::createConversation($participants);
$participants = [$userId, $userId2,...];
// Create a private conversation
$conversation = Chat::createConversation($participants)->makePrivate();
// Create a public conversation
$conversation = Chat::createConversation($participants)->makePrivate(false);
$conversation = Chat::conversations()->getById($id);
$data = ['title' => 'PHP Channel', 'description' => 'PHP Channel Description'];
$conversation->update(['data' => $data]);
$message = Chat::message('Hello')
->from($user)
->to($conversation)
->send();
The default message type is text. If you want to specify custom type you can call the type() function as below:
$message = Chat::message('http://example.com/img')
->type('image')
->from($user)
->to($conversation)
->send();
$message = Chat::messages()->getById($id);
Chat::message($message)->setUser($user)->markRead();
Chat::message($message)->setUser($user)->toggleFlag();
Chat::message($message)->setUser($user)->flagged(); // true
Chat::conversation($conversation)->setUser($user)->readAll();
$unreadCount = Chat::messages()->setUser($user)->unreadCount();
Chat::conversation($conversation)->setUser($user)->unreadCount();
Chat::message($message)->setUser($user)->delete();
Chat::conversation($conversation)->setUser($user)->clear();
$conversation = Chat::conversations()->between($user1, $user2);
$conversations = Chat::conversations()->common($users);
$users can be an array of user ids ex. [1,4,6] or a collection (\Illuminate\Database\Eloquent\Collection) of users
/* removing one user */
Chat::conversation($conversation)->removeParticipants($user);
/* removing multiple users */
Chat::conversation($conversation)->removeParticipants([$user1, $user2, $user3,...,$userN]);
/* add one user */
Chat::conversation($conversation)->addParticipants($user);
/* add multiple users */
Chat::conversation($conversation)->addParticipants([$user3, $user4]);
Note: By default, a third user will classify the conversation as not private if it was. See config on how to change this.
Chat::conversation($conversation)->setUser($user)->getMessages()
// private conversations
$conversations = Chat::conversations()->setUser($user)->isPrivate()->get();
// public conversations
$conversations = Chat::conversations()->setUser($user)->isPrivate(false)->get();
// all conversations
$conversations = Chat::conversations()->setUser($user)->get();
$messages = Chat::conversations()->setUser($user)->limit(25)->page(1)->get();
Example
[
"id" => 1
"private" => "1"
"data" => []
"created_at" => "2018-06-02 21:35:52"
"updated_at" => "2018-06-02 21:35:52"
"last_message" => array:13 [
"id" => 2
"message_id" => "2"
"conversation_id" => "1"
"user_id" => "1"
"is_seen" => "1"
"is_sender" => "1"
"flagged" => false
"created_at" => "2018-06-02 21:35:52"
"updated_at" => "2018-06-02 21:35:52"
"deleted_at" => null
"body" => "Hello 2"
"type" => "text"
"sender" => array:7 [
"id" => 1
"name" => "Jalyn Ernser"
"email" => "colt.howell@example.com"
]
]
]
There are a few ways you can achieve pagination
You can specify the limit and page as above using the respective functions or as below:
$paginated = Chat::conversations()->setUser($user)
->setPaginationParams([
'page' => 3,
'perPage' => 10,
'sorting' => "desc",
'columns' => [
'*'
],
'pageName' => 'test'
])
->get();
You don't have to specify all the parameters. If you leave the parameters out, default values will be used.
$paginated above will return Illuminate\Pagination\LengthAwarePaginator
To get the conversations simply call $paginated->items()
$users = $conversation->users;
Chat is open-sourced software licensed under the MIT license