bizly/messenger

Simple user messaging tool for Laravel

, _(*1)

Laravel Messenger

This package will allow you to add a full user messaging system into your Laravel application., _(*2)

Leave some feedback

How are you using laravel-messenger?, _(*3)

Features

• Multiple conversations per user
• Optionally loop in additional users with each new message
• View the last message for each thread available
• Returns either all messages in the system, all messages associated to the user, or all message associated to the user with new/unread messages
• Return the users unread message count easily
• Very flexible usage so you can implement your own acess control

Common uses

• Open threads (everyone can see everything)
• Group messaging (only participants can see their threads)
• One to one messaging (private or direct thread)

Installation (Laravel 4.x)

Installation instructions for Laravel 4 can be found here., _(*4)

Installation (Laravel 5.x)

In composer.json:, _(*5)

"require": {
    "cmgmyr/messenger": "~2.0"
}

Run:, _(*6)

composer update

Add the service provider to config/app.php under providers:, _(*7)

'providers' => [
    Cmgmyr\Messenger\MessengerServiceProvider::class,
]

Publish config:, _(*8)

php artisan vendor:publish --provider="Cmgmyr\Messenger\MessengerServiceProvider" --tag="config"

Update config file to reference your User Model:, _(*9)

config/messenger.php

Create a users table if you do not have one already. If you need one, simply use this example as a starting point, then migrate., _(*10)

(Optional) Define names of database tables in package config file if you don't want to use default ones:, _(*11)

'messages_table' => 'messenger_messages',
'participants_table' => 'messenger_participants',
'threads_table' => 'messenger_threads',

Publish migrations:, _(*12)

php artisan vendor:publish --provider="Cmgmyr\Messenger\MessengerServiceProvider" --tag="migrations"

Migrate your database:, _(*13)

php artisan migrate

Add the trait to your user model:, _(*14)

use Cmgmyr\Messenger\Traits\Messagable;

class User extends Model {
    use Messagable;
}

Examples

• Controller
• Routes
• Views

Note: These examples use the laravelcollective/html package that is no longer included in Laravel 5 out of the box. Make sure you require this dependency in your composer.json file if you intend to use the example files., _(*15)

Example Projects

• [WIP] Pusher
• [WIP] Lumen API

Contributing?

Please format your code before creating a pull-request. This will format all files as specified in .php_cs:, _(*16)

vendor/bin/php-cs-fixer fix .

Security

If you discover any security related issues, please email Chris Gmyr instead of using the issue tracker., _(*17)

Credits

• Chris Gmyr
• All Contributors

Special Thanks

This package used AndreasHeiberg/laravel-messenger as a starting point., _(*18)