Chrome-Einstellungen überschreiben

Mit Überschreibungen von Einstellungen können Erweiterungen ausgewählte Chrome-Einstellungen überschreiben. Die API steht unter Windows in allen aktuellen Versionen von Chrome zur Verfügung und ist für Mac ab Chrome 56 verfügbar.

Startseite, Suchanbieter und „Beim Start“-Seiten

Hier sehen Sie ein Beispiel dafür, wie die Startseite, der Suchanbieter und die Startseiten im Erweiterungsmanifest geändert werden können. Für Websites, die in der Settings API verwendet werden, muss über die Webmaster-Tools über die Webmaster-Tools verifiziert werden, dass sie mit dem jeweiligen Eintrag im Chrome Web Store verknüpft sind. Wenn Sie die Inhaberschaft für eine Domain (z. B. http://beispiel.de) bestätigen, können Sie eine beliebige Subdomain oder Seite (z. B. http://app.beispiel.de oder http://beispiel.de/seite.html) in der Erweiterung verwenden.

{
  "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",
   ...
}

Werte anpassen

Werte im Manifest können so angepasst werden:

• Alle Werte der Eigenschaften search_provider, homepage und startup_pages können mithilfe der chrome.i18n API lokalisiert werden.

• Für externe Erweiterungen können die URL-Werte search_provider, homepage und startup_pages mit einem Registrierungsschlüssel parametriert werden. Neben dem Schlüssel "update_url" sollte ein neuer Registry-Eintrag erstellt werden (Anleitung). Der Wertname lautet "install_parameter", die Wertdaten sind ein beliebiger String:

  {
    "update_url": "https://clients2.google.com/service/update2/crx",
    "install_parameter": "Value"
  }
  

  Alle Vorkommen des Teilstrings "__PARAM__" in den Manifest-URLs werden durch den Wert "install_parameter" ersetzt. Wenn der Parameter "install_parameter" nicht vorhanden ist, werden alle Vorkommen von "__PARAM__" entfernt. "__PARAM__" darf nicht Teil des Hostnamens sein. Er muss nach dem ersten Schrägstrich in der URL stehen.

Referenz

Eine Erweiterung kann eine oder mehrere der folgenden Eigenschaften im Manifest überschreiben:

• homepage (String): optional

  Neuer Wert für die Startseite.

• search_provider (Objekt): optional

  Eine Suchmaschine

  Typ	Attribut	Beschreibung
  String	(Optional) Name	Name der Suchmaschine, die dem Nutzer angezeigt wird. Dieser Wert darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	(optional) Keyword	Omnibox-Keyword für die Suchmaschine. Dieser Wert darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	(Optional) favicon_url	Symbol-URL für die Suchmaschine Dieser Wert darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	search_url	Eine von der Suchmaschine verwendete Such-URL.
  String	(optional) Codierung	Codierung des Suchbegriffs. Dieser Wert darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	(Optional)suggest_url	Wenn nicht angegeben, unterstützt diese Suchmaschine keine Vorschläge.
  String	(Optional) Bild-URL	Wenn nicht angegeben, unterstützt diese Suchmaschine die Bildersuche nicht.
  String	(Optional) „search_url_post_params“	String der Post-Parameter für search_url
  String	(optional) „suggest_url_post_params“	String der Post-Parameter für „suggest_url“
  String	(Optional) „image_url_post_params“	String der Post-Parameter für „image_url“
  String-Array	(Optional) alternative_urls	Eine Liste von URL-Mustern, die zusätzlich zu |search_url| verwendet werden können.
  Ganzzahl	(Optional) prefilled_id	ID der in Chrome integrierten Suchmaschine.
  boolean	is_default	Gibt an, ob der Suchanbieter standardmäßig verwendet werden soll.

• startup_pages (Array des Strings): optional

  Ein Array der Länge 1, das eine URL enthält, die als „Beim Start“-Seite verwendet werden soll.