La anulación de parámetros de configuración permite que las extensiones anulen los parámetros de Chrome seleccionados. La API está disponible en Windows en todas las versiones actuales de Chrome, y en Mac con Chrome 56 y versiones posteriores.
Página principal, proveedor de búsqueda y páginas de inicio
A continuación, se muestra un ejemplo de cómo se pueden modificar la página principal, el proveedor de búsqueda y las páginas de inicio en el manifiesto de extensión. Los sitios web que se usan en la API de configuración deben verificarse (mediante las Herramientas para webmasters de Google) como asociados con ese elemento en Chrome Web Store. Ten en cuenta que, si verificas la propiedad de un dominio (por ejemplo, http://example.com), puedes usar cualquier subdominio o página (por ejemplo, http://app.example.com o http://example.com/page.html) dentro de tu extensión.
{
"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",
...
}
Cómo personalizar valores
Los valores en el manifiesto se pueden personalizar de las siguientes maneras:
- Todos los valores de las propiedades
search_provider
,homepage
ystartup_pages
se pueden localizar con la API de chrome.i18n. En el caso de las extensiones externas, los valores de URL
search_provider
,homepage
ystartup_pages
se pueden parametrizar mediante una clave de registro. Se debe crear una nueva entrada de registro junto a la clave "update_url" (consulta las instrucciones aquí). El nombre del valor es "install_parameter", los datos del valor son una cadena arbitraria:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
Todos los casos de la substring "__PARAM__" en las URLs del manifiesto se reemplazarán por el valor "install_parameter". Si "install_parameter" está ausente, se quitan los casos de "__PARAM__". Ten en cuenta que "__PARAM__" no puede formar parte del nombre de host. Debe ocurrir después de la primera “/” en la URL.
Reference
Una extensión puede anular una o más de las siguientes propiedades en el manifiesto:
homepage
(string): opcionalNuevo valor para la página principal.
search_provider
(objeto) - opcionalUn motor de búsqueda
Tipo Atributo Descripción cadena Nombre (opcional) Nombre del motor de búsqueda que se muestra al usuario. Esta acción solo se puede omitir si se configura prepopulated_id.
cadena Palabra clave (opcional) Palabra clave del cuadro multifunción para el motor de búsqueda. Esta acción solo se puede omitir si se configura prepopulated_id.
cadena (opcional) favicon_url Una URL de ícono para el motor de búsqueda. Solo se puede omitir si se configura prepopulated_id.
cadena search_url Es una URL de búsqueda que usa el motor de búsqueda.
cadena Codificación (opcional) Es la codificación del término de búsqueda. Esta acción solo se puede omitir si se configura prepopulated_id.
cadena (opcional)suggest_url Si se omite, este motor no admite sugerencias.
cadena (opcional) image_url Si se omite, este motor no admite la búsqueda de imágenes.
cadena (opcional) search_url_post_params La cadena de parámetros de publicación de search_url
cadena (opcional)suggest_url_post_params La cadena de parámetros de post parasuggest_url
cadena (opcional) image_url_post_params La cadena de parámetros de publicación de image_url
array de cadena Altern_urls (opcional) Se trata de una lista de los patrones de URL que se pueden usar, además de |search_url|.
integer (opcional) prepropagar_id Es un ID del motor de búsqueda integrado en Chrome.
boolean is_default Especifica si el proveedor de búsqueda debe ser el predeterminado.
startup_pages
(arreglo de string) (opcional)Un array de longitud que contiene una URL que se usará como página de inicio.