As substituições de configurações são uma forma de as extensões modificarem as configurações selecionadas do Chrome. A API está disponível no Windows em todas as versões atuais do Chrome e no Chrome 56 e versões mais recentes para Mac.
Página inicial, provedor de pesquisa e páginas de inicialização
Veja um exemplo de como a página inicial, o provedor de pesquisa e as páginas de inicialização podem ser modificadas no manifesto da extensão. Os sites usados na API Settings precisam ser verificados (pelas Ferramentas do Google para webmasters) como se estivessem associados a esse item na Chrome Web Store. Se você verificar a propriedade de um domínio (por exemplo, http://example.com), poderá usar qualquer subdomínio ou página (por exemplo, http://app.example.com ou http://example.com/page.html) na sua extensão.
{
"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",
...
}
Como personalizar valores
Os valores no manifesto podem ser personalizados das seguintes maneiras:
- Todos os valores das propriedades
search_provider
,homepage
estartup_pages
podem ser localizados usando a API chrome.i18n. Para extensões externas, os valores de URL
search_provider
,homepage
estartup_pages
podem ser parametrizados usando uma chave de registro. Uma nova entrada de registro precisa ser criada ao lado da chave "update_url". Consulte as instruções aqui. O nome do valor é "install_parameter", os dados do valor são uma string arbitrária:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
Todas as ocorrências da substring "__PARAM__" nos URLs do manifesto serão substituídas pelo valor "install_parameter". Se "install_parameter" estiver ausente, as ocorrências de "__PARAM__" serão removidas. "__PARAM__" não pode fazer parte do nome do host. Ele precisa ocorrer depois do primeiro "/" no URL.
Referência
Uma extensão pode substituir uma ou mais das seguintes propriedades no manifesto:
homepage
(string): opcionalNovo valor para a página inicial.
search_provider
(objeto): opcionalUm mecanismo de pesquisa
Tipo Atributo Descrição string Nome (opcional) Nome do mecanismo de pesquisa exibido ao usuário. Só pode ser omitido se prepopulated_id estiver definido.
string Palavra-chave (opcional) Palavra-chave da omnibox para o mecanismo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
string (opcional) favicon_url URL do ícone do mecanismo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
string search_url Um URL usado pelo mecanismo de pesquisa.
string Codificação (opcional) Codificação do termo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
string URL de sugestão (opcional) Se omitido, o mecanismo não aceita sugestões.
string (opcional) image_url Se omitido, o mecanismo não aceita a pesquisa de imagens.
string (opcional) search_url_post_params A string de parâmetros de postagem para search_url
string (opcional)suggest_url_post_params (em inglês) A string de parâmetros de postagem parasuggest_url
string (opcional) image_url_post_params A string dos parâmetros de postagem para image_url
matriz de string (opcional)alternate_urls Uma lista de padrões de URL que podem ser usados, além de |search_url|.
número inteiro (opcional) pré-filled_id Um ID do mecanismo de pesquisa integrado no Chrome.
boolean is_default Especifica se o provedor de pesquisa deve ser padrão.
startup_pages
(matriz de string): opcionalUma matriz de comprimento um contendo um URL a ser usado como a página de inicialização.