افزونه انتقال داده بین فرم‌های گرویتی پرکس | Gravity Perks – Gravity Forms Easy Passthrough

افزونه انتقال داده بین فرم‌های گرویتی پرکس (Gravity Forms Easy Passthrough) داده‌هایی را که بازدیدکننده در یک فرم گرویتی فرمز پر کرده، در فیلدهای فرم دیگری می‌نویسد، بی‌آنکه برای هر فیلد پارامتری بنویسید. سازنده‌اش Gravity Wiz است و برای اجرا به گرویتی فرمز و گرویتی پرکس نیاز دارد؛ منوی گرویتی پرکس در پیشخوان با نام Spellbook آمده است.

فروشگاه وردپرس نیاز این افزونه را در دسته خرید افزونه وردپرس دارد. گرویتی فرمز، Spellbook و این افزونه را روی یک وردپرس فارسی تازه نصب کردیم؛ در ادامه «نصب آزمایشی» همین وردپرس است.

تنظیم Gravity Forms Easy Passthrough در فرم مقصد

تنظیم روی فرمی است که باید پر شود، یعنی فرم مقصد. در تنظیمات همین فرم تب Easy Passthrough اضافه می‌شود. با دکمه Add New یک پیکربندی می‌سازید، فرم مبدا را انتخاب می‌کنید و فیلدها را به هم وصل می‌کنید. سازنده نوشته که فیلدهای هم‌نام خودشان انتخاب می‌شوند و در نصب آزمایشی هم همین شد: بعد از انتخاب فرم مبدا، پنج فیلدی که برچسب یکسان داشتند به هم وصل شده بودند. در فرم مقصد دیگری که شماره فیلدهایش فرق داشت و فیلد «نوع بسته» را نداشت هم برچسب‌ها تعیین کردند: چهار فیلد وصل شد و ردیف «نوع بسته» بی‌مقصد ماند.

انتقال در همان مرورگر و با پیوند توکن‌دار

در نصب آزمایشی بازدیدکننده‌ای که وارد پیشخوان نشده بود فرم اول را با پنج فیلد پر کرد و فرستاد: یک متن، یک ایمیل، یک فهرست شهر، یک گزینه رادیویی و یک پاراگراف. همان مرورگر بعد فرم دوم را باز کرد و هر پنج فیلد پر بودند. فیلد ششم فرم دوم، که در فرم اول وجود نداشت، خالی ماند. گزینه رادیویی‌ای که در نامش نیم‌فاصله دارد («حرفه‌ای») هم درست انتخاب شد. مقدارها را برای آزمایش وارد کردیم.

برای انتقال بین نشست‌ها، افزونه به ورودی‌ها توکن می‌دهد و در نصب آزمایشی این توکن همراه ورودی ذخیره شد. سازنده می‌نویسد که توکن با برچسب ادغام Easy Passthrough Token در پیوند تأییدیه یا اعلان فرم می‌آید؛ ما فقط تأییدیه را امتحان کردیم. تأییدیه فرم اول را برای آزمایش خودمان نوشتیم و در آن پیوندی به صفحه فرم دوم گذاشتیم که توکن را در پارامتر ep_token می‌برد. باز کردن همین پیوند در مرورگری تازه، که فرم اول را در آن نفرستاده بودیم، فرم دوم را با همان مقدارها پر کرد. فرم دوم بدون توکن و بدون ارسال قبلی خالی بود، و با افزونه‌ای که خاموش شده بود، پیوند توکن‌دار هم چیزی پر نکرد.

شرط، اطلاعات ورودی و کاربر واردشده

با شرط می‌توانید فقط ورودی‌های مشخصی را منتقل کنید. در نصب آزمایشی شرط «شهر برابر تبریز است» را با اسکریپت روی تنظیمات افزونه گذاشتیم. بازدیدکننده‌ای که شهر را روی گزینه اول، شیراز، گذاشته بود، فرم دوم را خالی دید و بازدیدکننده‌ای که تبریز را انتخاب کرد، آن را پر دید.

در بخش Map Entry Meta می‌توانید اطلاعات خود ورودی را هم به فیلد فرم مقصد برسانید. فهرست آن در کد افزونه شناسه ورودی، تاریخ ورودی، آی‌پی کاربر، نشانی منبع و عنوان فرم را دارد، و گروهی هم برای اطلاعات پرداخت. در نصب آزمایشی شناسه ورودی را با اسکریپت به فیلد «کد پیگیری» فرم دوم وصل کردیم و آن فیلد عدد ۳ را گرفت، یعنی شناسه همان ورودی.

گزینه‌ای هم هست برای استفاده از آخرین ورودی کاربر واردشده (Use logged in user’s last submitted entry). در نصب آزمایشی کاربری که با ورود دو بار فرم اول را فرستاده بود، در مرورگری تازه دوباره وارد شد و فرم دوم با ورودی دومش پر بود، نه با ورودی اول. وقتی این گزینه خاموش بود، همان کاربر در مرورگری تازه و دیگر فرم دوم را خالی دید. این گزینه را هم با اسکریپت روی تنظیمات افزونه ثبت کردیم.

پیش از خرید

افزونه به Spellbook وابسته است. وقتی Spellbook در نصب آزمایشی خاموش بود، صفحه افزونه‌ها زیر همین افزونه پیام «This plugin requires Gravity Perks» را چاپ کرد و تب Easy Passthrough از تنظیمات فرم رفت.

سازنده این محدودیت‌ها و نکته‌ها را می‌نویسد:

• داده‌ای به فرمی که با توکن Save & Continue پر می‌شود منتقل نمی‌شود.
• داده فیلد کارت Stripe منتقل نمی‌شود، چون این فیلد رمزگذاری می‌شود.
• مقدار گزینه‌های فیلدهای انتخابی باید در دو فرم دقیقاً یکی باشد، با رعایت حروف بزرگ و کوچک.
• بازدیدکننده‌ای که وارد نشده به نشست PHP وابسته است که ممکن است منقضی شود؛ برای انتقال مطمئن پیوند تأییدیه را با توکن بسازید.
• کش صفحه می‌تواند انتقال را مختل کند.

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

اگر نمی‌خواهید خودتان گرویتی فرمز، Spellbook و این افزونه را نصب و راه‌اندازی کنید، خدمات نگهداری و عیب‌یابی سایت در فهرست خود خدمتی با نام «نصب قالب و راه‌اندازی افزونه» دارد.

در کل، این افزونه مقدار فیلدهای یک فرم گرویتی فرمز را در فرم دیگر می‌نویسد، در همان مرورگر، با پیوند توکن‌دار یا از روی آخرین ورودی کاربر واردشده؛ لازمه‌اش فعال بودن گرویتی فرمز و Spellbook است.