rtippin/messenger-ui

Laravel messenger suite UI.

Fund package maintenance!
RTippin

Installs: 2 998

Dependents: 1

Suggesters: 0

Security: 0

Stars: 14

Watchers: 2

Forks: 14

Open Issues: 0

Language:JavaScript

v2.7.2 2023-07-06 01:02 UTC

README

Latest Version on Packagist Total Downloads StyleCI License

Preview

Ready-made UI and web routes for use with rtippin/messenger

Notes

  • This package provides web routes and a published UI to consume messenger's API. No authentication routes/system will be setup for you.
  • Our compiled NotifyManager.js uses laravel echo, with the pusher-js library.
  • For websockets, this package supports pusher.com directly, or the drop-in replacement laravel-websockets.
    • Instructions are located below for setting up the websocket implementation of your choosing.
  • After publishing our views, you may wish to edit them to fit your needs.
  • Future versions planned will be crafted in react.

Installation

Via Composer

composer require rtippin/messenger-ui

Publish Assets and Config

  • This will publish our JS assets, images, views, and config.
php artisan messenger:ui:publish
  • When using composer to update this package, we recommend republishing our JS/CSS assets:
php artisan vendor:publish --tag=messenger-ui.assets --force

Config

Default:

'site_name' => env('MESSENGER_SITE_NAME', 'Messenger'),

'websocket' => [
    'pusher' => env('MESSENGER_SOCKET_PUSHER', false),
    'host' => env('MESSENGER_SOCKET_HOST', 'localhost'),
    'auth_endpoint' => env('MESSENGER_SOCKET_AUTH_ENDPOINT', '/api/broadcasting/auth'),
    'key' => env('MESSENGER_SOCKET_KEY'),
    'port' => env('MESSENGER_SOCKET_PORT', 6001),
    'use_tsl' => env('MESSENGER_SOCKET_TLS', false),
    'cluster' => env('MESSENGER_SOCKET_CLUSTER'),
],

'routing' => [
    'domain' => null,
    'prefix' => 'messenger',
    'middleware' => ['web', 'auth', 'messenger.provider'],
    'invite_middleware' => ['web', 'messenger.provider'],
],
  • site_name is used in our views to inject the name in the navbar.
  • websocket:
    • When using the real pusher.com, you need to set pusher to true, add in your cluster, and your key.
    • When using laravel-websockets, you leave pusher to false, ignore cluster, and set your host, port, and key.
    • The auth_endpoint is for your laravel's backend to authorize access to our messenger channels. The default messenger.php config prefixes the channel routes with api, hence our default config above uses /api/broadcasting/auth when not set.
  • routing you may choose your desired endpoint domain, prefix and middleware.
    • Invite join web route you can define separate middleware from the rest of the web routes, as you may want a guest allowed to view that page.
    • The default messenger.provider middleware is included with messenger and simply sets the active messenger provider by grabbing the authenticated user from $request->user().

Using Pusher

  • After you have your pusher credentials ready, you should install the pusher SDK:
composer require pusher/pusher-php-server
  • Once installed, set your .env variables:

Default broadcasting.php config

'pusher' => [
    'driver' => 'pusher',
    'key' => env('PUSHER_APP_KEY'),
    'secret' => env('PUSHER_APP_SECRET'),
    'app_id' => env('PUSHER_APP_ID'),
    'options' => [
        'cluster' => env('PUSHER_APP_CLUSTER'),
        'useTLS' => false,
    ],
], 

.env keys for both pusher and our UI

BROADCAST_DRIVER=pusher
PUSHER_APP_ID=YourPusherId
PUSHER_APP_KEY=YourPusherKey
PUSHER_APP_SECRET=YourPusherSecret
PUSHER_APP_CLUSTER=YourPusherCluster
MESSENGER_SOCKET_PUSHER=true
MESSENGER_SOCKET_KEY="${PUSHER_APP_KEY}"
MESSENGER_SOCKET_CLUSTER="${PUSHER_APP_CLUSTER}"
  • You are all set! Our UI will connect to your pusher account. Be sure to enable client events within your pusher account if you want our client to client events enabled.

Using laravel-websockets

  • First, you need to have installed the websocket package (This package has been tested using laravel-websockets v1.12).
  • Ideally, you should follow the official Installation Documentation from beyondcode if you are doing a fresh installation.
composer require beyondcode/laravel-websockets "^1.12"
  • Once you have installed and configured the websocket package, set your .env variables and update the default pusher config:

Updated broadcasting.php config per beyondcode's documentation

'pusher' => [
    'driver' => 'pusher',
    'key' => env('PUSHER_APP_KEY'),
    'secret' => env('PUSHER_APP_SECRET'),
    'app_id' => env('PUSHER_APP_ID'),
    'options' => [
        'cluster' => env('PUSHER_APP_CLUSTER'),
        'encrypted' => true,
        'host' => 'localhost',
        'port' => 6001,
        'scheme' => 'http'
    ],
],

.env keys for both laravel-websockets and our UI

BROADCAST_DRIVER=pusher
PUSHER_APP_ID=MakeYourID
PUSHER_APP_KEY=MakeYourKey
PUSHER_APP_SECRET=MakeYourSecret
MESSENGER_SOCKET_HOST=localhost
MESSENGER_SOCKET_KEY="${PUSHER_APP_KEY}"
  • You are all set! Our UI will connect to your server running php artisan websockets:serve. Be sure to enable client events in your laravel-websockets config if you want our client to client events enabled.