این راهنما توضیح می‌دهد تاییدیه در فرم رزرو چه نقشی دارد، بوکلیو چه تمپلیت‌هایی را به‌صورت خودکار می‌سازد و در چه شرایطی پیام رزرو موفق یا رزرو ناموفق به کاربر نمایش داده می‌شود.
تاییدیه در گرویتی‌فرمز چیست
تاییدیه همان پیامی است که بعد از ارسال فرم به کاربر نمایش داده می‌شود. در فرم‌های رزرو بوکلیو، این بخش فقط یک پیام ساده بعد از سابمیت نیست؛ نتیجه واقعی رزرو و پرداخت هم روی آن اثر می‌گذارد.
به همین دلیل باید بین تاییدیه و اعلان فرق بگذارید. تاییدیه روی همان صفحه یا مسیر بعد از ارسال فرم دیده می‌شود، اما اعلان برای ارسال پیام ایمیلی یا پیامکی و پیگیری رویدادها استفاده می‌شود.
بوکلیو چه زمانی تاییدیه‌های خودش را به فرم اضافه می‌کند
هر فرمی که فیلد رزرو بوکلیو داشته باشد، در منطق افزونه به‌عنوان فرم رزرو شناخته می‌شود. برای این فرم‌ها، بوکلیو دو تاییدیه مدیریت‌شده را به‌صورت خودکار در فرم نگه می‌دارد:
بوکلیو - رزرو موفقبوکلیو - رزرو ناموفق
این دو ردیف بخشی از منطق خود محصول هستند و فقط یک نمونه‌ی تزئینی در لیست تاییدیه‌ها نیستند.
تمپلیت رزرو موفق چه چیزی نشان می‌دهد
تمپلیت موفق به‌صورت یک پیام سبز و ساختاریافته نمایش داده می‌شود و اطلاعات اصلی رزرو را به کاربر نشان می‌دهد. در متن پیش‌فرض آن این موارد دیده می‌شود:
- کد رزرو
- نام خدمت
- تاریخ و ساعت رزرو
- نام ارائه‌دهنده
- واحد یا منبع
- روش پرداخت
- مبلغ قابل پرداخت
این اطلاعات با مرج‌تگ‌های اختصاصی بوکلیو مانند {bko_reservation_code} و {bko_datetime} داخل خروجی جایگزین می‌شوند.
تمپلیت رزرو ناموفق چه چیزی نشان می‌دهد
تمپلیت ناموفق با ظاهر هشدار/خطا نمایش داده می‌شود و به کاربر می‌گوید ثبت یا پرداخت رزرو کامل نشده است. متن پیش‌فرض آن همچنین به بازگشت وجه بانکی تا ۷۲ ساعت در صورت کسر مبلغ اشاره می‌کند.
پس این تاییدیه فقط برای خطای ظاهری فرم نیست، بلکه برای سناریوی شکست واقعی در ثبت یا پرداخت رزرو به کار می‌رود.
بوکلیو چطور بین «موفق» و «ناموفق» تصمیم می‌گیرد
در فرم‌های رزرو محلی، بوکلیو در مرحله تاییدیه نتیجه را از روی وضعیت رزرو و وضعیت پرداخت تشخیص می‌دهد. اگر نتیجه پرداخت unsuccess باشد یا وضعیت رزرو به حالت‌هایی مثل failed، rejected یا expired برسد، تاییدیه ناموفق نمایش داده می‌شود.
در بقیه‌ی خروجی‌های موفق، تاییدیه موفق نمایش داده می‌شود. برای پرداخت‌های کیف پول و سناریوهای ترکیبی نیز یک منطق پشتیبان وجود دارد تا اگر رکورد رزرو هنوز همان لحظه قابل خواندن نبود، باز هم پیام درست انتخاب شود.
آیا تاییدیه‌های ریدایرکت هم جایگزین می‌شوند
خیر. اگر تاییدیه فرم از نوع ریدایرکت باشد، بوکلیو آن را دست‌کاری نمی‌کند. این رفتار برای سازگاری با افزونه‌های درگاه و سناریوهای پرداخت آنلاین مهم است، چون بعضی از آن‌ها بعد از ارسال فرم مسیر انتقال خودشان را دارند.
در عمل، تمپلیت‌های مدیریت‌شده‌ی بوکلیو بیشتر برای خروجی‌های پیام‌محور و لوکال کاربرد دارند، نه برای ریدایرکت‌های درگاه.
کار با این تاییدیه‌ها در پنل فرم چگونه است
- فرم رزرو را در گرویتی‌فرمز باز کنید.
- به بخش
Confirmationsبروید. - دو ردیف
بوکلیو - رزرو موفقوبوکلیو - رزرو ناموفقرا ببینید. - اگر تاییدیه‌های دیگری دارید، آن‌ها را از این دو سناریوی اصلی جدا نگه دارید.
در اینجا مهم است بدانید این دو تمپلیت «مدیریت‌شده» هستند. یعنی بوکلیو آن‌ها را فقط یک‌بار نمی‌سازد و رها نمی‌کند؛ در ذخیره فرم و بک‌فیل فرم‌های قدیمی، پیکربندی اصلی آن‌ها را حفظ می‌کند.
آیا می‌توان این دو تمپلیت را آزادانه ویرایش کرد
از نظر رابط کاربری ممکن است دکمه ویرایش ببینید، اما این دو تمپلیت بخشی از رفتار کنترل‌شده‌ی افزونه هستند. بوکلیو نام، نوع، پیام و فعال‌بودن آن‌ها را به شکل canonical نگه می‌دارد و تنظیمات منطق شرطی آن‌ها را هم از UI پنهان می‌کند.
در نتیجه اگر به پیام‌های کاملا سفارشی برای سناریوهای خاص نیاز دارید، بهتر است یک تاییدیه عادی جدید بسازید و آن را با این دو ردیف سیستمی اشتباه نگیرید.
چرا منطق شرطی برای این دو تاییدیه دیده نمی‌شود
در کد افزونه، تنظیمات conditionalLogic برای تاییدیه‌های مدیریت‌شده‌ی بوکلیو از صفحه تنظیمات تاییدیه حذف می‌شود. دلیلش این است که انتخاب موفق یا ناموفق توسط خود بوکلیو انجام می‌شود و نمایش شرط‌های عادی گرویتی‌فرمز در اینجا می‌تواند گمراه‌کننده باشد.
مرج‌تگ‌های مهم داخل تاییدیه‌ها
بوکلیو مجموعه‌ای از مرج‌تگ‌های اختصاصی را به گرویتی‌فرمز اضافه می‌کند. در تاییدیه موفق، این چند مورد بیشترین کاربرد را دارند:
{bko_reservation_code}{bko_service}{bko_datetime}{bko_employee}{bko_resource}{bko_payment_method}{bko_total_amount}
اگر می‌خواهید با مرج‌تگ‌ها بیشتر آشنا شوید، مقاله مرج‌تگ‌های بوکلیو را هم ببینید.
اثر این تاییدیه‌ها روی تجربه کاربر چیست
تاییدیه موفق باعث می‌شود کاربر همان لحظه خلاصه رزرو را ببیند و مطمئن شود رزرو ثبت شده است. تاییدیه ناموفق هم مسیر انتظار کاربر را اصلاح می‌کند و جلوی این سوءبرداشت را می‌گیرد که صرف ارسال فرم به معنای تکمیل رزرو بوده است.
به زبان ساده، این دو تاییدیه مرز بین ارسال فرم و نتیجه واقعی رزرو را برای کاربر روشن می‌کنند.
برای تست تاییدیه‌ها چه کار کنیم
- یک فرم رزرو دارای فیلد بوکلیو بسازید یا باز کنید.
- یک رزرو موفق آزمایشی ثبت کنید و خروجی نهایی را ببینید.
- یک سناریوی ناموفق پرداخت یا رزرو شکست‌خورده را شبیه‌سازی کنید.
- بررسی کنید در حالت موفق، جزئیات رزرو جایگزین شده باشند.
- بررسی کنید در حالت ناموفق، پیام هشدار بوکلیو نمایش داده شود.