README

Turbo SMS notifications channel for Laravel 5.3+

Based on github.com/laravel-notification-channels/smsc-ru

This package made for send notifications using turbosms.ua (SOAP) with Laravel 5.3+

Contents

• Installation
  • Setting up the TurboSms service
• Usage
  • Available Message methods
• Changelog
• Security
• Contributing
• Credits
• License

Installation

Firstly you need working soap extension.

You can install the package via composer: composer require yakimka/laravel-notification-channel-turbosms

For Laravel < 5.5 you must install the service provider:

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

Setting up the TurboSms service

Add your TurboSms SOAP login, SOAP password and default sender name (or phone number) to your config/services.php:

// config/services.php
...
'turbosms' => [
    'login' => env('TURBOSMS_LOGIN'),
    'secret' => env('TURBOSMS_SECRET'),
    'sender' => 'BRAND',
    'url' => 'http://turbosms.in.ua/api/wsdl.html',
],
...

You need to publish Illuminate\Notifications\NotificationServiceProvider files first.

Usage

You can use the channel in your via() method inside the notification:

use Illuminate\Notifications\Notification;
use NotificationChannels\TurboSms\TurboSmsMessage;
use NotificationChannels\TurboSms\TurboSmsChannel;

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

    public function toTurboSms($notifiable)
    {
        return TurboSmsMessage::create("Task #{$notifiable->id} is complete!");
    }
}

In your notifiable model, make sure to include a routeNotificationForTurboSms() method, which return the phone number.

public function routeNotificationForTurboSms()
{
    return $this->phone;
}

or you can send notification in this way:

Notification::route('turbosms', '+380501234567')->notify(new AccountApproved());

or with multiple receivers:

Notification::route('turbosms', '+380501234567,+380631234567')->notify(new AccountApproved());

Available methods

from(): Sets the sender's name or phone number.

content(): Sets a content of the notification message.

Security

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

Contributing

Please see CONTRIBUTING for details.

Credits

• yakimka
• JhaoDa

License

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