README

این پکیج کار ارسال آسان پیامک با استفاده از سرویس کاوه‌نگار را در Laravel 12 و بالاتر فراهم می‌کند.

فهرست مطالب

• نصب
  • راه‌اندازی حساب کاربری کاوه‌نگار
• نحوه استفاده
• مشارکت در توسعه

Installation

می‌توانید پکیج را با استفاده از کامپوزر نصب کنید:

composer require kavenegar/laravel-notification

در لاراول 12+ دیگر نیازی به اضافه کردن دستی سرویس‌پرووایدر در config/app.php نیست، چون سرویس‌پرووایدر به صورت خودکار (با توجه به extra.laravel.providers در composer.json) ثبت می‌شود.

فقط کافی است تنظیمات زیر را انجام دهید.

راه‌اندازی حساب کاربری کاوه‌نگار

کلید API و شماره فرستنده خود را در فایل config/services.php اضافه کنید: config/services.php:

// config/services.php

'kavenegar' => [
    'key' => env('KAVENEGAR_API_KEY'),
    'sender' => env('KAVENEGAR_SENDER'),
],

و در فایل .env مقداردهی کنید:

KAVENEGAR_API_KEY=your_api_key_here
KAVENEGAR_SENDER=your_sender_number_here

Usage

برای استفاده از کانال در نوتیفیکیشن خود، در متد via() آن کانال را معرفی کنید:

use Kavenegar\LaravelNotification\KavenegarChannel;
use Illuminate\Notifications\Notification;

class HappyNewYear extends Notification
{
    public function via($notifiable)
    {
        return [KavenegarChannel::class];
    }

    public function toSMS($notifiable)
    {
        return 'Happy new year :D';
    }
}

تنظیم شماره موبایل گیرنده

برای اینکه نوتیفیکیشن بداند پیامک را به کدام شماره ارسال کند، در مدل قابل نوتیفیکیشن (مثلاً مدل User) متد زیر را اضافه کنید:

public function routeNotificationForSms()
{
    return $this->phone; // فرض بر این است که شماره موبایل در فیلد phone ذخیره شده است
}

Contributing

Bug fixes, docs, and enhancements welcome! Please let us know support@kavenegar.com

راهنما

معرفی سرویس کاوه نگار

کاوه نگار یک وب سرویس ارسال و دریافت پیامک و تماس صوتی است که به راحتی میتوانید از آن استفاده نمایید.

ساخت حساب کاربری

اگر در وب سرویس کاوه نگار عضو نیستید میتوانید از لینک عضویت ثبت نام و اکانت آزمایشی برای تست API دریافت نمایید.

مستندات

برای مشاهده اطلاعات کامل مستندات وب سرویس پیامک به صفحه مستندات وب سرویس مراجعه نمایید.

راهنمای فارسی

در صورتی که مایل هستید راهنمای فارسی کیت توسعه کاوه نگار را مطالعه کنید به صفحه کد ارسال پیامک مراجعه نمایید.

اطالاعات بیشتر

برای مطالعه بیشتر به صفحه معرفی وب سرویس اس ام اس کاوه نگار مراجعه نمایید .

اگر در استفاده از کیت های سرویس کاوه نگار مشکلی یا پیشنهادی داشتید ما را با یک Pull Request یا ارسال ایمیل به support@kavenegar.com خوشحال کنید.

http://kavenegar.com