ghasedaksms/ghasedaksms-laravel

laravel package for use ghasedaksms api services

v1.0.2 2024-08-13 07:21 UTC

Requires

• php: ^8.2
• ghasedaksms/php: >=v1.0.4
• illuminate/support: 10.* | 11.*

Requires (Dev)

• orchestra/testbench: ^v9.1.2
• phpunit/phpunit: ^11.3.0

MIT

• mrt

• ghasedaksms
• ghasedaksms-laravel

README

Ghasedak Laravel SDK

Easy-to-use SDK for implementing Ghasedak SMS API in your Laravel projects.
Explore the docs »

Web Service Documents · REST API . Report Bug · Request Feature

English Document

Table of Contents

• Install
• Usage
• Licence

Installation

You can install the package via composer:

composer require ghasedaksms/ghasedaksms-laravel

Usage

1- Put your apikey in .env file:

GHASEDAK_SMS_API_KEY="b7ee4eace78************************************************"

2- Create a notification (for example SendOtpToUser):

php artisan make:notification SendOtpToUser

3- Extend SendOtpToUser from GhasedaksmsBaseNotification and fill toGhasedaksms function with DTOs:

<?php

namespace App\Notifications;

use Carbon\Carbon;
use Ghasedak\DataTransferObjects\Request\InputDTO;
use Ghasedak\DataTransferObjects\Request\ReceptorDTO;
use Ghasedaksms\GhasedaksmsLaravel\Message\GhasedaksmsVerifyLookUp;
use Ghasedaksms\GhasedaksmsLaravel\Notification\GhasedaksmsBaseNotification;
use Illuminate\Bus\Queueable;

class SendOtpToUser extends GhasedaksmsBaseNotification
{
    use Queueable;

    public function __construct()
    {
        //
    }

    public function toGhasedaksms($notifiable): GhasedaksmsVerifyLookUp
    {
        $message = new GhasedaksmsVerifyLookUp();
        $message->setSendDate(Carbon::now());
        $message->setReceptors([new ReceptorDTO($notifiable->mobile, 'client referenceId')]);
        $message->setTemplateName('newOTP');
        $message->setInputs([new InputDTO('code', '******')]);
        return $message;
    }
}

4- Use SendOtpToUser

$user = new \App\Models\User();
$user->mobile = '0912*******';
$user->notify(new \App\Notifications\SendOtpToUser());

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• mrt
• All Contributors

License

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

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.