Override delle impostazioni di Chrome

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

Home page, provider di ricerca e pagine iniziali

Ecco un esempio di come la home page, il provider di ricerca e le pagine di avvio possono essere modificate nel file manifest dell'estensione. I siti web utilizzati nell'API Settings devono essere verificati (tramite Strumenti per i Webmaster) come associati all'elemento in questione 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 essere parametrizzati utilizzando una chiave del Registro di sistema. Deve essere creata una nuova voce di registro accanto alla chiave "update_url" (vedi le istruzioni qui). Il nome del valore è "install_parameter", i dati del valore sono una stringa arbitraria:

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

  Tutte le occorrenze della sottostringa "__PARAM__" negli URL del file manifest verranno sostituite con il valore "install_parameter". Se "install_parameter" non è presente, le occorrenze di "__PARAM__" vengono rimosse. Tieni presente che "__PARAM__" non può far parte del nome host. Deve essere inserito dopo il primo "/" 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) Nome	Nome del motore di ricerca mostrato all'utente. Questo valore può essere omesso solo se è impostato il valore prepopulated_id.
  stringa	(Facoltativo) parola chiave	Parola chiave nella omnibox per il motore di ricerca. Questo valore può essere omesso solo se è impostato il valore prepopulated_id.
  stringa	favicon_url (facoltativo)	Un URL dell'icona per il motore di ricerca. Questo valore può essere omesso solo se è impostato il valore prepopulated_id.
  stringa	search_url	Un URL di ricerca utilizzato dal motore di ricerca.
  stringa	Codifica (facoltativa)	Codifica del termine di ricerca. Questo valore può essere omesso solo se è impostato il valore prepopulated_id.
  stringa	Recommendations_url (facoltativo)	Se omesso, questo motore non supporta i suggerimenti.
  stringa	(facoltativo) image_url	Se omesso, questo motore non supporta la ricerca di immagini.
  stringa	(Facoltativo) search_url_post_params	La stringa dei parametri del post per search_url
  stringa	(facoltativo) suggestion_url_post_params	La stringa dei parametri del post per suggested_url
  stringa	(Facoltativo) image_url_post_params	La stringa dei parametri del post per image_url
  array di stringhe	(Facoltativo) alternate_urls	Un elenco di pattern URL che è possibile utilizzare, oltre a |search_url|.
  numero intero	id_precompilato (facoltativo)	Un ID del motore di ricerca integrato in Chrome.
  boolean	is_default	Specifica se il provider di ricerca deve essere predefinito.

• startup_pages (array di stringhe): facoltativo

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