composer-plugin messages-manager

ousamox/messages-manager

The package provides an easy way to implementing a messages manager into your laravel project

MessagesManager

This package support only Laravel 5.x versions, _(*1)

Installation

Add MessagesManager package to your composer.json file to require it :, _(*2)

    require : {
        "laravel/framework": xxxx,
        ...
        "ousamox/messages-manager": "master"
    }

Update Composer :, _(*3)

$ composer update

The next required step is to add the service provider to config/app.php :, _(*4)

    'providers' => array(
        ...
        'Ousamox\MessagesManager\Providers\MessagesManagerProvider'
    )

Alias the PushNotification facade by adding it to the aliases array in the config/app.php file :, _(*5)

    'aliases' => array(
        ...
        'OMessage' => 'Ousamox\MessagesManager\Facades\OMessage'
    )

Configuration

Publish Files

Publish OMM config and migration files in your application with :, _(*6)

$ php artisan vendor:publish --tag=omm

This will generate a config file in config/omm.php like this :, _(*7)

return [
    'models' => [
        'channel' => [
            'table_name' => 'OMM_CHANNELS',
            'class' => \Ousamox\MessagesManager\Models\Channel::class,
        ],
        'device' => [
            'table_name' => 'OMM_DEVICES',
            'class' => \Ousamox\MessagesManager\Models\Device::class,
        ],
        'message' => [
            'table_name' => 'OMM_MESSAGES',
            'class' => \Ousamox\MessagesManager\Models\Message::class,
        ],
        'message_seen' => [
            'table_name' => 'OMM_MESSAGE_SEENS',
            'class' => \Ousamox\MessagesManager\Models\MessageSeen::class,
        ],
        'message_file' => [
            'table_name' => 'OMM_MESSAGE_FILES',
            'class' => \Ousamox\MessagesManager\Models\MessageFile::class,
        ],
        'session' => [
            'table_name' => 'OMM_SESSIONS',
            'class' => \Ousamox\MessagesManager\Models\Session::class,
        ],
        'user' => [
            'table_name' => 'OMM_USERS',
            'class' => \Ousamox\MessagesManager\Models\User::class,
        ],
    ],
    'channels_duplication' => env('OMM_CHANNELS_DUPLICATION',false),
];

This will generate also a migration file in database/migrations contains all tables that we must have in our database., _(*8)

Configure files

We can customise the name of our tables by editing the models.<entity>.table_name value in config/omm.php, _(*9)

We can alse customise the main model class for each entity by editing the models.<entity>.class value in config/omm.php :, _(*10)

Example :, _(*11)

config/omm.php :, _(*12)

return [
    'models' => [
        'channel' => [
            'table_name' => 'app_channels',
            'class' => App\Models\Channel::class,
        ],
        ...

app/models/Channel.php :, _(*13)

namespace App\Models;

use Ousamox\MessagesManager\Models\Channel as BaseChannel;

class Channel extends BaseChannel
{
    // Add or Override the main behavior of this class without touching its defined properties or attributes
    ...
}

The last step is generating tables by running this command :, _(*14)

$ php artisan migrate

Congratulations, you have successfully installed MessagesManager in your project !, _(*15)

Usage

1- Authentification is required when using these methods, _(*16)

2- Pagination must be available on the next release, _(*17)

Get All Channels (conversations)

To get the list of channels :, _(*18)

$channels = \OMessage::getChannels();

Get Messages by channel (conversation)

To get the list of channels :, _(*19)

// $value must be an integer (channel ID) or a Channel Object
$messages = \OMessage::getMessagesByChannel($value);

Send Message

Send First Message in new channel, _(*20)

$messages = \OMessage::sendMessageNewChannel($messageData: array, $channelData: array $toUsers: array, $files = []);

Parameters :, _(*21)

[
   'content' => 'Hello World', // REQUIRED
   'sent_from_lat' => 3.993843, // OPTIONAL (MAPS Latituude)
   'sent_from_long' => 23.222843, // OPTIONAL (MAPS Longitude)
   ... // Other attributes added in entity : message
]

[
   'subject' => 'New Channel', // OPTIONAL
   .. // Other attributes added in entity : channel 
]

Send Message in existing channel, _(*22)

$messages = \OMessage::sendMessageExistingChannel($messageData: array, $channel: ChannelModel|int, $files = []);

Parameters :, _(*23)

[
   'content' => 'Hello World', // REQUIRED
   'sent_from_lat' => 3.993843, // OPTIONAL (MAPS Latituude)
   'sent_from_long' => 23.222843, // OPTIONAL (MAPS Longitude)
   ... // Other attributes added in entity : message
]

Add users to an existing channel, _(*24)

Only channel creator could attach users to it, _(*25)

$messages = \OMessage::addUsersToChannel($channel: ChannelModel|int, $users: array);

Parameters :, _(*26)