Skip to content
No description or website provided.
PHP
Branch: master
Clone or download
Latest commit 7175f32 Oct 6, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
database/migrations transfer ownership to artisanry Jun 4, 2019
src transfer ownership to artisanry Jun 4, 2019
tests transfer ownership to artisanry Jun 4, 2019
.editorconfig editorconfig Aug 3, 2017
.gitattributes gitattributes Aug 3, 2017
.gitignore first Nov 4, 2016
.travis.yml update deps Jan 29, 2018
LICENSE MPL 2.0 Jun 9, 2019
README.md MPL 2.0 Jun 9, 2019
composer.json Laravel 6 Aug 28, 2019
phpunit.xml.dist first Nov 4, 2016
renovate.json Update renovate.json Oct 6, 2019

README.md

Laravel Messageable

Build Status PHP from Packagist Latest Version License

Installation

Require this package, with Composer, in the root directory of your project.

$ composer require artisanry/messageable

To get started, you'll need to publish the vendor assets and migrate:

php artisan vendor:publish --provider="Artisanry\Messagable\MessageableServiceProvider" && php artisan migrate

Usage

Setup a Model

<?php

namespace App;

use Artisanry\Messageable\HasMessages;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    use HasMessages;
}

Examples

Create a new thread

Thread::create([
    'subject' => str_random(10),
]);

Add one message to a thread

$thread->addMessage([
    'body' => str_random(10),
], $user);

Add multiple messages to a thread

$thread->addMessage([
    [
        'data' => ['body' => str_random(10)],
        'creator' => User::find(1),
    ],
    [
        'data' => ['body' => str_random(10)],
        'creator' => User::find(2),
    ],
], $user);

Add one participant to a thread

$thread->addParticipant($user);

Add multiple participants to a thread

$thread->addParticipants([
    User::find(3), Organization::find(2), Player::find(4)
]);

Mark a thread as ready by the user

$thread->markAsRead($user);

Get all threads

Thread::getAllLatest()->get();

Get all threads that a user has participated in

Thread::forModel($user)->latest('updated_at')->get();

Get all threads that a user has participated in with new messages

Thread::forModelWithNewMessages($user)->latest('updated_at')->get();

Get the creator of a thread

$thread->creator();

Get the latest message of a thread

$thread->getLatestMessage();

Get an array of participant IDs and Types

$thread->participantsIdsAndTypes();

Check if the User Model hasn't read the latest message in the thread yet

$thread->isUnread($user);

Check if the User Model participated to the Thread

$thread->hasParticipant($user);

Testing

$ phpunit

Security

If you discover a security vulnerability within this package, please send an e-mail to hello@basecode.sh. All security vulnerabilities will be promptly addressed.

Credits

This project exists thanks to all the people who contribute.

License

Mozilla Public License Version 2.0 (MPL-2.0).

You can’t perform that action at this time.