ביטול הגדרות מאפשר לתוספים לבטל את ההגדרות שנבחרו ב-Chrome. ה-API זמין ב-Windows בכל הגרסאות הנוכחיות של Chrome, וזמין ב-Mac ב-Chrome 56 ואילך.
דף הבית, ספק החיפוש ודפי הפעלה
הנה דוגמה לאופן שבו ניתן לשנות את דף הבית, ספק החיפוש ודפי ההפעלה במניפסט התוסף. אתרים שבהם נעשה שימוש ב-API של ההגדרות חייבים להיות מאומתים (דרך כלי מנהלי האתרים) בתור משויכים לפריט הזה בחנות האינטרנט של Chrome. שימו לב שאם אתם מאמתים בעלות על דומיין (לדוגמה, http://example.com), תוכלו להשתמש בכל תת-דומיין או דף (לדוגמה, http://app.example.com או http://example.com/page.html) בתוך התוסף שלכם.
{
"name": "My extension",
...
"chrome_settings_overrides": {
"homepage": "http://www.homepage.com",
"search_provider": {
"name": "name.__MSG_url_domain__",
"keyword": "keyword.__MSG_url_domain__",
"search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
"favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
"suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
"instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
"image_url": "http://www.foo.__MSG_url_domain__/image?q={searchTerms}",
"search_url_post_params": "search_lang=__MSG_url_domain__",
"suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
"instant_url_post_params": "instant_lang=__MSG_url_domain__",
"image_url_post_params": "image_lang=__MSG_url_domain__",
"alternate_urls": [
"http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
"http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
],
"encoding": "UTF-8",
"is_default": true
},
"startup_pages": ["http://www.startup.com"]
},
"default_locale": "de",
...
}
התאמה אישית של ערכים
ניתן להתאים אישית את הערכים במניפסט בדרכים הבאות:
- אפשר להתאים את כל הערכים של המאפיינים
search_provider
,homepage
ו-startup_pages
לשוק המקומי באמצעות chrome.i18n API. במקרה של תוספים חיצוניים, ניתן להגדיר את ערכי כתובות האתרים
search_provider
,homepage
ו-startup_pages
באמצעות מפתח רישום. יש ליצור רשומת רישום חדשה לצד המפתח update_url (ההוראות מפורטות כאן). שם הערך הוא "install_parameter", נתוני הערך הם מחרוזת שרירותית:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
כל המופעים של מחרוזת המשנה "__PARAM__" בכתובות ה-URL של המניפסט יוחלפו בערך 'install_parameter'. אם הפרמטר "install_parameter" חסר, מופעים של "__PARAM__" מסירים. לתשומת ליבך, "__PARAM__" לא יכול להיות חלק משם המארח. הוא צריך להופיע אחרי התו '/' הראשון בכתובת ה-URL.
חומר עזר
תוסף יכול לשנות אחד או יותר מהמאפיינים הבאים במניפסט:
homepage
(מחרוזת) – אופציונליערך חדש עבור דף הבית.
search_provider
(אובייקט) – אופציונלימנוע חיפוש
תיאור מאפיין התיאור מחרוזת שם (אופציונלי) שם מנוע החיפוש המוצג למשתמש. אפשר להשמיט את הערך הזה רק אם מוגדר הערך prepopulated_id.
מחרוזת מילת מפתח (אופציונלי) מילת מפתח בסרגל הכתובות עבור מנוע החיפוש. אפשר להשמיט את הערך הזה רק אם מוגדר הערך prepopulated_id.
מחרוזת (אופציונלי) favicon_url כתובת URL של סמל עבור מנוע החיפוש. ניתן להשמיט את הערך הזה רק אם הערך prepopulated_id מוגדר.
מחרוזת search_url כתובת URL לחיפוש שמשמשת את מנוע החיפוש.
מחרוזת קידוד (אופציונלי) הקידוד של מונח החיפוש. ניתן להשמיט את הערך הזה רק אם הערך prepopulated_id מוגדר.
מחרוזת (אופציונלי)suggested_url אם הושמט, המנוע הזה לא תומך בהצעות.
מחרוזת (אופציונלי) image_url אם הושמט, המנוע הזה לא תומך בחיפוש באמצעות תמונות.
מחרוזת (אופציונלי) search_url_post_params מחרוזת הפרמטרים של פוסטים ל-search_url
מחרוזת (אופציונלי)suggest_url_post_params מחרוזת הפרמטרים של פוסט ל-suggest_url
מחרוזת (אופציונלי) image_url_post_params מחרוזת הפרמטרים של הפוסט ל-image_url
מערך של מחרוזת (אופציונלי) alternate_urls רשימה של תבניות URL שאפשר להשתמש בהן, בנוסף ל-|search_url|.
מספר שלם (אופציונלי) predefined_id המזהה של מנוע החיפוש המובנה ב-Chrome.
boolean is_default ההגדרה קובעת אם ספק החיפוש יהיה ברירת המחדל.
startup_pages
(מערך מחרוזת) – אופציונלימערך באורך אחד שמכיל כתובת URL שתשמש כדף הפתיחה.