sbudah/panaceamobile

PanaceaMobile Notifications driver.

PanaceaMobile notifications channel for Laravel 5.3 [WIP]

, _(*1)

This package makes it easy to send notifications using PanaceaMobile with Laravel 5.3., _(*2)

Contents

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

Installation

You can install the package via composer:, _(*3)

composer require sbudah/panaceamobile

You must install the service provider:, _(*4)

// config/app.php
'providers' => [
    ...
    NotificationChannels\PanaceaMobile\PanaceaMobileServiceProvider::class,
];

Setting up the PanaceaMobile service

Create an account at Panacea Mobile and create an API token., _(*5)

Add your PanaceaMobile login, secret key (hashed password) and default sender name to your config/services.php:, _(*6)

// config/services.php

'panaceamobile' => [
    'login'  => env('PANACEAMOBILE_LOGIN'), // Your Username
    'secret' => env('PANACEAMOBILE_SECRET'), // Your Token
    'sender' => 'Sbudah' // Phone number to send SMS from
]

Usage

You can use the channel in your via() method inside the notification:, _(*7)

use Illuminate\Notifications\Notification;
use NotificationChannels\PanaceaMobile\PanaceaMobileMessage;
use NotificationChannels\PanaceaMobile\PanaceaMobileChannel;

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

    public function toPanaceaMobile($notifiable)
    {
        return (new PanaceaMobileMessage())
            ->content("Your {$notifiable->service} account was approved!");
    }
}

In order to let your Notification know which phone are you sending/calling to, the channel will look for the phone_number attribute of the Notifiable model. If you want to override this behaviour, add the routeNotificationForPanaceaMobile method to your Notifiable model., _(*8)

// app/User.php

public function routeNotificationForPanaceaMobile()
{
    return '27111000101';
}

Example #2, _(*9)

<?php

namespace App;

use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Route notifications for the Nexmo channel.
     *
     * @return string
     */
    public function routeNotificationForPanaceaMobile()
    {
        return $this->phone;
    }
}

Available methods

• ->content(''): Specifies the SMS content/text.

Contributing

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

Credits

• SMSc-Ru
• JhaoDa
• TheMorgz
• All Contributors

License

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