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
undstartup_pages
können mithilfe der chrome.i18n API lokalisiert werden. Für externe Erweiterungen können die URL-Werte
search_provider
,homepage
undstartup_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): optionalNeuer Wert für die Startseite.
search_provider
(Objekt): optionalEine 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): optionalEin Array der Länge 1, das eine URL enthält, die als „Beim Start“-Seite verwendet werden soll.