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

ذخیره ایمیل

این عملکرد ایمیل کاربر واردشده را تغییر می‌دهد. مقدار از یک متغیر خوانده می‌شود تا بتوانید فرم دلخواه خودتان را بسازید.

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

این عملکرد بخشی از مجموعه‌ای است که طراحی آزاد صفحه پروفایل را ممکن می‌کند.

کاربردها

  • ساخت فرم «تغییر ایمیل» با ظاهر دلخواه.
  • گرفتن ایمیل از کاربری که با موبایل عضو شده است.
  • تکمیل پروفایل پیش از ارسال فاکتور یا خبرنامه.

تنظیمات

  • متغیر ایمیل: نام متغیری که ایمیل جدید را نگه می‌دارد.
important

در این فیلد نام متغیر را وارد کنید، نه ایمیل.

نتیجه اجرا

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

جریان تأیید کد

بسته به تنظیمات حساب کاربری، سرور ممکن است پس از ثبت ایمیل یک کد تأیید بفرستد. در این حالت پنجره ورود کد به‌صورت خودکار باز می‌شود و ایمیل فقط پس از تأیید درست ذخیره می‌شود. بستن پنجره یا کد اشتباه یعنی sys.user.saveSuccess برابر false.

توجه

تا وقتی کد تأیید نشده باشد، ایمیل روی حساب کاربر عوض نمی‌شود.

توضیحات

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

نکات تکمیلی

  • برای فیلد ایمیل از ویجت فیلد متنی فرم با نوع ایمیل استفاده کنید تا صفحه‌کلید مناسب باز شود.
  • بعد از ذخیره موفق، sys.user.email به‌روز می‌شود.

خطاهای رایج

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