wp_sms_send()
ارسال پیامک بهصورت برنامهنویسی با استفاده از تابع wp_sms_send().
تابع wp_sms_send() به شما امکان میدهد پیامکها را به هر شماره تلفن یا گروهی از شمارهها بهصورت برنامهنویسی ارسال کنید. این ابزاری قدرتمند برای توسعهدهندگانی است که میخواهند قابلیت پیامک را در قالبها یا افزونههای وردپرس خود یکپارچه کنند.
ساختار (Syntax)
wp_sms_send( $to, $msg, $is_flash = false, $from = null, $mediaUrls = [] );
پارامترها
| پارامتر | نوع | الزامی | پیشفرض | توضیحات |
|---|---|---|---|---|
$to | array | بله | — | شماره گیرنده(ها) |
$msg | string | بله | — | متن پیامک |
$is_flash | boolean | خیر | false | برای ارسال پیامک فلش روی true تنظیم کنید |
$from | string | خیر | null | شناسه فرستنده سفارشی |
$mediaUrls | array | خیر | [] | آدرسهای رسانه برای پیامهای MMS |
مقدار بازگشتی
در صورت موفقیت true و در صورت خطا WP_Error برمیگرداند.
مثالها
ارسال پیامک به چند شماره
$to = array('+1111111111', '+1111111112');
$msg = "Your Message";
wp_sms_send($to, $msg);
ارسال پیامک فلش
پیامک فلش مستقیماً روی صفحه نمایش گیرنده ظاهر میشود و در صندوق ورودی ذخیره نمیشود.
$to = array('+1111111111', '+1111111112');
$msg = "Your Message";
wp_sms_send($to, $msg, true);
ارسال MMS با رسانه
تصاویر یا سایر رسانهها را در پیام خود قرار دهید.
$to = array('+1111111111', '+1111111112');
$msg = "Your Message";
$urls = ['https://example.com/image.jpg'];
wp_sms_send($to, $msg, false, null, $urls);
ارسال با شناسه فرستنده سفارشی
$to = array('+1111111111');
$msg = "Your Message";
wp_sms_send($to, $msg, false, 'MyCompany');
مدیریت خطا
$to = array('+1111111111');
$msg = "Your Message";
$result = wp_sms_send($to, $msg);
if (is_wp_error($result)) {
error_log('SMS failed: ' . $result->get_error_message());
} else {
error_log('SMS sent successfully');
}
نکات
- فرمت شماره تلفن به ارائهدهنده درگاه شما بستگی دارد
- پشتیبانی از پیامک فلش به ارائهدهنده درگاه شما بستگی دارد
- پشتیبانی از MMS به ارائهدهنده درگاه شما بستگی دارد
- محدودیت طول پیام بسته به ارائهدهنده متفاوت است (معمولاً ۱۶۰ کاراکتر برای پیامک)
مرتبط
- wp_sms_add_subscriber - هوک اکشن برای مشترکین جدید
- ارسال پیامک از طریق API - جایگزین REST API
آخرین بهروزرسانی: ۳ دی ۱۴۰۳