Download the PHP package laravel-notification-channels/vodafone without Composer
On this page you can find all versions of the php package laravel-notification-channels/vodafone. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download laravel-notification-channels/vodafone
More information about laravel-notification-channels/vodafone
Files in laravel-notification-channels/vodafone
Package vodafone
Short Description Send Laravel Notifications via the Vodafone SMS API
License MIT
Homepage https://github.com/laravel-notification-channels/vodafone
Informations about the package vodafone
Vodafone Notification Channel
This package makes it easy to send sms notifications using Vodafone with Laravel 5.5+ and 6.x
Building on Laravel's Notification channel, this package allows you to send SMS notifications via the Vodafone SMS gateway service.
Sending an SMS to a user becomes as simple as using:
Contents
- Installation
- Setting up the Vodafone service
- Usage
- Sending Text Message
- Available Message methods
- Retrieving Text Messages
- Sending Text Message
- Changelog
- Contributing
- Credits
- License
Installation
Install the package using composer
Add the configuration to your services.php config file:
Setting up the Vodafone service
Using the Vodafone SMS service requires an account with Vodafone, which can be arranged from this location: https://www.vodafone.com.au/messaging/smser
After being provided with your Vodafone account you will receive an API username and password, these need to be entered into your env or config file.
The Vodafone service has the option to send messages with an alpha tag so instead of appearing from a miscellaneous number they come from a pre-defined name.
Usage
Sending Text Message
Within your notification you need to add the Vodafone channel to your via() method:
In your notifiable model, make sure to include a routeNotificationForVodafone()
method, which should return a full mobile number including country code.
Available Message methods
content()
: Sets the message content of the SMS
from()
: Sets the qualified sender of the message
Retrieving Text Messages
The VodafoneClient class comes with a 'receive' method for retrieving messages from the Vodafone server.
Note: It only returns unread messages and once the Vodafone endpoint has been hit all unread messages are then marked as read. So you only have one opportunity to further process incoming messages.
Since the Vodafone API only returns one unread message at a time a loop will need to be used to retrieve all the unread messages.
Vodafone will return an Error (code: 201) when there are no more unread messages, so breaking the loop on an Exception means there are no more messages to be retrieved.
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Credits
- Simon Woodard
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of vodafone with dependencies
illuminate/notifications Version ^6.0 || ^7.0 || ^8.0 || ^9.0
illuminate/support Version ^6.0 || ^7.0 || ^8.0 || ^9.0
guzzlehttp/guzzle Version ^6.3 || ^7.0