yakimka/laravel-notification-channel-turbosms

Turbo SMS Notification channel for Laravel 5.3+.

v2.0.1 2021-08-31 18:58 UTC

Requires

• php: >=7.2
• ext-soap: *
• illuminate/notifications: 5.1 - 5.8|^6.0|^7.0|^8.0
• illuminate/support: 5.1 - 5.8|^6.0|^7.0|^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.1
• mockery/mockery: ^1.3.1
• phpunit/phpunit: ^8.5

MIT

• yakimka
• JhaoDa

• notifications
• laravel
• turbosms

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', '[phone]')->notify(new AccountApproved());

or with multiple receivers:

Notification::route('turbosms', '[phone],[phone]')->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 [e-mail] 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.