Event Progress bar

-
بله، قضیه از این قرار است!

قصه ای که امشب قراره براتون تعریف کنم، از نحوه کارکرد progress bar در رویدادهامون هست.

هدف از وجود progress bar بر این اساس بود  که کاربر رو تشویق کنیم تا برگزار کننده هامون یه سری از قابلیت هایی که رویدادها دارن رو فعال و ازش استفاده کنن تا به این نحو بتوانیم بر کیفیت رویدادها بیفزاییم.

لیست آیتم ها
یه سری آیتم که الان داریمشون و قصد تشویق کاربر به استفاده ازشون داریم به این شرح است:

  • توضیح رویداد
  • ایمیل دعوت‌نامه
  • همکاری در فروش
  • تبلیغات (خرید تبلیغات وندو)
  • لوگو و کاور سازمان رویدادها
  • نظرسنجی


آیتم هایی که برایتون لیست کردم از جمله آیتم هایی است که الان داریمشون.
ممکنه برگزار کننده این آیتم ها رو پر کرده /فعال کرده باشه و یا نکرده باشه. و همچنین ترتیبی خواهند داشت به ترتیب تغریف شده نیاز به نمایششان خواهد بود.

هر کدام از این آیتم ها توضیحاتی در برخواهد داشت که اینا از طرف کلاینت (فرانت/ موبایل) هامون هندل می شه.
از آنجایی که در کنار توضیحات نیاز به لینک به دیگر بخش ها هست و متاسفانه بک نمی تونست درگیر تولید لینک فرانتی یا موبایلی باشه از این رو تعیین این موارد سمت فرانت قرار گرفته است.
البته توضیحات رو می شد به سمت بک برد ولی خوب لینک ها معقول نیست.

لیست آیتم های Progress Bar
برای دریافت اطلاعات مربوط به ریسورس زیر درخواستی مناسب رو ارسال می کنیم:
GET https://api.evand.com/events/EVENT_SLUG/progress
Headers:
  • Authorization: Bearer ACCESS_TOKEN

{
  "data": {
    "items": [
      {
        "key": "event_description",
        "order": 1,
        "done": true
      },
      {
        "key": "email_invitation",
        "order": 2,
        "done": false
      },
      {
        "key": "affiliate",
        "order": 3,
        "done": true
      },
      {
        "key": "advertisement",
        "order": 4,
        "done": false
      },
      {
        "key": "organization_cover_and_logo",
        "order": 5,
        "done": false
      },
      {
        "key": "survey",
        "order": 6,
        "done": false
      }
    ],
    "total_items": 6,
    "total_done_items": 2,
    "total_undone_items": 4,
    "progress_percentage": 33
  }
}

همانطوری که از دیتای برگشتی از ریسورس مربوطه مشخص هست، یه سری آیتم ها داریم که با استفاده از فیلد key از همدیگه مجزا می شوند.
ترتیب نمایش آیتم ها توسط فیلد order تعیین می شه.
فیلد done بدین منظور هست که آیتم مربوطه انجام و تمام شده است.

متادیتا

….
    "total_items": 6,
    "total_done_items": 2,
    "total_undone_items": 4,
    "progress_percentage": 33
  }
}

همانطور که مشاهده می کنید یه سری متادیتا داریم که اشاره به تعداد کل آیتم ها (total_items) داره.
تعداد آیتم های انجام شده و یا تکمیل شده (total_done_items). و همچنین تعداد آیتم های انجام نشده (total_undone_items).
و در نهایت درصد کارهای انجام شده که با استفاده از progress_percentage مشخص می باشد.


نکته:
  • برای دریافت دیتای فوق، نیازه هست که slug رویداد رو در ریسورس مربوطه جاگذاری نمایید.
  • تنها برگزار کننده و یا افرادی که دسترسی های لازم رو دارن می تونن لیست مربوطه رو دریافت و ملاحظه نمایند که برای این منظور نیاز است توکن اهراز هویت از طریق هدر ارسال شود.


نظرات

ارسال یک نظر

پست‌های معروف از این وبلاگ

استفاده از Refresh Token جهت دریافت توکن‌های معتبر جدید (کانکت)

-
سلامی مجدد و با شکوه در صورتی که اعتبار access token موجودتان از بین بره و منقضی بشه، نیاز خواهید داشت که با استفاده از refresh token درخواست توکن‌های معتبر جدید بدید. فقط توجه کنید که refresh token هم می تونه اعتبارش رو از دست بده و منقضی بشه که دیگه کاری براش نمی شه کرد و فقط می شه کاربر رو دوباره از مراحل احراز هویت گذروند. ولی در صورتی که توکن معتبر داشته باشید می تونید درخواستتان را به این شکل به ریسورس مربوطه ارسال نمایید: POST https://connect.evand.com/api/oauth2/token { "grant_type": " refresh_token ", "client_id": "client_test", "client_secret": "test", "refresh_token": " XXXXX...... " } دیتاهایی که نیازه به این فیلد بفرستید به این شرح هستن: فیلد grant_type تعیین کننده، نوع درخواست توکن هست که اینجا برای رفرش کردن توکن ها نیازه مقدار refresh_token تعیین بشه. فیلدهای client_id و client_secret اطلاعات مربوط به کلاینت مربوطه است که جداگانه در اختیارشان قرار ...
بیشتر بخوانيد

لیست کاربران نشان شده - سرویس کانکت

-
برای دریافت لیست کاربران نشان شده درخواست GET به ریسورس مورد نظر ارسال می کنید: GET https://connect.evand.com/api/ bookmarks/users {   "_total_items": 1,   "_page": 1,   "_page_count": 1,   "_links": {     "self": {       "href": "https://connect.evand.com/api/bookmarks/users?page=1"     }   },   "_embedded": {     " public_user ": [       {         "name": "hossein",         "surname": "baghayi",         "avatar": "https://static.evand.net/connect/user/profile/4db4fc4d-2cf3-4332-92a7-14fc218ed45d.jpeg",         "biography": "web developer",         "jobTitle": null,         "organization": ":’(",         "website": null,         "telegram": null,         "linkedin": null, ...
بیشتر بخوانيد

بلیت خریداری شده کاربر در رویداد

-
برای ورود و استفاده از سرویس کانکت، نیاز به تهیه بلیت ای از رویداد مد نظر هست. از این رو، کلاینت ها جهت بهبود و تسریع فرایند ورود نیاز به دانستن این دارن که بدونن آیا کاربر مربوطه بلیت ای از رویداد مد نظر تهیه کرده است یا خیر! در اصل بلیت های خریداری شده از ریسورس هایی در دسترس است ولی نیاز به جست و جو و فرایند هایی بسیار دشوار و طاقت فرسایی برای کلاینت ها پیش رو دارد که هر انسانی رو به گریه و زاری وا می دارد. هدف از این تسک تسهیل این امر می باشد. هدفی که در نهایت باعث شادی و خرسندی بچه های کلاینت می شود. بچه های دوست داشتنی، بچه های قوقول مقولی و نی ناش ناش. راه حل ارائه شده بدین شکل است که در صورتی که کاربر (نه مهمان) باعث بارگزاری دیتاهای مربوط به رویدادی شود (GET /events/SLUG) در بتن اطلاعات رویداد، لینکی به بلیت خریداری شده کاربر خواهد بود. این لینک در صورتی که کاربری بلیت ای از رویداد مد نظر تهیه نکرده باشد، مقداری نخواهد داشت و برابر null خواهد بود. GET https://api.evand.com/events/SLUG و خروجی بدین شکل خواهد بود: {   "data": {     ...
بیشتر بخوانيد