افزونه وب هوک گرویتی فرمز | Gravity Forms Webhooks Add-On

Gravity Forms Webhooks Add-On

آیا می خواهید داده های فرم خود را از سایت وردپرس به یک API خارجی ارسال کنید؟ افزونه Webhooks برای Gravity Forms به شما امکان می دهد دقیقاً همان کار را انجام دهید. اطلاعاتی مانند ارسال فرم، داده های پرداخت و موارد دیگر را به راحتی به سرویس شخص ثالث مورد نظر خود منتقل کنید.

این افزونه Gravity Forms یک افزونه Elite است و فقط با مجوز معتبر Elite در دسترس است.

ادغام بی نقص

به راحتی Webhooks را به Gravity Forms اضافه کرده و داده هایی را که به Callback URL منتقل می شوند پیکربندی کنید.

روش های درخواست (Request Mode)

Webhooks را برای استفاده از GET ، POST ، PUT ، PATCH یا DELETE به عنوان Request Mode پیکربندی کنید.

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

داده ها را به عنوان JSON یا فرم به URL Request ارسال کنید.

سرتیترها ها و داده های سفارشی

سرتیتر های درخواست را پیکربندی کنید و فقط داده هایی را که می خواهید به Webhook منتقل کنید را پیکربندی کنید.

منطق شرطی

از Gravity Forms ساخته شده در Logic Conditional استفاده کنید تا فقط در صورت تمایل به ایجاد Webhooks بپردازید!

راه اندازی Webhooks در فرم های ارسالی

با استفاده از افزونه Gravity Forms Webhooks، هنگام ارسال فرم، می توانید درخواست های HTTP از راه دور را به سرویس های خارجی ارسال کنید.

با استفاده از Webhooks، حتی اگر افزونه رسمی برای آن در دسترس نباشد، می توانید به راحتی داده های فرم را به سرویس های شخص ثالث منتقل کنید.

توجه: این مقاله فرض می کند شما افزونه Webhooks را نصب و فعال کرده باشید. در غیر این صورت، قبل از استفاده از هر یک از قابلیت های این مقاله، لازم است این کار را انجام دهید.

پیکربندی Webhooks

برای پیکربندی webhooks برای فرم، باید فیدی ایجاد کنید مانند آنچه در بیشتر افزونه ها وجود دارد. برای انجام این کار، به تنظیمات فرم (Form Setting) خود بروید و روی تب Webhooks کلیک کنید و سپس روی دکمه افزودن جدید (Add New) کلیک کنید.

در مرحله بعدی، باید درخواستی را که تنظیم شده پیکربندی کنید. این بسته به سرویسی که از آن درخواست می کنید متفاوت خواهد بود. اگر مطمئن نیستید که چه تنظیماتی را باید در اینجا انتخاب کنید، ممکن است بخواهید با سرویسی که می خواهید به آن متصل شوید تماس بگیرید.

تنظیمات

• نام

نامی برای فید خود وارد کنید. این هرگز نمایش داده نمی شود و فقط برای اهداف شناسایی استفاده می شود. شما می توانید هر نامی که می خواهید انتخاب کنید.

درخواست URL

URL که این درخواست باید به آن ارسال شود را وارد کنید. این تنظیم همچنین از برچسب های ادغام پشتیبانی می کند. وقتی درخواست های محلی را انجام می دهید می توانید از برچسب های ادغام {admin_ajax_url} و {rest_api_url} استفاده کنید.

• روش درخواست

روش HTTP را که قرار است هنگام انجام درخواست استفاده شود، انتخاب کنید. روش های پشتیبانی شده عبارتند از:GET ، POST ، PUT PATCH و DELETE.

• فرمت درخواست

فرمت درخواست webhook را انتخاب کنید. فرمت های پشتیبانی شده FORM و JSON هستند.

• سرتیتر درخواست

در اینجا می توانید یک یا چند سرتیتر HTTP را برای ارسال با درخواست پیکربندی کنید.

توجه: سرتیتر Content-Type در هنگام پردازش فید هنگامی که فرم درخواست روی JSON تنظیم می شود و روش درخواست روی POST یا PUT تنظیم می شود، سرتیتر Content-Type بصورت خودکار روی Application / json تنظیم می شود.

