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

Hier 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 Webmaster Tools bestätigt werden, dass sie mit diesem Artikel 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 in Ihrer Erweiterung jede beliebige Subdomain oder Seite (z. B. http://app.beispiel.de oder http://beispiel.de/seite.html) 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 auf folgende Weise angepasst werden:

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

• Bei externen Erweiterungen können die URL-Werte search_provider, homepage und startup_pages über einen Registrierungsschlüssel parametrisiert werden. Ein neuer Registrierungseintrag sollte neben dem „update_url“ (siehe Anleitung hier). Der Wertname 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 werden durch den Wert „install_parameter“ ersetzt. 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 (object) – optional

  Eine Suchmaschine

  Typ	Attribut	Beschreibung
  String	(optional) Name	Der Name der Suchmaschine, der dem Nutzer angezeigt wird. Sie kann 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. Er 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. Sie kann nur weggelassen werden, wenn prepopulated_id festgelegt ist.
  String	(optional) suggest_url	Wenn diese Option weggelassen wird, unterstützt diese Engine keine Vorschläge.
  String	(optional) image_url	Wenn Sie diesen Parameter weglassen, unterstützt diese Suchmaschine keine Bildsuche.
  String	(optional) search_url_post_params	Der String mit den POST-Parametern für „search_url“
  String	(optional) suggest_url_post_params	Der String mit den POST-Parametern für „suggest_url“
  String	(optional) image_url_post_params	Der String mit den POST-Parametern für „image_url“
  Array von String	(optional) alternate_urls	Eine Liste mit URL-Mustern, die zusätzlich zu |search_url| verwendet werden können.
  Ganzzahl	(Optional) prefilled_id (vorausgefüllte ID)	Eine ID der integrierten Suchmaschine in Chrome.
  boolean	is_default	Gibt an, ob der Suchanbieter standardmäßig sein soll.

• startup_pages (Stringarray) – optional

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