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
estartup_pages
possono essere localizzati utilizzando l'API chrome.i18n. Per le estensioni esterne, i valori URL
search_provider
,homepage
estartup_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) - facoltativoNuovo valore per la home page.
search_provider
(oggetto) - FacoltativoUn 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): facoltativoUn array di lunghezza uno contenente un URL da utilizzare come pagina iniziale.