• متن درخواست

اینجا جایی است که شما تعیین می کنید چه داده هایی با درخواست ارسال می شوند. می توانید از گزینه های زیر انتخاب کنید:

1. All Fields: با این کار کل ورودی فرمت بندی شده ارسال می شود.
2. Select Field (انتخاب فیلد): با این کار تنظیمات Fields Values ​​نمایش داده می شود.

• مقادیر فیلد

فقط وقتی تنظیم شود که Request Body روی Select Fields تنظیم شده باشد. این تنظیم پویا به شما امکان می دهد کلیدها و مقادیر ارسال شده در متن درخواست را تعیین کنید. برای مقادیر، می توانید از فیلدهای فرم، متا ورودی یا Add Custom Value که ورودی متنی را نشان می دهد و از برچسب های ادغام پشتیبانی می کند، انتخاب کنید.

• شرایط Webhook

مانند سایر افزونه ها، منطق شرطی نیز قابل استفاده است. برای استفاده از منطق مشروط، کادر تأیید Enable Condition را انتخاب کرده و سپس قوانینی را که باید برای ارسال این درخواست رعایت شود پیکربندی کنید.

نحوه ایجاد رویدادهای Events Calendar با استفاده از افزونه Webhooks و WordPress REST API

معرفی

از فرم افزونه Gravity Forms Webhooks می توان برای ارسال درخواست به REST API وردپرس که توسط پلاگین Events Calendar بصورت محلی یا از سایت دیگر اضافه شده است، استفاده کرد.

توجه: این مقاله فرض می کند شما افزونه Webhooks و افزونه Events Calandar را نصب و فعال کرده باشید. در غیر این صورت، قبل از استفاده از هر یک از قابلیت های این مقاله، لازم است این کار را انجام دهید.

پیکربندی فرم

یک فرم جدید ایجاد کنید و فیلدها را اضافه کنید.

نکته: برای محدود کردن اینکه کدام یک از تاریخ ها را می توان در فیلد های تاریخ انتخاب کرد، می توان از Gravity Perks Limit Dates استفاده کرد.

پیکربندی Webhook

برای پیکربندی webhooks برای فرم، به تنظیمات فرم خود بروید و روی تب Webhooks کلیک کنید و سپس روی دکمه Add New کلیک کنید.

در مرحله بعدی، باید تنظیمات زیر را برای درخواستی که انجام شده پیکربندی کنید.

• نام

نامی برای فید خود وارد کنید. این می تواند هر چیزی که شما می خواهید باشد زیرا فقط برای اهداف شناسایی در صفحه لیست فیدها و گزارش افزونه مورد استفاده قرار می گیرد.

• درخواست URL

{rest_api_url}tribe/events/v1/events را وارد کنید.

هنگام پردازش فید، برچسب ادغام {rest_api_url} با آدرس REST API پایه سایت فعلی جایگزین خواهد شد.

اگر افزونه Events Calendar در سایت دیگری نصب شده است، باید برچسب ادغام {rest_api_url} را با URL REST API پایه برای آن سایت جایگزین کنید. http: //the-remote-site.local/wp-json/tribe/events/v1/events.

• روش درخواست

گزینه POST را به عنوان روش درخواست انتخاب کنید.

• فرمت درخواست

گزینه JSON را به عنوان فرمت درخواست انتخاب کنید.

• سرتیترهای درخواست

هیچ سرتیر درخواستی برای پیکربندی وجود ندارد.

• متن درخواست

گزینه Select Fields را انتخاب کنید.

مقادیر فیلد

 

ردیف ها را برای فیلدهای زیر پیکربندی کنید. برای افزودن ردیف های جدید، روی آیکون افزودن (+) کلیک کنید.

برای مقادیر، می توانید از فیلد های فرم، متا ورودی یا Add Custom Value که ورودی متنی را نشان می دهد و از برچسب های ادغام پشتیبانی می کند، انتخاب کنید.

احراز هویت

اگر فرم را پس از پیکربندی webhook تست کنید، می توانید در ایجاد رویداد ناموفق باشید و اگر ورود به سیستم فعال باشد، خطی مانند زیر را پیدا خواهید کرد:

