Skip to content

wp_sms_single_dispatch_arguments

تغییر پارامترهای پیامک قبل از ارسال به گیرندگان منفرد.

فیلتر wp_sms_single_dispatch_arguments به شما امکان می‌دهد پارامترهای پیامک را قبل از ارسال به شماره تلفن‌های منفرد سفارشی‌سازی کنید. از این فیلتر برای تغییر جزئیات گیرنده، محتوای پیام یا افزودن عناصر پویا استفاده کنید.

نحوه نوشتن

add_filter('wp_sms_single_dispatch_arguments', 'your_callback');

پارامترها

پارامترنوعتوضیحات
$argumentsarrayپیکربندی ارسال پیامک
$arguments['to']stringشماره تلفن گیرنده
$arguments['msg']stringمتن پیام

پیش‌نیازها

برای عملکرد صحیح این فیلتر، تنظیمات ← درگاه‌های SMS ← ارسال SMS را با روش تحویل صف ارسال دسته‌ای پیامک پیکربندی کنید.

مثال‌ها

افزودن لینک لغو اشتراک

الحاق URL لغو اشتراک به هر پیام:

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

موارد استفاده

  • افزودن لینک‌های لغو اشتراک برای رعایت مقررات
  • جایگزینی متغیرهای پویا با داده‌های کاربر
  • افزودن پیشوند یا برندینگ شرکت به پیام‌ها
  • ثبت لاگ پیام‌های خروجی برای عیب‌یابی
  • تغییر شماره‌های گیرنده (افزودن کد کشور و غیره)

مرتبط

آخرین به‌روزرسانی: ۳ دی ۱۴۰۳