action_cable.md

ActionCable Delivery Method

Sends a notification to the browser via websockets (ActionCable channel by default).

deliver_by :action_cable do |config|
  config.channel = "Noticed::NotificationChannel"
  config.stream = ->{ recipient }
  config.message = ->{ params.merge( user_id: recipient.id) }
end

Options

• message

  Should return a Hash to be sent as the ActionCable message

• channel

  Override the ActionCable channel used to send notifications. Defaults to Noticed::NotificationChannel

• stream

  Should return the stream the message is broadcasted to. Defaults to recipient

Authentication

To send notifications to individual users, you'll want to use stream_for current_user. This requires identified_by :current_user in your ApplicationCable::Connection. For example, using Devise for authentication:

module ApplicationCable
  class Connection < ActionCable::Connection::Base
    identified_by :current_user

    def connect
      self.current_user = find_verified_user
      logger.add_tags "ActionCable", "User #{current_user.id}"
    end

    protected

      def find_verified_user
        if current_user = env['warden'].user
          current_user
        else
          reject_unauthorized_connection
        end
      end
  end
end