Override delle impostazioni di Chrome

L'override delle impostazioni consente alle estensioni di sostituire le impostazioni di Chrome selezionate. L'API è disponibile su Windows in tutte le versioni correnti di Chrome e su Mac in Chrome 56 e versioni successive.

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à per 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 degli URL search_provider, homepage e startup_pages possono essere parametrati utilizzando una chiave di registro. Accanto alla chiave "update_url" deve essere creata una nuova voce del registro (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 sostituite con il valore "install_parameter". 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	(facoltativo) name	Nome del motore di ricerca visualizzato all'utente. Questo valore può essere omesso solo se è impostato prepopulated_id.
  stringa	(facoltativa) parola chiave	Parola chiave Omnibox per il motore di ricerca. Questo valore può essere omesso solo se è impostato prepopulated_id.
  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. Può essere omesso solo se il valore di prepopulated_id è per iniziare.
  stringa	(facoltativo)suggest_url	Se omesso, questo 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 di parametri post per search_url
  stringa	(facoltativo) suggest_url_post_params	La stringa dei parametri post su suggestion_url
  stringa	(facoltativo) image_url_post_params	La stringa di parametri post per 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 stringhe) - facoltativo

  Un array di lunghezza 1 contenente un URL da utilizzare come pagina di avvio.