Chrome-instellingen overschrijven

Het overschrijven van instellingen is een manier waarop extensies geselecteerde Chrome-instellingen kunnen overschrijven. De API is beschikbaar op Windows in alle huidige versies van Chrome en is beschikbaar op Mac in Chrome 56 en hoger.

Startpagina, zoekmachine en opstartpagina's

Hier is een voorbeeld van hoe de startpagina , zoekmachine en opstartpagina's kunnen worden gewijzigd in het extensiemanifest . Websites die in de instellingen-API worden gebruikt, moeten worden geverifieerd (via Webmaster Tools) als zijnde gekoppeld aan dat item in de Chrome Web Store. Houd er rekening mee dat als u het eigendom van een domein verifieert (bijvoorbeeld http://example.com), u elk subdomein of elke pagina kunt gebruiken (bijvoorbeeld http://app.example.com of http://example.com/ page.html) binnen uw extensie.

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

Waarden aanpassen

Waarden in het manifest kunnen op de volgende manieren worden aangepast:

• Alle waarden van de eigenschappen search_provider , homepage en startup_pages kunnen worden gelokaliseerd met behulp van de chrome.i18n API .

• Voor externe extensies kunnen de URL-waarden search_provider , homepage en startup_pages worden geparametriseerd met behulp van een registersleutel. Er moet een nieuwe registervermelding worden gemaakt naast de sleutel "update_url" (zie instructies hier ). De waardenaam is "install_parameter", de waardegegevens zijn een willekeurige reeks:

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

  Alle exemplaren van de subtekenreeks "__PARAM__" in de manifest-URL's worden vervangen door de waarde "install_parameter". Als "install_parameter" afwezig is, worden exemplaren van "__PARAM__" verwijderd. Houd er rekening mee dat "__PARAM__" geen deel kan uitmaken van de hostnaam. Het moet voorkomen na de eerste '/' in de URL.

Referentie

Een extensie kan een of meer van de volgende eigenschappen in het manifest overschrijven:

• homepage (string) - optioneel

  Nieuwe waarde voor de startpagina.

• search_provider (object) - optioneel

  Een zoekmachine

  Type	Attribuut	Beschrijving
  snaar	(optioneel) naam	Naam van de zoekmachine die aan de gebruiker wordt weergegeven. Dit kan alleen worden weggelaten als prepopulated_id is ingesteld.
  snaar	(optioneel) trefwoord	Omnibox-trefwoord voor de zoekmachine. Dit kan alleen worden weggelaten als prepopulated_id is ingesteld.
  snaar	(optioneel) favicon_url	Een pictogram-URL voor de zoekmachine. Dit kan alleen worden weggelaten als prepopulated_id is ingesteld.
  snaar	zoek_url	Een zoek-URL die door de zoekmachine wordt gebruikt.
  snaar	(optionele) codering	Codering van de zoekterm. Dit kan alleen worden weggelaten als prepopulated_id is ingesteld.
  snaar	(optioneel) suggestie_url	Als u dit weglaat, ondersteunt deze engine geen suggesties.
  snaar	(optioneel) afbeelding_url	Als u dit weglaat, ondersteunt deze engine het zoeken naar afbeeldingen niet.
  snaar	(optioneel) search_url_post_params	De reeks berichtparameters voor search_url
  snaar	(optioneel) suggest_url_post_params	De reeks berichtparameters die moet worden voorgesteld_url
  snaar	(optioneel) image_url_post_params	De reeks berichtparameters voor image_url
  reeks tekenreeksen	(optioneel) alternatieve_urls	Een lijst met URL-patronen die kunnen worden gebruikt, naast |search_url|.
  geheel getal	(optioneel) vooraf ingevulde_id	Een ID van de ingebouwde zoekmachine in Chrome.
  Booleaans	is_default	Geeft aan of de zoekmachine standaard moet zijn.

• startup_pages (array van string) - optioneel

  Een array met lengte één die een URL bevat die als opstartpagina moet worden gebruikt.