Anula la configuración de Chrome

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 y startup_pages se pueden localizar con la API de chrome.i18n.

• En el caso de las extensiones externas, los valores de URL search_provider, homepage y startup_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): opcional

  Nuevo valor para la página principal.

• search_provider (objeto) - opcional

  Un 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.