coreproc/laravel-notification-channel-globe-labs-sms

This package makes it easy to send notifications using Globe Labs SMS with Laravel 5.3, 5.4, and 5.5

Laravel Globe Labs SMS Notification Channel

, _(*1)

This package makes it easy to send notifications using Globe Labs SMS with Laravel 5.3 and above., _(*2)

Contents

• Installation
  • Setting up the GlobeLabsSms service
• Usage
• Security
• Contributing
• Credits
• License

Installation

Install this package with Composer:, _(*3)

composer require coreproc/laravel-notification-channel-globe-labs-sms

Register the ServiceProvider in your config/app.php (Skip this step if you are using Laravel 5.5 and above):, _(*4)

Coreproc\GlobeLabsSms\GlobeLabsSmsServiceProvider::class,

Setting up the Globe Labs Sms service

Start by creating a project here: http://www.globelabs.com.ph/#!/developer/api/sms, _(*5)

Please note that this package does not handle the opt-in steps required for a user to subscribe to your Globe Labs SMS application., _(*6)

This package assumes that you have the opt-in steps handled either via SMS or through a web form and that you already have access to the subscriber's access token., _(*7)

Once you've registered and set up your app, add the short code to your configuration in config/broadcasting.php, _(*8)

'connections' => [
    ....
    'globe_labs_sms' => [
        'short_code' => env('GLOBE_LABS_SMS_SHORT_CODE'),
    ],
    ...
]

Usage

Set a routeNotificationForGlobeLabsSms() method in your model/class with the Notifiable trait. For example:, _(*9)

class User extends Model
{
    use Notifiable;

    public function routeNotificationForGlobeLabsSms()
    {
        return [
            'access_token' => 'access-token-obtained-from-sms-opt-in-this-could-be-stored-in-your-database',
            'address' => '09171234567', // can be any format as long as it is a valid mobile number
        ];
    }
}

You can now send SMS via Globe Labs by creating an GlobeLabsSmsMessage in a Notification class:, _(*10)

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

    public function toGlobeLabsSms($notifiable) 
    {
        return GlobeLabsSmsMessage::create($notifiable)
            ->setMessage('This is a test message');
    }
}

Call the SMS notification by calling the notify() method in the model/class. For example:, _(*11)

$user = User::find(1);

$user->notify(new AccountActivated);

Security

If you discover any security related issues, please email chris.bautista@coreproc.ph instead of using the issue tracker., _(*12)

Contributing

Please see CONTRIBUTING for details., _(*13)

Credits

• Chris Bautista
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*14)