Chrome-Einstellungen überschreiben

Mit Überschreibungen von Einstellungen können Erweiterungen ausgewählte Chrome-Einstellungen überschreiben. Die API ist ist in allen aktuellen Chrome-Versionen unter Windows und auf Mac mit Chrome 56 und .

Startseite, Suchanbieter und Startseiten

Im Folgenden sehen Sie ein Beispiel, wie die Startseite, der Suchanbieter und die Startseiten in das Erweiterungsmanifest. Websites, die in der Settings API verwendet werden, müssen über den Webmaster bestätigt sein mit dem entsprechenden Artikel im Chrome Web Store verknüpft sein. Wenn Sie die Inhaberschaft bestätigen, Für eine Domain (z. B. http://beispiel.de) können Sie eine beliebige Subdomain oder Seite verwenden (z. B. http://app.beispiel.de oder http://beispiel.de/seite.html) in der Erweiterung.

{
  "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

Die Werte im Manifest können folgendermaßen angepasst werden:

• Alle Werte der Attribute search_provider, homepage und startup_pages können lokalisiert werden über die chrome.i18n API.

• Für externe Erweiterungen können die URL-Werte search_provider, homepage und startup_pages mit einem Registrierungsschlüssel parametrisiert werden. Ein neuer Registrierungseintrag sollte neben dem "update_url" (siehe Anleitung hier). Der Name des Werts lautet „install_parameter“, der Wert data ist ein beliebiger String:

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

  Alle Vorkommen des Teilstrings "__PARAM__" in den Manifest-URLs durch das Tag "install_parameter" Wert. Wenn „install_parameter“ ist nicht vorhanden, Vorkommen von "__PARAM__" sind entfernt. Hinweis: "__PARAM__" darf nicht Teil des Hostnamens sein. Sie muss nach der erster '/' in der URL.

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	Der Name der Suchmaschine, die dem Nutzer angezeigt wird. Er darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	Keyword (optional)	Omnibox-Suchbegriff für die Suchmaschine Er darf nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	(optional) favicon_url	Eine Symbol-URL für die Suchmaschine. Dieser Parameter kann nur weggelassen werden, wenn prepopulated_id angegeben ist. festgelegt ist.
  String	search_url	Eine von der Suchmaschine verwendete Such-URL.
  String	(optional) Codierung	Codierung des Suchbegriffs. Er kann nur weggelassen werden, wenn prepopulated_id den folgenden Wert hat: festgelegt.
  String	(optional) Vorschlag_URL	Wenn keine Angabe gemacht wird, unterstützt diese Suchmaschine keine Vorschläge.
  String	(optional) image_url	Wenn keine Angabe gemacht wird, unterstützt diese Suchmaschine die Bildersuche nicht.
  String	(optional) search_url_post_params	Der String der Beitragsparameter für „search_url“
  String	(optional) suggest_url_post_params	Der String der Beitragsparameter für „suggest_url“
  String	(optional) "image_url_post_params"	Der String der Beitragsparameter für "image_url"
  Array von String	(optional) alternative_urls	Eine Liste mit URL-Mustern, die zusätzlich zu |search_url| verwendet werden können.
  Ganzzahl	(Optional) prefilled_id (vorausgefüllte ID)	Die ID der integrierten Suchmaschine in Chrome.
  boolean	is_default	Gibt an, ob der Suchanbieter die Standardsuchmaschine sein soll.

• startup_pages (Array von String) – optional

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