שינוי הגדרות Chrome

שינוי ההגדרות מאפשר לתוספים לבטל את הגדרות Chrome שנבחרו. ה-API הוא זמין ב-Windows בכל הגרסאות הנוכחיות של Chrome וזמין ב-Mac ב-Chrome 56 מאוחר יותר.

דף הבית, ספק החיפוש ודפי הפתיחה

בדוגמה הבאה מוסבר איך אפשר לשנות את דף הבית, את ספק החיפוש ואת דפי הפתיחה במניפסט של התוסף. אתרים שמשמשים ב-Settings 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.

• בתוספים חיצוניים, אפשר להגדיר פרמטרים של ערכי כתובות ה-URL 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.
  מחרוזת	(אופציונלי)suggest_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|.
  מספר שלם	(אופציונלי) predefinedd_id	מזהה של מנוע החיפוש המובנה ב-Chrome.
  בוליאני	is_default	ההגדרה הזו מציינת אם ספק החיפוש צריך להיות ברירת המחדל.

• startup_pages (מערך של מחרוזת) – אופציונלי

  מערך באורך 1 שמכיל כתובת URL שתשמש כדף הפתיחה.