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.