Looking to hire Laravel developers? Try LaraJobs

laravel-notifications-plivo maintained by mateusjatenee

Description
Plivo SMS notifications driver for Laravel
Author
Last update
2020/03/02 00:38 (dev-master)
License
Downloads
793

Comments
comments powered by Disqus

Plivo notifications channel for Laravel 5.6

This is a fork of laravel-notification-channels/plivo with added support to 5.6

Latest Version on Packagist Software License Build Status StyleCI SensioLabsInsight Quality Score Code Coverage Total Downloads

This package makes it easy to send SMS notifications using Plivo with Laravel 5.6.

Contents

Installation

You can install this package via composer: composer require mateusjatenee/laravel-notifications-plivo

Add the service provider to config/app.php:

// config/app.php
'providers' => [
    ...
    Mateusjatenee\Plivo\PlivoServiceProvider::class,
],

Setting up your Plivo service

Log in to your Plivo dashboard and grab your Auth Id, Auth Token and the phone number you're sending from. Add them to config/services.php.

// config/services.php
...
'plivo' => [
    'auth_id' => env('PLIVO_AUTH_ID'),
    'auth_token' => env('PLIVO_AUTH_TOKEN'),
    // Country code, area code and number without symbols or spaces
    'from_number' => env('PLIVO_FROM_NUMBER'),
    // The url Plivo will request to notify about changing sms statuses
    'webhook' => ''
],

Usage

Follow Laravel's documentation to add the channel your Notification class:

use Illuminate\Notifications\Notification;
use NotificationChannels\Plivo\PlivoChannel;
use NotificationChannels\Plivo\PlivoMessage;

public function via($notifiable)
{
    return [PlivoChannel::class];
}

public function toPlivo($notifiable)
{
    return (new PlivoMessage)
                    ->content('This is a test SMS via Plivo using Laravel Notifications!');
}

Add a routeNotificationForPlivo method to your Notifiable model to return the phone number:

public function routeNotificationForPlivo()
{
    // Country code, area code and number without symbols or spaces
    return preg_replace('/\D+/', '', $this->phone_number);
}

Available methods

  • content() - (string) SMS notification body
  • from() - (integer) Override default from number
  • webhook() - (string) Override the webhook in the config file

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email sid@koomai.net instead of using the issue tracker.

Contributing

Please see CONTRIBUTING for details.

Credits

License

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