()DEBUG -> GF_Webhooks :: process_feed: وب هوک با موفقیت اجرا شد. کد: ۴۰۱؛ body: {“code”: “rest_forbidden”، “message”: “متاسفم، شما مجاز به انجام این کار نیستید.”، “data”: {“status”: 401}}

برای اطمینان از اینکه شخص درخواست کننده اجازه این کار را دارد، برای بسیاری از نقاط انتهایی REST API احراز هویت لازم است. با استفاده از افزونه Webhooks می توانید از فیلتر gform_webhooks_quest_args در فایل theme function.php یا یک پلاگین سفارشی سفارشی برای افزودن استدلال های تأیید صحت استفاده کنید.

gform_webhooks_ request_args مثال شماره ۲ نشان می دهد که چگونه می توانید از احراز هویت استاندارد کوکی برای کاربران وارد شده که درخواست سایت های فعلی را دارند استفاده کنید.

اگر برای سایتی درخواست راه دور دارید یا کاربر در سایت فعلی به سیستم وارد نمی شود، باید از یک روش احراز هویت جایگزین مانند مجوز پایه همانطور که در gform_webhooks_quest_args به عنوان مثال شماره ۳ نشان داده شده است، استفاده کنید.

روش جایگزین

اگر پلاگین Calendar Events به صورت محلی نصب شده باشد و مجوز Elite یا Legacy Developer ندارید و ترجیح می دهید مجوز موجود خود را ارتقا ندهید، می توانید از gform_after_submission به عنوان مثال # ۸ در فایل theme.php یا پلاگین سفارشی استفاده کنید.

ایجاد Tickets در WSDesk با استفاده از افزونه Webhooks

معرفی

استفاده از افزونه Gravity Forms Webhooks ساده ترین راه برای ارسال درخواست به WSDesk API برای ایجاد Ticket پشتیبانی هنگام ارسال فرم است.

توجه: این مقاله فرض می کند شما افزونه Webhooks و افزونه WSDesk را نصب و فعال کرده باشید. در غیر این صورت، قبل از استفاده از هر یک از قابلیت های این مقاله، لازم است این کار را انجام دهید.

پیکربندی Webhook

برای پیکربندی webhooks برای فرم، به فرم تنظیمات خود بروید و روی تب Webhooks کلیک کنید و سپس روی دکمه Add New کلیک کنید.

در مرحله بعدی، باید درخواستی را که تنظیم شده پیکربندی کنید.

• نام

نامی برای فید خود وارد کنید. این هرگز نمایش داده نمی شود و فقط برای اهداف شناسایی استفاده می شود. شما می توانید نام این موارد را هرچه می خواهید بگذارید.

• درخواست URL

نقطه پایان WSDesk برای ایجاد Ticket سایت های دارای Admin Ajax URL هستند. ساده ترین راه برای درج این URL وارد کردن برچسب ادغام {admin_ajax_url} است. هنگام پردازش فید با URL صحیح جایگزین می شود.

• روش درخواست

گزینه POST را به عنوان روش درخواست انتخاب کنید.

• فرمت درخواست

کزینه Form را به عنوان فرمت درخواست انتخاب کنید.

• سرتیترهای درخواست

ما هیچ سرتیتری را پیکربندی نمی کنیم.

• متن درخواست

گزینه Select Fields را انتخاب کنید.

• مقادیر فیلد

ردیف ها را برای فیلد های زیر پیکربندی کنید، هنگام پیکربندی مقادیر، گزینه Add Custom Value را انتخاب کنید. برای افزودن ردیف های جدید، روی آیکون افزودن (+) کلیک کنید.

کلید

• action

مقدار

wsdesk_api_create_ticket

کلید

• api_key

مقدار

• The WSDesk API key from the WSDesk > Settings > General tab

در ادامه می توانید ردیف های اضافی را برای فیلدهای Ticket که در WSDesk پیکربندی کرده اید، پیکربندی کنید.

کلید فیلد Ticket را وارد کنید (به عنوان مثالrequest_email) در ورودی کلید. برای مقادیر، می توانید از فیلد های فرم، متا ورودی یا Add Custom Value که ورودی متنی را نشان می دهد و از برچسب های ادغام پشتیبانی می کند، انتخاب کنید.

