README

Verimor SMS Laravel Package

Laravel için yazılmış Verimor üzerinden SMS gönderimi ve kalan kredi sorgulama paketi.
Dökümantasyon »

Demo · Buglar · İstekler

İçindekiler

Proje Hakkında
Başlarken
- İhtiyaçlar
- Projenize Ekleme
Kullanım
Lisans
İletişim

Proje Hakkında

VerimorSms Laravel için oluşturulmuş kolayca SMS gönderme sağlayan bir pakettir. Ayrıca kalan kredilerinizi kontrol ederek kolayca projenizde yazdırabilirsiniz.

Neden ihtiyaç var:

Verimor için tekrar tekrar helper fonksiyonları yazmanıza gerek kalmaz.
Verimor'un verdiği tüm fonksiyonlara erişim sağlar

Sadece basit bir kaç komut ile projenize dahil edebilir, fonksiyonları kullanarak basit SMS gönderimi yapabilirsiniz.

(Başa dön)

Başlarken

Kullanacağınız proje Laravel projesi olmalıdır. Kurulumu yaptıktan sonra composer ile projenize ekleyebilirsiniz.

İhtiyaçlar

Laravel versiyonu 7 veya daha güncel olmalıdır. Verimor paneli üzerinden paketi kullanacağınız sunucu veya yerel IP & DNS'leri kaydetmelisiniz. SMS Hizmeti > SMS Ayarları kısmından bu değişiklikleri yapabilirsiniz. SSL sertifika kontrolü açık olmalıdır.

Sunucunuzda mutlaka cURL son versiyonu olmalıdır. Aksi takdirde error 500 hatası alabilirsiniz!

Ayrıca API erişimi seçeneği de açık olmalıdır. SMS mesajlarını test ederken aynı numaraya defalarca aynı SMS'i atıyorsanız, Mükerrer SMS Gönderimi açık olmalıdır.

Projenize ekleme

Laravel projenizde terminali açarak şu komutu çalıştırın;

composer require theposeidonas/verimor-sms

Eğer gerekiyorsa config dosyasını paylaşmak için şu komutu çalıştırın;

php artisan vendor:publish --tag=verimor-config --force

Sonrasında Verimor'u her yerde kullanmak için config/app.php dosyasında 'aliases' kısmına şu kodu ekleyin;

'Verimor' => Theposeidonas\VerimorSms\Facades\Verimor::class,

Konfigürasyon

Kullanım için projenize eklemeyi yaptıktan sonra, .env dosyası içerisinde yukarıya şu satırı ekleyip düzeltmelisiniz;

VERIMOR_USERNAME=908501234567  // API Kullanıcı adı
VERIMOR_PASSWORD=XXXXXXXXX  // API şifreniz
VERIMOR_TITLE=XXXXXX  // SMS Gönderim başlığı (0850XXXXXXX şeklinde numaranız varsayılan başlığınızdır)

(Başa dön)

Kullanım

Kullanacağınız Controller içerisine paketi dahil etmeniz gerekiyor;

use Theposeidonas\VerimorSms\Facades\Verimor;

Tüm ayarlamaları ve konfigürasyonlarınızı yaptıktan sonra kullanacağınız Controller içerisine şu fonksiyonları çalıştırabilirsiniz;

// Kalan kredi kontrolü
$request = Verimor::checkCredit();
$request->credit; // (int) 9999 veya (string) Kullanıcı adı ve şifre geçersiz.
$request->status; // (int) 200 veya (int) 401

// SMS gönderimi (POST)
$request = Verimor::send('Mesajınız', '905312345678');
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400

// SMS gönderimi (GET)
$request = Verimor::sendGet('Mesajınız', '905312345678');
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400

// Ekstra parametreler ile SMS gönderimi (POST)
$parameters = [
'source_addr' => 'YENI BASLIK', // Kayıtlı diğer başlıklarınızdan
'valid_for' => '24:00', // SMS geçerlilik saati, SS:DD şeklinde veya S:DD şeklinde
'send_at' => '', // 2023-12-20 16:30:00 şeklinde datetime veya boş
'custom_id' => uniqid(), // Kampanya ID
'datacoding' => 0 // Datacoding
];

$request = Verimor::send('Mesajınız', '905312345678', $parameters);
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400