תוספים ל-Google Workspace צריכים להיות עקביים עם הסגנון והפריסה של אפליקציית המארח שהם מרחיבים. הם צריכים להרחיב את ממשק המשתמש באופן טבעי באמצעות אמצעי בקרה והתנהגויות מוכרים. ההנחיות שמפורטות כאן מתארות דרכים לטיפול בטקסט, בתמונות, באמצעי הבקרה ובמיתוג, שמקדמות חוויית משתמש באיכות גבוהה.
אם התוסף פותח דפי אינטרנט נפרדים שהם חלק בלתי נפרד מהפעלת התוסף (כמו דף הגדרות של התוסף), חשוב לוודא שגם דפי האינטרנט האלה עומדים בהנחיות הסגנון האלה.
טקסט ותמונות
בקטע הזה מוסבר איך להשתמש בצורה נכונה בטקסט ובתמונות בתוסף.
שם התוסף
צריך להגדיר את שם התוסף במניפסט של הפרויקט שלו, וגם כשמגדירים את התוסף לפרסום. השם מופיע במקומות רבים, כמו בדף המוצר ב-Google Workspace Marketplace ובתפריטים. כשבוחרים שם:
- חשוב להשתמש באותיות רישיות בתחילת כל מילה.
- הימנעו משימוש בסימני פיסוק, במיוחד בסוגריים, אלא אם הם חלק מהמותג.
- כדאי שהשם יהיה קצר – 15 תווים או פחות. יכול להיות ששמות ארוכים יקוצרו באופן אוטומטי בדף המוצר ב-Google Workspace Marketplace ובמקומות אחרים.
- אסור לכלול בשם התוסף את המילים 'Google', 'Gmail' או שמות של מוצרים אחרים של Google.
- אין לכלול את המילה 'תוסף' בשם התוסף.
- לא לכלול את פרטי הגרסה.
סגנון כתיבה
לא צריך לכתוב הרבה. רוב הפעולות צריכות להיות ברורות באמצעות סמלים, פריסה ותוויות קצרות. אם חלק מהתוסף שלכם צריך הסבר מפורט יותר ממה שתוויות קצרות יכולות לספק, מומלץ ליצור דף אינטרנט נפרד שמתאר את התוסף ולקשר אליו.
כשכותבים טקסט בממשק המשתמש:
- להשתמש באותיות רישיות (במיוחד בלחצנים, בתווית ובפעולות בכרטיסים).
- מומלץ להשתמש בטקסט קצר ופשוט ללא מונחים מקצועיים או ראשי תיבות.
פעולות כלליות ופעולות בכרטיס
אם משתמשים בפעולות אוניברסליות או בפעולות בכרטיס בתוסף, הן מופיעות כפריטי תפריט בכרטיסים שתגדירו. אתם יכולים לבחור את הטקסט שיופיע בתפריטים האלה עבור הפעולות האלה. כשבוחרים את הטקסט לשימוש:
- מומלץ להימנע מטקסט בתפריט שפשוט חוזר על שם התוסף.
- כדאי להתחיל כל פריט בתפריט במילה שמציינת פעולה, כמו 'הפעלה', 'הגדרה' או 'יצירה'.
- מתארים את המשימה, ולא את רכיב ממשק המשתמש שבו מוצגת הפעולה.
- אם הפעולה מתחילה תהליך עבודה ואין פועל יחיד שמתאר את הפעולה, אפשר לקרוא לה 'התחלה'.
- מומלץ להשתמש במספר קטן של פריטים בתפריט כדי למנוע מהמשתמשים לגלול ברשימת פריטים גדולה. אם אתם רוצים להטמיע פעולות נוספות, כדאי להשתמש בכמה כרטיסים עם פעולות שונות בכל אחד מהם.
הודעות שגיאה
כשמשהו משתבש, חשוב להשתמש בשפה פשוטה. צריך להסביר את הבעיה מנקודת המבט של המשתמש ולהציע איך לפתור אותה.
- אל תאפשרו למשתמש לראות חריגות שהקוד שלכם גורם להן. במקום זאת, השתמשו בהצהרות
try...catchכדי ליירט חריגות, ואז להציג הודעת שגיאה ידידותית למשתמש. - לפני הפרסום, חשוב לוודא שהתוסף לא מציג מידע על ניפוי באגים בממשק המשתמש.
תוכן העזרה
כדאי לעצב כרטיסים שמוצגים בהם מידע עזר או הסבר למשתמשים על הפעולה של התוסף. אם אתם יוצרים תוכן עזרה לתוסף, חשוב לזכור:
- כשאפשר, כדאי להציג את ההוראות ברשימת תבליטים או ברשימת מספרים. להנחות את המשתמשים עד לתוצאה הסופית, עם הפניות ברורות לרכיבי ממשק המשתמש שצוינו בשמות.
- חשוב להסביר בבירור את כל הדרישות בהוראות, למשל הגדרת גיליון אלקטרוני באופן מסוים.
- אפשר לקשר לתוכן עזרה חיצוני, כמו דפי אינטרנט תומכים.
תמונות
התמונות שבתוסף יכולות להיות מסוגי הסמלים המובנים או תמונה שמתארחת באופן ציבורי ומסומנת באמצעות כתובת URL. כשמשתמשים בתמונות מתארחות, חשוב לוודא שכל מי שעשוי להשתמש בתוסף יוכל לגשת אליהן.
פקדים
בקטע הזה מפורטות הנחיות בנושא חוויית משתמש לווידג'טים אינטראקטיביים.
לחצנים
כדאי להשתמש בלחצנים כדי לשלוט בפעולות הראשיות של ממשק המשתמש, במקום בווידג'טים אחרים.
- רוב תוויות הלחצנים בטקסט צריכות להתחיל בפעולה.
- ברוב המקרים, כדאי להגביל את שורות הלחצנים לשלוש לחצנים או פחות.
DecoratedText
ווידג'טים של DecoratedText מאפשרים להציג תוכן טקסט עם סמלים, לחצנים או מתגים.
- חשוב להשתמש באות גדולה בתחילת המשפט (באנגלית) בתוכן הטקסט.
- הטקסט של ווידג'ט DecoratedText יקוצר אם הוא לא יתאים למרחב הזמין. לכן, תמיד כדאי לנסות לשמור על תוכן הטקסט קצר ככל האפשר.
קלטות בחירה
תוכלו להשתמש במגוון של ווידג'טים של קלט בחירה בתוסף: תיבות בחירה נפתחות, תיבות סימון ולחצני בחירה.
- כדאי להשתמש בתיבות סימון כשאנשים יכולים לבחור כמה אפשרויות, או לא לבחור אף אפשרות. משתמשים בלחצני בחירה (או בתפריט בחירה) כשצריך לבחור רק אפשרות אחת. כדאי להשתמש ברשימה נפתחת כשמציגים רשימה קצרה של חלופות ומנסים לחסוך מקום בממשק המשתמש.
- חשוב להשתמש באות גדולה בתחילת המשפט (באנגלית) בטקסט שמוקצה לכל אפשרות.
- מומלץ להימנע משימוש בשינויים בבחירות כדי להפעיל פעולות משמעותיות שקשה לבטל, כי אנשים נוטים לעשות שגיאות כשהם בוחרים. במקום זאת, מומלץ להוסיף לחצן שקורא את ערכי הבחירה הנוכחיים ואז מפעיל את הפעולה.
- בתפריטים נפתחים, כדאי למיין את האפשרויות לפי סדר אלפביתי או לפי סכימה לוגית שכל המשתמשים יכולים להבין (למשל, הצגת ימי השבוע בסדר, החל מיום ראשון או מיום שני).
- כדאי להגביל את מספר האפשרויות בווידג'ט מסוים של קלט לבחירה למספר סביר. אם יש יותר מדי אפשרויות, יכול להיות שיהיה למשתמשים קשה להשתמש בווידג'ט. במקרים כאלה, מומלץ לפצל את האפשרות לקטגוריות שונות ולכמה ווידג'טים.
קלט טקסט
קלט טקסט מספק למשתמשים מקום להזין נתוני מחרוזת.
- אל תשתמשו בקלט טקסט כדי לגרום למשתמש להקליד אחת מקבוצה ספציפית של רשומות אפשריות. במקום זאת, משתמשים בתפריט נפתח.
- כדאי להשתמש בטיפים והצעות כדי לעזור למשתמש להזין טקסט בפורמט ובתוכן הנכונים.
- אם הטקסט שרוצים להזין מכיל יותר ממספר מילים, כדאי להשתמש בקלט טקסט בכמה שורות.
מיתוג
בקטע הזה מפורטות הנחיות לגבי חוויית המשתמש להוספת רכיבי מיתוג לממשק התוסף.
בתוסף
אם אתם רוצים לכלול מיתוג בממשק המשתמש של התוסף, חשוב לשמור על העיצוב קצר ופשוט. כך אנשים יוכלו להתמקד בפונקציונליות של התוסף.
- כל ההיבטים של התוסף חייבים לעמוד בהנחיות למיתוג.
- אסור לכלול את המילים 'Google', 'Gmail' או שמות אחרים של מוצרי Google.
- אין לכלול סמלי מוצרים של Google, גם אם הם שונו.
- אין לכלול את המילה 'תוסף' בטקסט המותג.
- הטקסט של המותג צריך להיות באורך של כמה מילים לכל היותר.
ב-Google Workspace Marketplace
כשמגדירים את התוסף לפרסום, צריך לספק כמה נכסי גרפיקה וטקסט כדי ליצור את דף המוצר ב-Google Workspace Marketplace.
כל ההיבטים של דף העסק של החנות והנכסים האלה חייבים לעמוד בהנחיות למיתוג.