README

Adds Laravel Echo with your broadcast configuration to your Laravel Nova app.

Installation

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-echo

You 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>
  ...

Usage

Nova Echo instantiates Echo and makes it available throughout your Nova app. You can access your Echo object through

window.Echo

By 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.userPrivateChannel

To 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;
    }
}

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email chris.bautista@coreproc.ph instead of using the issue tracker.

Credits

Chris Bautista

About CoreProc

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.

License

The MIT License (MIT). Please see License File for more information.

coreproc / nova-echo

Maintainers

Details