Download the PHP package norris1z/hubtel-laravel-sms-channel without Composer
On this page you can find all versions of the php package norris1z/hubtel-laravel-sms-channel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download norris1z/hubtel-laravel-sms-channel
More information about norris1z/hubtel-laravel-sms-channel
Files in norris1z/hubtel-laravel-sms-channel
Package hubtel-laravel-sms-channel
Short Description Hubtel SMS Channel for Laravel 5.3+
License MIT
Homepage https://github.com/norris1z/hubtel-laravel-sms-channel
Informations about the package hubtel-laravel-sms-channel
Hubtel notification channel for Laravel 5.3+
This package makes it easy to send notifications using Hubtel with Laravel 5.3+.
Contents
- Installation
- Setting up the Hubtel service
- Usage
- Available Message methods
- Changelog
- Testing
- Security
- Contributing
- Credits
- License
Installation
To get the latest version of Hubtel Notification channel for Laravel 5.3+, simply require the project using Composer:
If you use Laravel 5.5+ you don't need the following step.
If not, once package is installed, you need to register the service provider. Open up config/app.php
and add the following to the providers
key.
NotificationChannels\Hubtel\HubtelServiceProvider::class
Setting up the Hubtel service
In your Hubtel account go to Applications page. Click on the details of the desired application and copy your apiKey
and apiSecret
In your terminal run
This creates a hubtel.php
file in your config
directory.
Paste your apiCredentials in the config/hubtel.php
configuration file. You may copy the example configuration below to get started:
Or
Add the HUBTEL_API_KEY
and HUBTEL_API_SECRET
to your .env
file
Usage
Now you can use the channel in your via()
method inside the notification:
In order to let your Notification know which phone number you are sending to, add the routeNotificationForSMS
method to your Notifiable model e.g your User Model
Available Message methods
from($from)
: set the sender's name or phone numberto($to)
: set the recipient's phone numbercontent($content)
: set the message contentregisteredDelivery()
: set delivery report requestclientReference($reference)
: set the client reference numbertype($type)
: set the message type to be sentudh($udh)
: set the User Data Header of the SMS Message being senttime($time)
: set the time to deliver the messageflashMessage()
: sends the message as a flash message
Read more about the avialable methods on the Hubtel Documentation Page
Changelog
Latest Notice
For developers who would want to use this package on VPS hosted applications, if the server location is US for which you have a US IP Address, you may need to seek whitelisting of the US Ip address from hubtel by mailing [email protected]. As i discovered through experience that the package would work fine on local machine because the IP used is a Ghanaian IP address but fails to work on a production server. Note however that this is not a package problem, as the package just organizes components for sending successful SMS messages within Laravel. It is even more challenging to know the cause of the problem when you are using laravel queues, because the response codes are not logged, the queue just logs Processing failed.Hubtels SMS server responds with a 403 Forbidden, when the same SMS is sent directly using Guzzlehttp on the production server (VPS). A 403 HTTP Response according to their website (hubtel) indicates the recipient has not given his/her approval to receive messages which is even more confusing. :)
Please see CHANGELOG for more information what has changed recently.
Testing
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Contributing
Please see CONTRIBUTING for details.
Credits
- Norris Oduro Tei
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of hubtel-laravel-sms-channel with dependencies
guzzlehttp/guzzle Version ^7.2
illuminate/notifications Version 5.3.*|5.4.*|5.5.*|5.6.*|5.7.*|5.8.*|6.*|7.*|8.*
illuminate/support Version 5.1.*|5.2.*|5.3.*|5.4.*|5.5.*|5.6.*|5.7.*|5.8.*|6.*|7.*|8.*