Adds Laravel Echo with your broadcast configuration to your Laravel Nova app.
By using Nova Echo, we have a readily configured Laravel Echo instance in our JS.
Here are suggested options for broadcasting/receiving using websockets:
You can find instructions about setting up broadcasting in Laravel using the official documentation.
Once you have this set up in your Nova app, you can install this package via composer
composer require coreproc/nova-echoYou will then need to override Nova's layout.blade.php. Create a layout file resources/views/vendor/nova/layout.blade.php and copy the contents from vendor/laravel/nova/resources/views/layout.blade.php.
Include Nova Echo's blade file in the Nova layout. This blade file contains meta tags with your broadcast configuration.
// file: resources/views/vendor/nova/layout.blade.php
<!DOCTYPE html>
<html lang="en" class="h-full font-sans antialiased">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=1280">
<meta name="csrf-token" content="{{ csrf_token() }}">
@include('nova-echo::meta') <!-- Include this line -->
<title>
...
Nova Echo instantiates Echo and makes it available throughout your Nova app. You can access your Echo object through
window.EchoBy default, this Echo instance already subscribes to the logged in user's private channel, which by default would be the namespace of your app's user object, ie. App.User.{id}.
You can access and attach listeners to this user's private channel through
window.userPrivateChannelTo authenticate the user through this channel, make sure you have your BroadcastServiceProvider available with Broadcast::routes() declared. You'll also need to define access through your route/channels.php file, ie:
// file: routes/channels.php
Broadcast::channel('App.User.{id}', function ($user, $id) {
return (int)$user->id === (int)$id;
});You can override the receivesBroadcastNotificationsOn to use a different channel name.
class User extends Authenticatable
{
use Notifiable;
...
/**
* The channels the user receives notification broadcasts on.
*
* @return string
*/
public function receivesBroadcastNotificationsOn()
{
return 'users.' . $this->id;
}
}Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email chris.bautista@coreproc.ph instead of using the issue tracker.
CoreProc is a software development company that provides software development services to startups, digital/ad agencies, and enterprises.
Learn more about us on our website.
The MIT License (MIT). Please see License File for more information.