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

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

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

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

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