PHP Classes

File: Readme.md

Recommend this page to a friend!
  Classes of adeniyi ibraheem   Laravel Etextmail   Readme.md   Download  
File: Readme.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: Laravel Etextmail
Send SMS messages via etextmail.com API
Author: By
Last change:
Date: 7 years ago
Size: 3,705 bytes
 

Contents

Class file image Download

Build Status Coverage Status Scrutinizer Code Quality Code Climate

Laravel-EtextMail

Laravel-etextmail is built on etextmail api (http://etextmail.com) which is an SMS gateway to send sms messages to cell phones on GSM and CDMA networks, Glo, MTN, Zain, Etisalat, Starcomms, Visafone in Nigeria and Globally.

To get the latest version of laravel-etextmail, simply

composer require ibonly\laravel-etextmail

Or include

"ibonly/laravel-etextmail: 1.0.*"

to your composer.json file and run composer update or composer install

Once Laravel EtextMail is installed, you need to register the service provider. Open up config/app.php and add the following to the providers key.

 Ibonly\EtextMail\EtextMailServiceProvider::class,

Also, register the Facade like so:

'aliases' => [
    ...
    'EtextMail' => Ibonly\EtextMail\Facades\EtextMail::class,
    ...
]

configuration (step 1)

Publish configuration file using the command bellow:

php artisan vendor:publish --provider="Ibonly\EtextMail\EtextMailServiceProvider"

A file etextmail.php containing default configuration settings will be added to config/ directory.

return [
    'senderid' => getenv('ETEXTMAIL_SENDER'),

    'username' => getenv('ETEXTMAIL_EMAIL'),

    'password' => getenv('EXTEXTMAIL_PASSWORD'),

    'url'      => getenv('ETEXTMAIL_URL'),
];

configuration (step 2)

Open your .env file and add your SMS Sender Id, etextmail email, etextmail password and etextmail url:

ETEXTMAIL_SENDER=xxxxx
ETEXTMAIL_EMAIL=xxxxx
EXTEXTMAIL_PASSWORD=xxxxx
ETEXTMAIL_URL=http://mail.etextmail.com

Note that resellers are to use their own url.

usage

use EtextMail;

class SMS
{
	/
	 * @return float
	 */
	public function getSMSBalance()
	{
		dd(EtextMail::getCreditBalance())
	}

	/
	 * @param  $message [the message to be processed]
	 * @return int
	 */
	public function	messageCount($message)
	{
		dd(EtextMail::getMessageCount($message));
	}

	/
	 * @param  $message [the message to be processed]
	 * @return int
	 */
	public function characterCount($message)
	{
		dd(EtextMail::getCharacterCount($message));
	}

	/
	 * @param  $destination [reciever's mobile number]
	 * @param  message      [the message to be processed]
	 * @return boolean
	 */
	public function sendSMS($destination, $message)
	{
		dd(EtextMail::sendMessage($destination, $message));
	}

	/
	 * @param  $destination [reciever's mobile number]
	 * @param  $message     [the message to be processed]
	 * @param  $longSMS     [number of pages]
	 * @return boolean
	 */
	public function sendLongSMS($destination, $message, $longSMS)
	{
		dd(EtextMail::sendMessage($destination, $message, $longSMS))
	}
	
	
}

Testing

$ vendor/bin/phpunit test

Contributing

To contribute and extend the scope of this package, Please check out CONTRIBUTING file for detailed contribution guidelines. Feel free to raise any issue or concern.

Credits

Laravel-etextmail is created and maintained by Ibraheem ADENIYI.