فرمها
فرمهای آماده برای تماس، درخواست قیمت، رزرو و ثبتنام. هوش مصنوعی با یک component آن را درج میکند — بدون نیاز به نوشتن submit handler — و هر پاسخ در صندوق ورودی پاسخها اپ شما قرار میگیرد.
فرمها در Proyecta یک قابلیت هستند، نه چیزی که هوش مصنوعی آن را دستی کدنویسی کند. هر وقت اپ شما نیاز داشته باشد که بازدیدکنندگان بتوانند با شما ارتباط برقرار کنند — فرم تماس، درخواست قیمت، رزرو وقت، یا ثبتنام در رویداد — Proyecta یک تعریف فرم آماده ایجاد میکند و آن را از طریق یک block متعلق به قالب نمایش میدهد. اعتبارسنجی، وضعیت موفقیت، ذخیره پاسخها و اطلاعرسانی به صاحب اپ همه بهصورت خودکار فراهم میشوند.
پیشتنظیمها
Section titled “پیشتنظیمها”هر فرم از یکی از پنج پیشتنظیم داخلی شروع میشود. کافی است فرم مورد نظر خود را توصیف کنید تا Proyecta گزینه مناسب را انتخاب (و تطبیق) دهد — هرگز نیازی به ساخت فیلدها از صفر نخواهید داشت.
| پیشتنظیم | آیدی api form |
کاربرد | همراه با |
|---|---|---|---|
| Contact | contactForm |
“با ما تماس بگیرید” عمومی: نام، ایمیل، تلفن اختیاری، پیام | اطلاعات کسبوکار |
| Quote | quoteForm |
درخواست قیمت: اطلاعات تماس + نوع سرویس + جزئیات کار | خدمات |
| Booking | bookingForm |
رزرو وقت / نوبت: سرویس، تاریخ و زمان دلخواه، اطلاعات تماس | خدمات |
| Registration | registrationForm |
ثبتنام در رویداد یا دوره (RSVP): اطلاعات شرکتکننده + یادداشت | رویدادها |
| Order | orderForm |
ثبت سفارش: آنچه مشتری میخواهد، اطلاعات تماس، یادداشتها | منو، کاتالوگ |
میتوانید چند فرم در یک اپ داشته باشید (مثلاً یک فرم تماس و یک فرم رزرو)، و هوش مصنوعی میتواند فیلدها را در هر کدام اضافه، تغییر نام یا بازطراحی کند.
نحوه اتصال توسط هوش مصنوعی
Section titled “نحوه اتصال توسط هوش مصنوعی”هوش مصنوعی هیچگاه فرم یا submit handler را دستی نمیسازد. <FormBlock/> متعلق به قالب را درج کرده و آن را از طریق id یا api id به یک فرم متصل میکند:
import { FormBlock } from '@/components/blocks/FormBlock';
// در هر جایی از یک صفحه عمومی — بخش تماس، پنل "درخواست قیمت" و غیره<FormBlock form="contactForm" />;<FormBlock/> همه کارها را بهتنهایی انجام میدهد:
- فیلدها را بر اساس نوع رندر میکند — متن / ایمیل / تلفن بهصورت input، متن طولانی بهصورت textarea، گزینهها بهصورت dropdown، موافقتها بهصورت checkbox، تاریخ و زمان بهصورت picker بومی، و فیلدهای فایل بهصورت کنترل “پیوست فایل”.
- در browser اعتبارسنجی میکند — فیلدهای اجباری پیش از ارسال هر چیزی بررسی میشوند.
- روی server اعتبارسنجی میکند — اگر server مقداری را رد کند، خطای مربوطه درست کنار همان فیلد نمایش داده میشود (بدون از دست رفتن پاسخ، بدون شکستهای خاموش).
- وضعیت موفقیت را نمایش میدهد — پس از ارسال، فرم با یک پیام تأیید صمیمانه (پیام تأیید خود فرم) جایگزین میشود و گزینهای برای ارسال پاسخ دیگر نیز وجود دارد.
- ایمن شکست میخورد — اگر فرم وجود نداشته باشد یا غیرفعال شده باشد، block هیچ چیزی رندر نمیکند، بنابراین هرگز صفحه عمومی را خراب نمیکند.
از آنجا که block متعلق به قالب است، کار هوش مصنوعی فقط قرار دادن آن و استایلدهی به بخش اطراف آن است — لولهکشی پشت آن ثابت و صحیح است.
پیوست فایل
Section titled “پیوست فایل”فرمها میتوانند یک فایل آپلودشده (یک رسید، یک عکس مرجع، یک بریف) دریافت کنند. فیلدهای فایل یک دکمه “پیوست فایل” نمایش میدهند، فایل را در storage آپلود کرده و URL عمومی آن را در پاسخ قرار میدهند. محدودیتها بهصورت خودکار اعمال میشوند:
- فقط تصویر و PDF، حداکثر 5 MB (تصاویر بزرگ ابتدا در browser کوچک میشوند).
- دکمه ارسال در حین آپلود فایل غیرفعال است، بنابراین هیچ پاسخی نیمهکاره ارسال نمیشود.
محل ذخیره پاسخها
Section titled “محل ذخیره پاسخها”هر پاسخ ذخیره شده و در صندوق ورودی پاسخهای اپ شما نمایش داده میشود — بخشی از پنل ادمین، که توسط <SubmissionsInbox/> قالب رندر میشود. از آنجا شما (صاحب اپ) میتوانید:
- پاسخها را در تبهای New / Read / Archived مرور کنید، با یک badge خواندهنشده روی New.
- هر پاسخ را باز کنید تا مقادیر فیلدهای ارسالشده، صفحهای که از آن آمده و تاریخ را ببینید.
- یک پاسخ را read علامت بزنید، به new برگردانید یا archive کنید.
- صندوق ورودی را به یک فرم خاص محدود کنید یا پاسخهای همه فرمها را در یک لیست ببینید.
صندوق ورودی فقط برای ادمین است — خواننده باید با یک حساب ادمین وارد شده باشد (روی server اعمال میشود).
دریافت ایمیل برای هر پاسخ
Section titled “دریافت ایمیل برای هر پاسخ”فرمها میتوانند هر بار که کسی پاسخ ارسال کند، به شما ایمیل بدهند — اطلاعرسانی به صاحب را فعال کنید و آدرسی که باید آنها را دریافت کند را تنظیم کنید. سرنخ را در صندوق ورودی خود دریافت میکنید بدون اینکه نیاز باشد اپ را باز کنید. ایمیل از طریق قابلیت ایمیل Proyecta ارسال میشود، بنابراین بدون هیچ تنظیمات اضافهای کار میکند.
الگوهای رایج (بگذارید هوش مصنوعی آن را متصل کند)
Section titled “الگوهای رایج (بگذارید هوش مصنوعی آن را متصل کند)”"یک فرم تماس با نام، ایمیل و پیام به footer اضافه کن، و هر بار که کسی ارسال کرد برایم به hello@mybiz.com ایمیل بزن.""یک فرم 'درخواست قیمت' در هر صفحه خدمات قرار بده که بپرسد به کدام سرویس نیاز دارند و جزئیات کار چیست.""یک فرم رزرو اضافه کن تا مشتریان بتوانند با تاریخ و زمان دلخواه وقت بگیرند.""یک فرم ثبتنام رویداد برای صفحه کارگاه بساز و به شرکتکنندگان اجازه بده یک PDF پیوست کنند.""صندوق ورودی پاسخها را نشانم بده و فقط آنهایی که هنوز نخواندهام."
- مدیریت محتوا — فرمها در کنار collectionهای شما در همان مدل محتوا قرار دارند.
- پنل ادمین — جایی که پاسخها بررسی میشوند.
- ایمیلها — نحوه ارسال ایمیلهای اطلاعرسانی به صاحب اپ.