Anula la configuración de Chrome

Las anulaciones de configuración son una forma de que las extensiones anulen la configuración seleccionada de Chrome. La API es disponible en Windows en todas las versiones actuales de Chrome y está disponible para Mac en Chrome 56 y más adelante.

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 se deben verificar (a través del webmaster Tools) como asociados a 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 del 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, se pueden usar los valores de URL search_provider, homepage y startup_pages parametrizarse con 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" y los datos del valor son una cadena arbitraria:

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

  Todas las ocurrencias de la subcadena "__PARAM__" en las URLs del manifiesto se reemplazarán por el valor "install_parameter". Si no hay "install_parameter", se quitan las ocurrencias de "__PARAM__". Ten en cuenta que "__PARAM__" no puede ser parte del nombre de host. Tiene que ocurrir después del primer “/” en la URL.

Referencia

Una extensión puede anular una o más de las siguientes propiedades en el manifiesto:

• homepage (cadena): Opcional

  Es el valor nuevo de la página principal.

• search_provider (objeto): Opcional

  Un motor de búsqueda

  Tipo	Atributo	Descripción
  string	Nombre (opcional)	Es el nombre del motor de búsqueda que se muestra al usuario. Esto solo se puede omitir si prepopulated_id.
  string	Palabra clave (opcional)	Palabra clave del cuadro multifunción para el motor de búsqueda. Esto solo se puede omitir si prepopulated_id.
  string	(opcional) favicon_url	Es una URL de ícono para el motor de búsqueda. Solo se puede omitir si se establece prepopulated_id.
  string	search_url	Es una URL de búsqueda que usa el motor de búsqueda.
  string	Codificación (opcional)	Codificación del término de búsqueda. Solo se puede omitir si se establece prepopulated_id.
  string	(opcional): sugiere_url	Si se omite, este motor no admite sugerencias.
  string	(opcional) image_url	Si se omite, este motor no admite la búsqueda de imágenes.
  string	(opcional) search_url_post_params	Es la cadena de parámetros de publicación para search_url.
  string	(opcional) suggest_url_post_params	Es la cadena de parámetros de publicación para suggest_url.
  string	(opcional) image_url_post_params	La cadena de los parámetros de publicación en image_url
  array de cadenas	URL_alternativas (opcional)	Es una lista de patrones de URL que se pueden usar, además de |search_url|.
  integer	(opcional) prepopulated_id	Un ID del motor de búsqueda integrado en Chrome.
  boolean	is_default	Especifica si el proveedor de búsqueda debe ser predeterminado.

• startup_pages (array de cadenas): opcional

  Un array de longitud uno que contiene una URL que se usará como página de inicio.