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

Aquí te mostramos 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 para 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) en 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",
   ...
}

Personaliza 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 al "update_url" (consulte las instrucciones aquí). El nombre del valor es "install_parameter", el valor data es una cadena arbitraria:

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

  Todos los casos de la subcadena "__PARAM__" de las URLs del manifiesto se sustituirán por el "install_parameter" valor. Si es "install_parameter" está ausente, casos de "__Parámetro__" son o quitarse. Tenga 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

  Nuevo valor para 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	Una URL de ícono para el motor de búsqueda. Solo se puede omitir si prepopulated_id esté establecida.
  string	search_url	Una URL de búsqueda utilizada por el motor de búsqueda.
  string	Codificación (opcional)	Es la codificación del término de búsqueda. Solo se puede omitir si prepopulated_id es automático.
  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	La cadena de los parámetros de publicación para search_url
  string	(opcional):suggest_url_post_params	La cadena de parámetros de publicación para suggested_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 los patrones de URL que se pueden usar, además de |search_url|.
  integer	id_precargado (opcional)	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 (array de cadenas): opcional

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