لمبے فارم کو مراحل میں بدلیں، اینڈ پوائنٹ بدلے بغیر

لمبا فارم سوالوں کا ایک ہی صفحہ ہوتا ہے، اور لوگ اسی ایک صفحے سے چلے جاتے ہیں۔ مراحل اسے اسکرینوں میں بانٹتے ہیں۔ جو وہ نہیں کرتے وہ اینڈ پوائنٹ بدلنا ہے: فارم اب بھی ایک بار جمع ہوتا ہے، ہر فیلڈ کے ساتھ، اسی پتے پر جو آپ کا مارک اپ پہلے ہی بتاتا ہے۔

مرحلہ پیشکش کا فیصلہ ہے

مرحلہ فارم کی فیلڈز کا ایک نامزد گروہ ہے جو جمع کرانے والے کو ایک وقت میں ایک اسکرین کے طور پر دکھایا جاتا ہے۔ فارم کو کئی مرحلوں میں بانٹنے سے وصولی، کوٹہ، اسپام اسکورنگ یا برقراری میں کچھ نہیں بدلتا: فیصل کرنے والے کو وہی باڈی ملتی ہے جو پہلے ملتی تھی، اور ایک جمع آوری ایک شمار شدہ جمع آوری ہی رہتی ہے۔

یہی پورا معاہدہ ہے، اسی لیے مرحلہ شامل کرنا پیشکش کی تبدیلی ہے، آپ کے انٹیگریشن کی نہیں۔ آپ کے HTML کا پتہ، آپ کے مارک اپ کی فیلڈ کے نام، اور آپ کے پلان پر جمع آوریوں کی گنتی — سب اپنی جگہ رہتے ہیں۔ مراحل بامعاوضہ پلانز پر دستیاب ہیں۔

وقفہ اسی فیلڈ کا ہے جو اس کے نیچے ہے

بلڈر میں مرحلے کا وقفہ اُس فیلڈ پر ایک نشان ہے جو اگلا مرحلہ کھولتا ہے — یعنی اُس فیلڈ کے اوپر کھینچی گئی لکیر جیسا۔ وہ فیلڈ کے ساتھ چلتا ہے، اس لیے فیلڈ کھینچنے پر وقفہ بھی اس کے ساتھ چلا جاتا ہے۔ مرحلے کا وقفہ دو سوالوں کے درمیان ڈالا گیا جدا کرنے والا نہیں ہے؛ وہ ایک فیلڈ کی خصوصیت ہے، اور فیلڈ کی فہرست اوپر سے پڑھنا مرحلوں کی ترتیب پڑھنا ہے۔

اس کے دو نتائج ہیں۔ فیلڈز کی ترتیب بدلنے سے مرحلوں کی ترتیب بدل جاتی ہے، اس لیے جو مرحلہ آپ کو پسند تھا وہ اوپر والے میں ضم ہو سکتا ہے۔ اور خالی مرحلہ بند ہو جاتا ہے: FormFlow ایسی اسکرین نہیں رکھتا جس پر کچھ نہ ہو۔

ایک POST ہر فیلڈ لے جاتا ہے

فارم ایک وقت میں ایک مرحلہ بناتا ہے، لیکن براؤزر اب بھی ایک ہی درخواست بھیجتا ہے۔ جمع کرانے والے نے جو کچھ جواب دیا، سب ایک ساتھ پہنچتا ہے، فارم کے اسکیما میں دیے فیلڈ ناموں کی کلیدوں کے ساتھ۔ اینڈ پوائنٹ کا حوالہ /docs/api میں ہے: ایک POST، ایک باڈی، ایک جواب۔

curl -X POST https://formflow.digital/api/v1/f/ff_live_example \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Lena Ortiz",
    "email": "lena@example.com",
    "company": "Ortiz Studio",
    "budget": "5000",
    "brief": "A one-page site, live in June."
  }'

پانچ فیلڈز، تین مراحل، ایک درخواست۔ اسکرینوں کے درمیان ملانے کے لیے کوئی ادھوری جمع آوری نہیں، دوبارہ کوشش کے لیے دوسری درخواست نہیں، اور ہر مرحلے کے لیے کوئی رسید نہیں۔ درخواست ناکام ہوئی تو کوشش ناکام ہوئی؛ کامیاب ہوئی تو FormFlow کے پاس ایک جمع آوری ہے اور وہ اسے ایک بار پرکھتا ہے۔

فارم کب ہموار بنتا ہے

فارم ہر فیلڈ کو ایک صفحے پر، ایک ہی جمع کرنے کے بٹن کے نیچے، تین صورتوں میں بناتا ہے: وہ کوئی مرحلہ قرار نہیں دیتا، ٹیم کا پلان اب ان کی اجازت نہیں دیتا، یا جمع کرانے والے کا براؤزر JavaScript نہیں چلاتا۔ ہموار بناوٹ بعد میں شامل کیا گیا متبادل نہیں؛ مراحل اسی کے گرد کی تہہ ہیں۔

جس کے اسکرپٹ بند ہیں اُسے وہی فیلڈز، وہی نام اور وہی جمع کرنے کا بٹن ملتا ہے — بس ایک ہی صفحے پر۔ فارم ٹوٹا نہیں، وہ صرف ایک صفحہ ہے۔ پلان بدلنے سے مراحل کا ختم ہونا بھی کوئی منتقلی نہیں: فارم اپنے اسکیما میں مراحل رکھتا ہے، اجازت نہ ہونے تک ہموار بنتا ہے، اور اجازت لوٹنے پر پھر مرحلوں میں بنتا ہے۔

جہاں مراحل کند ہیں

مراحل اسکیما کو چھپاتے بھی نہیں۔ آپ جو کچھ قرار دیتے ہیں وہ معاہدے میں ہے، چاہے کوئی اسکرین اسے دکھائے یا نہ دکھائے، اور کون سی فیلڈز نظر آ رہی ہیں اس بارے میں براؤزر کی رائے کبھی طے نہیں کرتی کہ کیا قبول ہوگا۔ اگر کسی فیلڈ کو صرف نظر سے اوجھل نہیں بلکہ غائب ہونا چاہیے، تو اسے قرار نہ دیں۔

v1.0.0 کی تبدیلیوں کے ریکارڈ کا اندراج وہ جملہ درج کرتا ہے جس پر یہ سب کھڑا ہے: کوئی بھی HTML فارم FormFlow کی طرف موڑیں، یا میزبان صفحہ یا ایمبیڈ استعمال کریں، اور وہ ہر جمع آوری وصول، چھانٹ، محفوظ اور آگے بھیجتا ہے۔ مراحل اُس جملے کے درمیان کی ترتیب بدلتے ہیں۔ اسے لمبا نہیں کرتے۔