شرایط وب هوک

اگر ایجاد Ticket مشروط به مقدار فیلد فرم باشد، کادر فعال کردن شرایط را انتخاب کرده و سپس قوانینی را که باید برای ارسال این درخواست رعایت شود پیکربندی کنید.

روش جایگزین

اگر مجوز Elite یا Legacy Developer ندارید و ترجیح می دهید مجوز موجود خود را به روز نکنید، با استفاده از فیلتر gform_after_submission در فایل theme.php یا پلاگین سفارشی خود می توانید Ticket هایی را در WSDesk ایجاد کنید.

نحوه پر کردن اسناد WebMerge با استفاده از افزونه Webhooks

معرفی

با استفاده از افزونه Gravity Forms Webhooks می توانید هنگام ارسال فرم مستندات WebMerge را پر کنید.

توجه: این مقاله فرض می کند شما افزونه Webhooks را نصب و فعال کرده اید و سندی را در حساب WebMerge خود ایجاد کرده اید. در غیر این صورت، قبل از استفاده از هر یک از قابلیت های این مقاله، لازم است این کار را انجام دهید.

پیکربندی Webhook

برای پیکربندی webhooks برای فرم، به تنظیمات فرم خود بروید و روی تب Webhooks کلیک کنید و سپس روی دکمه Add New کلیک کنید.

 

• نام

نامی برای فید خود وارد کنید. این می تواند هر چیزی که شما می خواهید باشد زیرا فقط برای اهداف شناسایی در صفحه لیست فیدها و گزارش افزونه مورد استفاده قرار می گیرد.

• URL درخواست

Merge URL را از تب Merge Documents WebMerge وارد کنید. به عنوان مثال، https://www.webmerge.me/merge/12345/abcde

هنگام انجام درخواست آزمایشی، پارامتر تست= ۱ را به URL اضافه کنید تا ادغام در اعتبارات ادغام حساب های شما حساب نشود، به عنوان مثال https://www.webmerge.me/merge/12345/abcde؟test=1

• روش درخواست

گزینه POST را به عنوان روش درخواست انتخاب کنید.

• فرمت درخواست

گزینه JSON را به عنوان فرمت درخواست انتخاب کنید.

• سرتیترهای درخواست

هیچ سرتیتر درخواستی برای پیکربندی هنگام ادغام با WebMerge وجود ندارد.

• متن درخواست

گزینه Select Fields را انتخاب کنید.

• مقادیر فیلد

ردیف ها را برای هر یک از فیلد های ادغام اسناد خود پیکربندی کنید. برای افزودن ردیف های جدید، روی آیکون افزودن (+) کلیک کنید.

شما می توانید کلیدهای مورد استفاده را در تب Test مستنداتWebMerge بیابید، آنها برچسب های بالای هر مقدار ورودی تست هستند، و فیلد ادغام JSON را در انتها نادیده می گیرند.

برای مقادیری می توانید از فیلد های فرم، متا ورودی یا Add Custom Value انتخاب کنید که ورودی متن را نشان می دهد و از برچسب های ادغام نیز پشتیبانی می کند.

شرایط وب هوک

اگر مقادیر سند WebMerge براساس مقادیر یک فیلد فرم مشروط باشد، کادر تأیید Enable Condition را انتخاب کنید و سپس قوانینی را که باید برای ارسال این درخواست رعایت شود پیکربندی کنید.

روش جایگزین

اگر مجوز Elite یا Legacy Developer ندارید و ترجیح می دهید مجوز موجود خود را به روز نکنید، با استفاده از یکی از روش های زیر می توانید اسناد WebMerge را پر کنید:

• دارندگان مجوز حرفه ای می توانند از افزونه Zapier استفاده کنند. برای مثال به مقاله پشتیبانی WebMerg Gravity Forms مراجعه کنید.
• هر کسی می تواند از فیلتر gform_after_submission در فایل theme.php یا پلاگین سفارشی استفاده کند. برای اطلاعات بیشتر به مقاله Populate a Living Will from Gravity Forms توسط WebMerge مراجعه کنید.