Skip to content

nico6ka/laravel-push-notification

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Push Notification

Package to enable sending push notifications to devices

Installation

Update your composer.json file to include this package as a dependency

"davibennun/laravel-push-notification": "dev-master"

Register the PushNotification service provider by adding it to the providers array in the app/config/app.php file.

Davibennun\LaravelPushNotification\LaravelPushNotificationServiceProvider

Alias the PushNotification facade by adding it to the aliases array in the app/config/app.php file.

'aliases' => array(
    'PushNotification' => 'Davibennun\LaravelPushNotification\Facades\PushNotification'
)

Configuration

Copy the config file into your project by running

php artisan config:publish davibennun/laravel-push-notification

This will generate a config file like this

array(
    'appNameIOS'=>array(
        'environment'=>'development',
    	'certificate'=>'/path/to/certificate.pem',
    	'passPhrase'=>'password',
    	'service'=>'apns'
    ),
    'appNameAndroid'=>array(
    	'environment'=>'production',
    	'apiKey'=>'yourAPIKey',
    	'service'=>'gcm'
    )
);

Where all first level keys corresponds to an service configuration, each service has its own properties, android for instance have apiKey and IOS uses certificate and passPhrase. You can set as many services configurations as you want, one for each app.

#####Dont forget to set service key to identify IOS 'service'=>'apns' and Android 'service'=>'gcm'

#####The certificate path must be an absolute path, so in the configuration file you can use these:

//Path to the 'app' folder
'certificate'=>app_path().'/myCert.pem'

Laravel functions are also available public_path() storage_path() base_path()

Usage

PushNotification::app('appNameIOS')
                ->to($deviceToken)
                ->send('Hello World, i`m a push message');

Where app argument appNameIOS refers to defined service in config file. To multiple devices and optioned message:

$devices = PushNotification::DeviceCollection(array(
    PushNotification::Device('token', array('badge' => 5)),
    PushNotification::Device('token1', array('badge' => 1)),
    PushNotification::Device('token2')
));
$message = PushNotification::Message('Message Text',array(
    'badge' => 1,
    'sound' => 'example.aiff',
    
    'actionLocKey' => 'Action button title!',
    'locKey' => 'localized key',
    'locArgs' => array(
        'localized args',
        'localized args',
        'localized args'
    ),
    'launchImage' => 'image.jpg',
    
    'custom' => array('custom data' => array(
        'we' => 'want', 'send to app'
    ))
));
PushNotification::app('appNameIOS')
                ->to($devices)
                ->send($message);

This package is wrapps Notification Package and adds some flavor to it.

####Usage advice This package should be used with Laravel Queues, so pushes dont blocks the user and are processed in the background, meaning a better flow.

About

Laravel package to enable sending push notifications to devices

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%