Override delle impostazioni di Chrome

L'override delle impostazioni consente alle estensioni di sostituire le impostazioni di Chrome selezionate. L'API è disponibile per Windows in tutte le versioni attuali di Chrome ed è disponibile su Mac in Chrome 56 e in un secondo momento.

Home page, provider di ricerca e pagine iniziali

Ecco un esempio di come è possibile modificare la home page, il provider di ricerca e le pagine iniziali in il manifest dell'estensione. I siti web utilizzati nell'API Settings devono essere verificati (tramite il webmaster strumenti) come associati all'elemento nel Chrome Web Store. Tieni presente che se verifichi la proprietà di un dominio (ad esempio, http://example.com), puoi utilizzare qualsiasi sottodominio o pagina (ad esempio, http://app.example.com o http://example.com/page.html) all'interno dell'estensione.

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

Personalizzazione dei valori

I valori nel file manifest possono essere personalizzati nei seguenti modi:

• Tutti i valori delle proprietà search_provider, homepage e startup_pages possono essere localizzati utilizzando l'API chrome.i18n.

• Per le estensioni esterne, i valori URL search_provider, homepage e startup_pages possono parametrizzate usando una chiave di registro. È necessario creare una nuova voce di registro accanto "update_url" (vedi le istruzioni qui). Il nome del valore è "install_parameter", il valore data è una stringa arbitraria:

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

  Tutte le occorrenze della sottostringa "__PARAM__" negli URL manifest verranno sostituiti con "install_parameter" valore. Se "install_parameter" non è presente, occorrenze di "__PARAM__" sono rimosso. Tieni presente che "__PARAM__" non può far parte del nome host. Deve verificarsi dopo prima "/" nell'URL.

Riferimento

Un'estensione può sostituire una o più delle seguenti proprietà nel file manifest:

• homepage (stringa) - facoltativo

  Nuovo valore per la home page.

• search_provider (oggetto) - facoltativo

  Un motore di ricerca

  Tipo	Attributo	Descrizione
  stringa	Nome (facoltativo)	Nome del motore di ricerca mostrato all'utente. Può essere omesso solo se prepopulated_id è impostato.
  stringa	Parola chiave (facoltativa)	Parola chiave Omnibox per il motore di ricerca. Può essere omesso solo se prepopulated_id è impostato.
  stringa	(facoltativo) favicon_url	L'URL dell'icona per il motore di ricerca. Può essere omesso solo se prepopulated_id è impostata.
  stringa	search_url	Un URL di ricerca utilizzato dal motore di ricerca.
  stringa	Codifica (facoltativo)	Codifica del termine di ricerca. Questo valore può essere omesso solo se prepopulated_id è per iniziare.
  stringa	(facoltativo)suggest_url	Se omesso, il motore non supporta i suggerimenti.
  stringa	(facoltativo) image_url	Se omesso, il motore non supporta la ricerca immagini.
  stringa	(facoltativo) search_url_post_params	La stringa dei parametri post per search_url
  stringa	(facoltativo) suggestion_url_post_params	La stringa dei parametri post su suggestion_url
  stringa	(facoltativo) image_url_post_params	La stringa dei parametri post in image_url
  array di stringhe	alternative_url (facoltativo)	Un elenco di pattern URL che è possibile utilizzare, oltre a |search_url|.
  integer	(facoltativo) precompilato_id	Un ID del motore di ricerca integrato in Chrome.
  booleano	is_default	Specifica se il provider di ricerca deve essere predefinito.

• startup_pages (array di stringa) - facoltativo

  Un array di uno di lunghezza contenente un URL da utilizzare come pagina iniziale.