ibonly/laravel-etextemail

A laravel app that is built on etextmail api

1.0.3 2016-08-25 13:46 UTC

Requires

• php: >=5.5.9
• illuminate/support: 5.2.*

Requires (Dev)

• codeclimate/php-test-reporter: dev-master
• mockery/mockery: ^0.9.5
• phpunit/phpcov: 2.*
• phpunit/phpunit: 4.*
• satooshi/php-coveralls: ^1.0
• scrutinizer/ocular: ~1.1

MIT

• Adeniyi Ibraheem

• php
• sms
• github
• laravel
• telephone
• open source
• africa
• Nigeria
• ibonly
• extextmail
• laravel-extextmail

README

#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.