پرش به مطلب اصلی

ورود به حساب کاربری

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

اگر تنظیمات اپ روی ورود با رمز یکبارمصرف باشد، پنجره کد تأیید به‌صورت خودکار باز می‌شود.

راهنمای کامل: طراحی آزاد فرم ورود و عضویت.

کاربردها

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

تنظیمات

  • متغیر موبایل یا ایمیل: نام متغیری که شناسه کاربر را نگه می‌دارد.
  • متغیر رمز عبور: نام متغیری که رمز را نگه می‌دارد.
important

در این فیلدها نام متغیر را وارد کنید، نه مقدار. رمز هرگز داخل تنظیمات اپ ذخیره نمی‌شود و فقط در زمان اجرا از متغیر خوانده می‌شود.

نتیجه اجرا

متغیرمقدار
sys.user.saveSuccesstrue در صورت ورود موفق، false در صورت خطا
sys.user.saveErrorپیام خطا؛ در صورت موفقیت خالی می‌شود

پس از ورود موفق، نشست کاربر ذخیره می‌شود، رویداد ورود اجرا می‌گردد و همه متغیرهای sys.user.* مقدار می‌گیرند.

ورود با رمز یکبارمصرف

اگر نوع احراز هویت اپ روی «موبایل و رمز یکبارمصرف» باشد:

  1. متغیر رمز نادیده گرفته می‌شود.
  2. سرور یک کد به موبایل کاربر می‌فرستد و پنجره ورود کد خودکار باز می‌شود.
  3. نشست فقط پس از تأیید کد ساخته می‌شود.
انصراف کاربر

اگر کاربر پنجره کد تأیید را ببندد، هیچ‌کدام از دو متغیر نتیجه تغییر نمی‌کنند. انصراف نه موفقیت است و نه خطا.

توضیحات

  • ارقام فارسی و عربی به‌صورت خودکار به ارقام انگلیسی تبدیل می‌شوند.
  • درست بودن قالب شناسه، وجود کاربر و درستی رمز همگی روی سرور بررسی می‌شوند. پیام‌هایی مثل «موبایل یا رمز عبور اشتباه است»، «حساب کاربری شما مسدود است» یا «امکان عضویت غیرفعال است» در sys.user.saveError قرار می‌گیرند.
  • اگر متغیر شناسه خالی باشد، درخواستی به سرور فرستاده نمی‌شود.
  • برای اجرا به اینترنت نیاز است.

نکات تکمیلی

  • سریع‌ترین راه ساخت این فرم، افزودن بلوک آماده فرم ورود از مسیر حساب کاربری ← بلوک‌های حساب کاربری است؛ فیلدها، دکمه و متن خطا از قبل به هم وصل‌اند.
  • برای رفتن به صفحه عضویت یا بازیابی رمز، از ورود به صفحه عضویت و ورود به صفحه بازیابی رمز استفاده کنید.
  • برای بستن صفحه ورود پس از موفقیت، از عملکرد چندگانه استفاده کنید و «بستن صفحه» را با شرط sys.user.saveSuccess == true بگذارید.

خطاهای رایج

  • وارد کردن مقدار ثابت به‌جای نام متغیر.
  • نمایش ندادن sys.user.saveError؛ در این حالت کاربر دلیل ناموفق بودن ورود را نمی‌بیند.
  • نمایش پیام موفقیت بدون بررسی sys.user.saveSuccess، در حالی که کاربر پنجره کد تأیید را بسته است.