در این آموزش یک افزونه سبک و کاربردی برای وردپرس در اختیار شما قرار میدهیم که با استفاده از آن میتوانید پس از تکمیل هر مرحله از گردش کار Gravity Flow، یک پیامک اطلاعرسانی برای کاربر ارسال کنید.
این افزونه به Gravity Forms و Gravity Flow متصل میشود، شماره همراه ثبتشده در فرم را دریافت میکند و پس از تکمیل مراحل مشخصشده، پیامک موردنظر را از طریق سرویس IPPanel ارسال میکند.
## امکانات افزونه
این افزونه امکانات زیر را در اختیار شما قرار میدهد:
* ارسال خودکار پیامک پس از تکمیل مراحل Gravity Flow
* امکان محدود کردن ارسال پیامک به یک فرم مشخص
* امکان انتخاب فیلد شماره همراه
* امکان تعریف متن دلخواه برای پیامک
* امکان مستثنا کردن برخی مراحل از ارسال پیامک
* اتصال مستقیم به پنل پیامکی IPPanel
* ثبت رویدادهای ارسال پیامک در لاگ وردپرس
## پیشنیازهای استفاده
برای استفاده از این افزونه باید موارد زیر روی سایت شما نصب و فعال باشند:
* وردپرس
* افزونه Gravity Forms
* افزونه Gravity Flow
* حساب فعال در سامانه پیامکی IPPanel
* نام کاربری و رمز عبور پنل پیامکی
* شماره ارسالکننده یا خط خدماتی فعال
## نصب افزونه
ابتدا فایل ZIP افزونه را دانلود کنید.
سپس وارد مدیریت وردپرس شوید و مسیر زیر را دنبال کنید:
**افزونهها ← افزودن افزونه تازه ← بارگذاری افزونه**
فایل ZIP افزونه را انتخاب کرده و روی گزینه «هماکنون نصب نمایید» کلیک کنید. پس از پایان نصب، افزونه را فعال کنید.
بعد از فعالسازی، جدول موردنیاز افزونه بهصورت خودکار در پایگاه داده وردپرس ایجاد میشود.
## تنظیمات افزونه
بعد از فعالسازی افزونه، از منوی مدیریت وردپرس وارد مسیر زیر شوید:
**تنظیمات ← SMS Settings**
در این صفحه فیلدهای زیر نمایش داده میشوند.
### نام کاربری
نام کاربری حساب شما در سامانه IPPanel را وارد کنید.
### پسورد
رمز عبور حساب پیامکی خود را وارد کنید.
### شماره ارسالکننده
شماره خط پیامکی یا شماره خدماتی ارسالکننده را وارد کنید.
این شماره باید در پنل پیامکی شما فعال باشد و اجازه ارسال پیامک داشته باشد.
### آیدی مراحلی که نباید پیامک ارسال شود
شناسه مراحلی را وارد کنید که نمیخواهید پس از تکمیل آنها پیامک ارسال شود.
شناسه مراحل باید با کاما از یکدیگر جدا شوند.
برای مثال:
2,5,8در این حالت، برای مراحل دارای شناسه ۲، ۵ و ۸ پیامکی ارسال نخواهد شد.
در صورتی که میخواهید برای تمام مراحل پیامک ارسال شود، این فیلد را خالی بگذارید.
### متن پیام
متن پیامکی را وارد کنید که باید پس از تکمیل مراحل برای کاربر ارسال شود.
برای مثال:
کاربر گرامی، درخواست شما با موفقیت وارد مرحله بعدی شد.متن واردشده برای تمام مراحلی که در فهرست استثناها قرار ندارند ارسال خواهد شد.
### آیدی فرم
شناسه فرم Gravity Forms موردنظر را وارد کنید.
افزونه تنها رویدادهای مربوط به همین فرم را بررسی میکند و برای فرمهای دیگر پیامکی ارسال نخواهد کرد.
برای مشاهده شناسه فرم، وارد بخش فرمها در Gravity Forms شوید. شناسه هر فرم در فهرست فرمها و همچنین در آدرس صفحه ویرایش فرم قابل مشاهده است.
### آیدی فیلد تماس
شناسه فیلدی را وارد کنید که شماره همراه کاربر در آن ذخیره میشود.
برای پیدا کردن شناسه فیلد:
1. فرم موردنظر را در Gravity Forms ویرایش کنید.
2. روی فیلد شماره همراه کلیک کنید.
3. شناسه فیلد را در تنظیمات یا مشخصات فیلد مشاهده کنید.
4. عدد شناسه را در تنظیمات افزونه وارد کنید.
برای مثال، اگر شماره همراه در فیلد شماره ۶ ذخیره میشود، مقدار زیر را وارد کنید:
6پس از تکمیل تنظیمات، روی دکمه «ذخیره تنظیمات» کلیک کنید.
## نحوه عملکرد افزونه
افزونه به رویداد تکمیل مرحله در Gravity Flow متصل میشود.
هر زمان یکی از مراحل گردش کار تکمیل شود، افزونه عملیات زیر را انجام میدهد:
1. شناسه فرم را بررسی میکند.
2. مطمئن میشود رویداد مربوط به فرم انتخابشده است.
3. شناسه مرحله را با فهرست مراحل مستثناشده مقایسه میکند.
4. اطلاعات ثبتشده در Gravity Forms را دریافت میکند.
5. شماره همراه را از فیلد انتخابشده میخواند.
6. پیام تعیینشده را از طریق IPPanel ارسال میکند.
اگر شناسه فرم با تنظیمات افزونه مطابقت نداشته باشد یا مرحله در فهرست مراحل نادیدهگرفتهشده باشد، پیامکی ارسال نمیشود.
## نمونه تنظیمات
فرض کنید مشخصات گردش کار شما به شکل زیر است:
* شناسه فرم: 12
* شناسه فیلد شماره همراه: 7
* مراحل بدون پیامک: 3 و 6
* شماره ارسالکننده: 3000XXXX
* متن پیام: درخواست شما وارد مرحله بعدی شد.
در این شرایط باید تنظیمات زیر را وارد کنید:
آیدی فرم: 12\nآیدی فیلد تماس: 7\nمراحل نادیده گرفتهشده: 3,6\nمتن پیام: درخواست شما وارد مرحله بعدی شد.اکنون پس از تکمیل تمام مراحل فرم شماره ۱۲، بهجز مراحل ۳ و ۶، پیامک برای شماره ثبتشده در فیلد شماره ۷ ارسال میشود.
## مشاهده گزارش ارسال پیامک
افزونه اطلاعات مربوط به اجرای رویداد و ارسال پیامک را در گزارش خطای وردپرس ثبت میکند.
برای فعالکردن گزارش وردپرس میتوانید مقادیر زیر را در فایل `wp-config.php` قرار دهید:
define('WP_DEBUG', true);\ndefine('WP_DEBUG_LOG', true);\ndefine('WP_DEBUG_DISPLAY', false);پس از فعالسازی، گزارشها معمولاً در فایل زیر ذخیره میشوند:
/wp-content/debug.logدر این فایل میتوانید مواردی مانند اجرای رویداد Gravity Flow، پیدا شدن شماره همراه، ارسال پیامک و پاسخ سرویس پیامکی را مشاهده کنید.
## جمعبندی
افزونه Gravity Flow SMS Notifications یک راهکار ساده برای ارسال پیامک اطلاعرسانی در گردشهای کاری Gravity Flow است.
با استفاده از این افزونه میتوانید کاربران را پس از تکمیل مراحل مختلف یک فرایند، مانند ثبت درخواست، بررسی مدارک، تأیید مدیریت یا انتقال به مرحله بعد، از وضعیت درخواستشان مطلع کنید.
برای شروع کافی است افزونه را نصب کنید، اطلاعات IPPanel را وارد کرده و شناسه فرم و فیلد شماره همراه را مشخص کنید.