হোমপেজ

হোমপেজ হল একটি নতুন Google Workspace অ্যাড-অন বৈশিষ্ট্য যা এক বা একাধিক অ-প্রসঙ্গিক কার্ডগুলিকে সংজ্ঞায়িত করার ক্ষমতা প্রদান করে। ব্যবহারকারী যখন একটি নির্দিষ্ট প্রেক্ষাপটের বাইরে থাকে, যেমন ব্যবহারকারী যখন তাদের Gmail ইনবক্স দেখছে কিন্তু কোনো বার্তা বা খসড়া খোলেনি তখন ব্যবহারকারীর ইন্টারফেস প্রদর্শন করতে নন-প্রসঙ্গগত কার্ড ব্যবহার করা হয়।

হোমপেজগুলি আপনাকে নন-প্রাসঙ্গিক বিষয়বস্তু দেখাতে দেয়, ঠিক যেমন দ্রুত-অ্যাক্সেস সাইড প্যানেলে (কিপ, ক্যালেন্ডার এবং টাস্ক) Google অ্যাপস। হোমপেজগুলি একটি প্রাথমিক শুরুর স্থানও প্রদান করতে পারে যখন একজন ব্যবহারকারী প্রথম আপনার অ্যাড-অনটি খোলে এবং নতুন ব্যবহারকারীদের কীভাবে আপনার অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করতে হয় তা শেখানোর জন্য দরকারী।

আপনি আপনার প্রোজেক্ট ম্যানিফেস্টে এটি নির্দিষ্ট করে এবং এক বা একাধিক homepageTrigger ফাংশন বাস্তবায়ন করে আপনার অ্যাড-অনের জন্য একটি হোমপেজ নির্ধারণ করতে পারেন ( হোমপেজ কনফিগারেশন দেখুন)।

আপনার একাধিক হোমপেজ থাকতে পারে, আপনার অ্যাড-অন প্রসারিত প্রতিটি হোস্ট অ্যাপ্লিকেশনের জন্য একটি। আপনি একটি একক সাধারণ ডিফল্ট হোমপেজ সংজ্ঞায়িত করার সিদ্ধান্ত নিতে পারেন যা হোস্টগুলিতে ব্যবহৃত হয় যেখানে আপনি একটি কাস্টম হোমপেজ নির্দিষ্ট করেননি।

নিম্নলিখিত শর্তগুলির মধ্যে একটি পূরণ হলে আপনার অ্যাড-অন হোমপেজ প্রদর্শিত হয়:

  • যখন অ্যাড-অনটি হোস্টে প্রথম খোলা হয় (অনুমোদনের পরে)।
  • অ্যাড-অন খোলা থাকাকালীন ব্যবহারকারী যখন একটি প্রাসঙ্গিক প্রসঙ্গ থেকে একটি অ-প্রসঙ্গিক প্রসঙ্গে স্যুইচ করে। উদাহরণস্বরূপ, একটি ক্যালেন্ডার ইভেন্ট সম্পাদনা থেকে মূল ক্যালেন্ডারে।
  • যখন ব্যবহারকারী অভ্যন্তরীণ স্ট্যাক থেকে অন্য কার্ডগুলিকে পপ করার জন্য পর্যাপ্ত বার পিছনের বোতামে ক্লিক করেন।
  • যখন একটি নন-প্রসঙ্গগত কার্ডে একটি UI মিথস্ক্রিয়া একটি Navigation.popToRoot() কলে পরিণত হয়।

একটি হোমপেজ ডিজাইন করা বাধ্যতামূলক নয় কিন্তু অত্যন্ত সুপারিশ করা হয়; আপনি যদি কোনো সংজ্ঞায়িত না করেন, আপনার অ্যাড-অন নাম সম্বলিত একটি জেনেরিক কার্ড ব্যবহার করা হয় যখনই একজন ব্যবহারকারী অন্যথায় হোমপেজে নেভিগেট করবেন।

হোমপেজ কনফিগারেশন

Google Workspace অ্যাড-অনগুলি অ্যাড-অন ম্যানিফেস্টে সমস্ত হোস্ট অ্যাপ্লিকেশনের জন্য ডিফল্ট হোমপেজ (অ-প্রসঙ্গিক) অ্যাড-অন সামগ্রী কনফিগার করতে addOns.common.homepageTrigger ফিল্ড ব্যবহার করে:

    {
      // ...
      "addOns": {
        // ...
        "common": {
          // ...
          "homepageTrigger": {
            "runFunction": "myFunction",
            "enabled": true
          }
        }
      }
    }

  • runFunction : অ্যাপস স্ক্রিপ্ট ফাংশনের নাম যা Google Workspace অ্যাড-অন ফ্রেমওয়ার্ক হোমপেজ অ্যাড-অন কার্ড রেন্ডার করার জন্য আহ্বান করে। এই ফাংশনটি হোমপেজ ট্রিগার ফাংশন । এই ফাংশনটিকে অবশ্যই Card অবজেক্টের একটি অ্যারে তৈরি এবং ফিরিয়ে দিতে হবে যা হোমপেজ UI তৈরি করে। যদি একাধিক কার্ড ফেরত দেওয়া হয়, হোস্ট অ্যাপ্লিকেশনটি কার্ডের শিরোনামগুলিকে একটি তালিকায় দেখায় যা ব্যবহারকারী নির্বাচন করতে পারে ( একাধিক কার্ড ফেরানো দেখুন)।

  • enabled : এই সুযোগের জন্য হোমপেজ কার্ড সক্রিয় করা উচিত কিনা। এই ক্ষেত্রটি ঐচ্ছিক, এবং true ডিফল্ট। এটিকে false সেট করার ফলে সমস্ত হোস্টের জন্য হোমপেজ কার্ডগুলি নিষ্ক্রিয় হয়ে যায় (যদি না সেই হোস্টের জন্য ওভাররাইড করা হয়; নীচে দেখুন)।

