Remplacement des paramètres Chrome

Le remplacement des paramètres permet aux extensions de remplacer les paramètres Chrome sélectionnés. L'API est disponible pour Windows dans toutes les versions actuelles de Chrome et pour Mac dans Chrome 56 et plus tard.

Page d'accueil, moteur de recherche et pages de démarrage

Voici un exemple de modification de la page d'accueil, du moteur de recherche et des pages de démarrage dans le fichier manifeste de l'extension. Les sites Web utilisés dans l'API des paramètres doivent être validés (via l'outil webmaster outils) comme étant associé à cet article sur le Chrome Web Store. Notez que si vous confirmez que vous êtes le propriétaire Pour un domaine (par exemple, http://example.com), vous pouvez utiliser n'importe quel sous-domaine ou n'importe quelle page (par exemple, http://app.example.com ou http://example.com/page.html) dans votre extension.

{
  "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",
   ...
}

Personnaliser les valeurs

Les valeurs du fichier manifeste peuvent être personnalisées comme suit:

• Toutes les valeurs des propriétés search_provider, homepage et startup_pages peuvent être localisées à l'aide de l'API chrome.i18n.

• Pour les extensions externes, les valeurs d'URL search_provider, homepage et startup_pages peuvent être paramétrés à l'aide d'une clé de registre. Créez une entrée de registre à côté de "update_url" (pour obtenir des instructions, cliquez ici). Le nom de la valeur est "install_parameter", la valeur données est une chaîne arbitraire:

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

  Toutes les occurrences de la sous-chaîne "__PARAM__" dans les URL du fichier manifeste sera remplacé par le "install_parameter" . Si "install_parameter" est absente, occurrences de "__PARAM__" sont supprimés. Notez que "__PARAM__" ne peut pas faire partie du nom d'hôte. Elle doit avoir lieu après le premier "/" dans l'URL.

Référence

Une extension peut remplacer une ou plusieurs des propriétés suivantes dans le fichier manifeste:

• homepage (chaîne) : facultatif

  Nouvelle valeur pour la page d'accueil.

• search_provider (objet) : facultatif

  Un moteur de recherche

  Type	Attribut	Description
  chaîne	Nom (facultatif)	Nom du moteur de recherche présenté à l'utilisateur. Vous ne pouvez l'omettre que si prepopulated_id est défini.
  chaîne	(facultatif) mot clé	Mot clé associé à l'omnibox pour le moteur de recherche. Vous ne pouvez l'omettre que si prepopulated_id est défini.
  chaîne	(facultatif) favicon_url	URL de l'icône pour le moteur de recherche. Cette valeur ne peut être omise que si l'attribut prepopulated_id est définie.
  chaîne	search_url	URL de recherche utilisée par le moteur de recherche.
  chaîne	Encodage (facultatif)	Encodage du terme de recherche. Cette valeur ne peut être omise que si la valeur prepopulated_id est défini.
  chaîne	(facultatif) suggest_url	Si cette valeur est omise, ce moteur n'accepte pas les suggestions.
  chaîne	(facultatif) image_url	Si cette valeur est omise, ce moteur n'accepte pas la recherche d'images.
  chaîne	(facultatif) search_url_post_params	Chaîne de paramètres des articles dans search_url
  chaîne	(facultatif) suggest_url_post_params	Chaîne de paramètres post pour suggest_url
  chaîne	(facultatif) image_url_post_params	Chaîne de paramètres post dans image_url
  tableau de chaînes	(facultatif) alternatives_urls	Liste des formats d'URL pouvant être utilisés, en plus de |search_url|.
  entier	(facultatif) prérempli_id	ID du moteur de recherche intégré à Chrome.
  booléen	is_default	Indique si le moteur de recherche doit être défini par défaut.

• startup_pages (tableau de chaînes) : facultatif

  Tableau de longueur 1 contenant une URL à utiliser comme page de démarrage.