laravel-notification-channels / pusher-push-notifications by laravel-notification-channels

Pusher native Push Notifications driver.

464,832

272

Package Data
Maintainer Username:	laravel-notification-channels
Maintainer Contact:	themsaid@gmail.com (Mohamed Said)
Package Create Date:	2016-08-10
Package Last Update:	2024-03-14
Home Page:	http://laravel-notification-channels.com
Language:	PHP
License:	MIT
Last Refreshed:	2024-11-19 03:25:34

Package Statistics
Total Downloads:	464,832
Monthly Downloads:	17,011
Daily Downloads:	712
Total Stars:	272
Total Watchers:	13
Total Forks:	67
Total Open Issues:	6

Pusher push notifications channel for Laravel 5.3

This package makes it easy to send Pusher push notifications with Laravel 5.3.

Installation

You can install the package via composer:

composer require laravel-notification-channels/pusher-push-notifications

You must install the service provider:

// config/app.php
'providers' => [
    ...
    NotificationChannels\PusherPushNotifications\PusherPushNotificationsServiceProvider::class,
],

Setting up your Pusher account

Before using this package you should set up a Pusher account. Here are the steps required.

Login to https://dashboard.pusher.com/
Select your app from the sidebar or create a new app.
Click on the "Push Notifications" tab.
Upload your APNS Certificate or add your GCM API key.
Now select the "App Keys" tab.
Copy your app_id, key, and secret.
Update the values in your config/broadcasting.php file under the pusher connection.
You're now good to go.

Usage

Now you can use the channel in your via() method inside the Notification class.

use NotificationChannels\PusherPushNotifications\PusherChannel;
use NotificationChannels\PusherPushNotifications\PusherMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [PusherChannel::class];
    }

    public function toPushNotification($notifiable)
    {
        return PusherMessage::create()
            ->iOS()
            ->badge(1)
            ->sound('success')
            ->body("Your {$notifiable->service} account was approved!");
    }
}

Available Message methods

platform(''): Accepts a string value of iOS or Android.
iOS(): Sets the platform value to iOS.
android(): Sets the platform value to Android.
title(''): Accepts a string value for the title.
body(''): Accepts a string value for the body.
sound(''): Accepts a string value for the notification sound file. Notice that if you leave blank the default sound value will be default.
icon(''): Accepts a string value for the icon file. (Android Only)
badge(1): Accepts an integer value for the badge. (iOS Only)
setOption($key, $value): Allows you to set any value in the message payload. For more information check here for iOS, or here for Android.

Sending to multiple platforms

You can send a single message to an iOS device and an Android device at the same time using the withiOS() and withAndroid() method:

public function toPushNotification($notifiable)
{
    $message = "Your {$notifiable->service} account was approved!";

    return PusherMessage::create()
        ->iOS()
        ->badge(1)
        ->body($message)
        ->withAndroid(
            PusherMessage::create()
                ->title($message)
                ->icon('icon')
        );
}

Notice that iOS is the default platform, which means you don't have to call ->iOS().

When using withAndroid() or withiOS() you don't have to define the platform, it's done behind the scenes for you.

Routing a message

By default the pusher "interest" messages will be sent to will be defined using the {notifiable}.{id} convention, for example App.User.1, however you can change this behaviour by including a routeNotificationForPusherPushNotifications() in the notifiable class method that returns the interest name.

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email themsaid@gmail.com instead of using the issue tracker.