wp_sms_send()

تتيح لك دالة wp_sms_send() إرسال رسائل SMS إلى أي رقم هاتف أو مجموعة أرقام برمجياً. هذه أداة قوية للمطورين الذين يريدون دمج وظائف SMS في قوالب أو إضافات WordPress الخاصة بهم.

الصياغة

wp_sms_send( $to, $msg, $is_flash = false, $from = null, $mediaUrls = [] );

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
$to	array	نعم	—	رقم (أرقام) المستلم
$msg	string	نعم	—	نص رسالة SMS
$is_flash	boolean	لا	false	اضبط على true للإرسال كرسالة فلاش
$from	string	لا	null	معرف المرسل المخصص
$mediaUrls	array	لا	[]	روابط الوسائط لرسائل MMS

القيمة المرجعة

تُرجع true عند النجاح أو WP_Error عند الفشل.

أمثلة

إرسال SMS لأرقام متعددة

$to = array('+1111111111', '+1111111112');
$msg = "Your Message";

wp_sms_send($to, $msg);

إرسال SMS فلاش

تظهر رسائل SMS الفلاش مباشرة على شاشة المستلم دون تخزينها في صندوق الوارد.

$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');
}

ملاحظات

• متطلبات تنسيق رقم الهاتف تعتمد على مزود البوابة الخاص بك
• دعم SMS الفلاش يعتمد على مزود البوابة الخاص بك
• دعم MMS يعتمد على مزود البوابة الخاص بك
• حدود طول الرسالة تختلف حسب المزود (عادةً 160 حرفاً لـ SMS)

ذو صلة

• wp_sms_add_subscriber - خطاف الإجراء للمشتركين الجدد
• نقطة نهاية إرسال SMS - بديل REST API