liliom/laravel-firebase

Laravel FCM (Firebase Cloud Messaging) Notification Channel

laravel-firebase

This package makes it easy to send notifications using Firebase Cloud Messaging (FCM) with Laravel Notification Channel., _(*1)

Installation

This package can be installed through Composer., _(*2)

``` bash composer require liliom/laravel-firebase, <sub>(*3)</sub>

If you don't use Laravel 5.5+ you have to add the service provider manually

```php
// config/app.php
'providers' => [
    ...
    Liliom\Firebase\FirebaseServiceProvider::class,
    ...
];

Now add you Firebase API Key in config/services.php., <sub>(*4)</sub>

return [
    ....
    'firebase' => [
        'key' => ''
    ],
    ....
];

Usage

Les's create a notification using artisan commend:, <sub>(*5)</sub>

php artisan make:notification FirebaseNotification

Now you can use firebase channel in your vie() mothod., <sub>(*6)</sub>

public function via($notifiable)
{
    return ['firebase'];
}

Add a pubilc method toFirebase($notifiable) to your notification class, and return an instance of FirebaseMessage:, <sub>(*7)</sub>

public function toFirebase($notifiable)
{
    return (new \Liliom\Firebase\FirebaseMessage)
        ->notification([
            'title' => 'Notification title',
            'body' => 'Notification body',
            'sound' => '', // Optional
        'icon' => '', // Optional
        'click_action' => '' // Optional
        ])
        ->setData([
        'param' => 'zxy' // Optional
    ])
    ->setPriority('high'); // Default is 'normal'
}

Available methods:

• setData: To Set data.
• setPriority: To Set priority.
• setTimeToLive: To Set time_to_live.
• setCollapseKey: To Set collapse_key.
• setNotification: To Set notification.
• setCondition: To Set condition.
• setContentAvailable: To Set content_available.
• setMutableContent: To Set mutable_content.
• setPackageName: To Set restricted_package_name.

When sending to specific device(s), make sure your notifiable entity has routeNotificationForFirebase method defined:, <sub>(*8)</sub>

Note: You can send to many devices by return an array of tokens., <sub>(*9)</sub>

/**
 * Route notifications for Firebase channel.
 *
 * @return string|array
 */
public function routeNotificationForFirebase()
{
    return $this->device_tokens;
}

License

The MIT License (MIT). Please see License File for more information., <sub>(*10)</sub>