সাধারণ কনফিগারেশন ছাড়াও, প্রতিটি হোস্ট অ্যাপ্লিকেশানের কনফিগারেশনে addOns.gmail.homepageTrigger , addOns.calendar.homepageTrigger , এবং আরও অনেক কিছুতে অভিন্ন-গঠিত প্রতি হোস্ট ওভাররাইড উপলব্ধ রয়েছে:

    {
      ...
      "addOns": {
        ...
        "common": {
          // By default, call 'buildHomePage' to render homepage content
          // in all hosts. Since calendar.homepageTrigger below overrides
          // this in Calendar and Drive and the homepageTrigger is disabled
          // for Gmail, this homepage function never executes.
          "homepageTrigger": { "runFunction": "buildHomePage" }
        },
        "calendar": {
          // Show customized homepage content for Calendar only.
          "homepageTrigger": { "runFunction": "buildCalendarHomepage" }
        },
        "drive": {
          // Show customized homepage content for Drive only.
          "homepageTrigger": { "runFunction": "buildDriveHomepage" }
        }
        "gmail": {
          // Disable homepage add-on content in Gmail.
          "homepageTrigger": { "enabled": false }
        },
        ...
      }
    }

মনে রাখবেন যে এটি নিম্নলিখিত ম্যানিফেস্ট উদ্ধৃতির সমতুল্য:

    {
      ...
      "addOns": {
        ...
        "common": { /* ... */ }, // Omitted a default homepageTrigger specification.
        "calendar": {
          // Show customized homepage content for Calendar only.
          "homepageTrigger": { "runFunction": "myCalendarFunction" }
        },
        "drive": {
          // Show customized homepage content for Drive only.
          "homepageTrigger": { "runFunction": "myDriveFunction" }
        }
        "gmail": { /* ... */ },
        ...
      }
    }

homepageTrigger বিভাগের কোনোটিরই প্রয়োজন নেই। যাইহোক, যে কোনো প্রদত্ত হোস্ট পণ্যে অ্যাড-অনের জন্য দেখানো UI সংশ্লিষ্ট ম্যানিফেস্ট ক্ষেত্রের উপস্থিতির উপর নির্ভর করে এবং এর সাথে সম্পর্কিত homepageTrigger আছে কিনা। নিম্নলিখিত উদাহরণ দেখায় যে বিভিন্ন ম্যানিফেস্ট কনফিগারেশনের জন্য একটি হোমপেজ UI তৈরি করতে কোন অ্যাড-অন ট্রিগার ফাংশনগুলি কার্যকর করা হয় (যদি থাকে):

হোমপেজ প্রবাহ

হোমপেজ ইভেন্ট অবজেক্ট

কল করা হলে, উপরে বর্ণিত হোমপেজ ট্রিগার ফাংশন ( runFunction ) একটি ইভেন্ট অবজেক্ট পাস করা হয় যাতে আহ্বানের প্রসঙ্গ থেকে ডেটা থাকে।

হোমপেজ ইভেন্ট অবজেক্ট উইজেট বা প্রাসঙ্গিক তথ্য অন্তর্ভুক্ত করে না; পাস করা তথ্য নিম্নলিখিত সাধারণ ইভেন্ট অবজেক্ট ক্ষেত্রে সীমাবদ্ধ:

আরও বিস্তারিত জানার জন্য ইভেন্ট অবজেক্ট দেখুন।

অন্যান্য অ-প্রসঙ্গিক কার্ড

আপনার অ্যাড-অন UI-তে অতিরিক্ত অ-প্রসঙ্গিক কার্ড থাকতে পারে যা হোমপেজ নয়। উদাহরণস্বরূপ, আপনার হোমপেজে একটি বোতাম থাকতে পারে যা একটি "সেটিংস" কার্ড খোলে যেখানে ব্যবহারকারী অ্যাড-অন সেটিংস সামঞ্জস্য করতে পারে (এই ধরনের সেটিংস, বেশিরভাগ ক্ষেত্রে, প্রসঙ্গ থেকে স্বাধীন এবং তাই অ-প্রসঙ্গগত)।

নন-প্রসঙ্গিক কার্ডগুলি অন্যান্য কার্ডের মতো তৈরি করা হয়; শুধুমাত্র পার্থক্য হল কি কর্ম বা ইভেন্ট কার্ড তৈরি করে এবং প্রদর্শন করে। কিভাবে কার্ডের মধ্যে ট্রানজিশন তৈরি করতে হয় তার বিস্তারিত জানার জন্য নেভিগেশন পদ্ধতি দেখুন।