Download the PHP package srlabs/parley without Composer

Parley: Polymorphic Messaging for Laravel Applications

With Parley you can easily send messages between different object types within a Laravel application. These "conversations" can be bi-directional, allowing for easy communication with your users about topics relevant to your application.

• Associate threads with reference objects, such as orders or any other eloquent model instance
• Keep track of which members have or haven't "read" the messages
• Optionally mark threads as "open" or "closed"

Here is an example:

When a player logs in, their unread Parley messages can be retrieved like so:

If this user wants to reply to a message, it can be done like this:

Additional usage examples and the API can be found here.

Installation

This package can be installed using composer:

Add the Service Provider and Alias to your file:

Next, publish and run the migrations

Any Eloquent Model that implements the can be used to send or receive Parley messages. To fulfill that contract, you need to have and methods available on that model:

• • Specify the "display name" for the model participating in a Parley Conversation. For users this could be their username, or their first and last names combined.
• • Specify the integer id you want to have represent this model in the Parley database tables. It is most likely that you will want to use the model's attribute here, but that is not always the case.

NB: While you are required to provide an alias for each Parleyable Model, You are not required to use that alias when creating threads - you can optionally specify a different "alias" attribute when creating messages.

You are now ready to go!

Events

Whenever a new thread is created, or a new reply message is added, an event is fired. You can set up your listeners in your EventServiceProvider like so:

Each event is passed the Thread object and the author of the current message. You can retrieve these objects using the and methods: