wp_sms_single_dispatch_arguments

تعديل معاملات SMS قبل إرسال الرسائل إلى المستلمين الفرديين.

يتيح لك فلتر wp_sms_single_dispatch_arguments تخصيص معاملات SMS قبل إرسال الرسائل إلى أرقام الهواتف الفردية. استخدم هذا لتعديل تفاصيل المستلم أو محتوى الرسالة أو إضافة عناصر ديناميكية.

الصيغة

add_filter('wp_sms_single_dispatch_arguments', 'your_callback');

المعاملات

المعامل	النوع	الوصف
`$arguments`	array	إعدادات إرسال SMS
`$arguments['to']`	string	رقم هاتف المستلم
`$arguments['msg']`	string	نص الرسالة

المتطلبات

لكي يعمل هذا الفلتر بشكل صحيح، قم بإعداد الإعدادات ← بوابات SMS ← إرسال SMS مع ضبط طريقة التسليم على Batch SMS Queue.

أمثلة

إضافة رابط إلغاء الاشتراك

إلحاق رابط إلغاء الاشتراك بكل رسالة:

add_filter('wp_sms_single_dispatch_arguments', function($arguments) {
    $unsubscribeLink = \WP_SMS\Newsletter::generateUnSubscribeUrlByNumber($arguments['to']);
    $arguments['msg'] .= "\n" . $unsubscribeLink;

    return $arguments;
});

استبدال العناصر النائبة الديناميكية

استبدال الرموز المخصصة بمعلومات المشترك أو المستخدم:

add_filter('wp_sms_single_dispatch_arguments', function($arguments) {
    $subscriber = \WP_SMS\Newsletter::getSubscriberByMobile($arguments['to']);
    $user = \WP_SMS\Helper::getUserByPhoneNumber($arguments['to']);

    if ($subscriber) {
        $arguments['msg'] = str_replace('{display_name}', $subscriber->name, $arguments['msg']);
    } elseif ($user) {
        $arguments['msg'] = str_replace('{display_name}', $user->display_name, $arguments['msg']);
    }

    return $arguments;
});

إضافة بادئة للرسالة

add_filter('wp_sms_single_dispatch_arguments', function($arguments) {
    $arguments['msg'] = "[MyCompany] " . $arguments['msg'];

    return $arguments;
});

تسجيل الرسائل الصادرة

add_filter('wp_sms_single_dispatch_arguments', function($arguments) {
    error_log("SMS to {$arguments['to']}: {$arguments['msg']}");

    return $arguments;
});

حالات الاستخدام

إضافة روابط إلغاء الاشتراك للامتثال للوائح
استبدال العناصر النائبة الديناميكية ببيانات المستخدم
إضافة بادئة الشركة أو العلامة التجارية للرسائل
تسجيل الرسائل الصادرة لأغراض التصحيح
تعديل أرقام المستلمين (إضافة رمز الدولة، إلخ.)