Remplacement des paramètres Chrome

Les paramètres de remplacement permettent aux extensions de remplacer les paramètres Chrome sélectionnés. L'API est disponible sous Windows dans toutes les versions actuelles de Chrome et sur Mac à partir de Chrome 56.

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

Voici un exemple de modification des pages 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 les outils pour les webmasters) comme étant associés à l'élément concerné sur le Chrome Web Store. Notez que si vous validez la propriété d'un domaine (par exemple, http://example.com), vous pouvez utiliser n'importe quel sous-domaine ou 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ées à l'aide d'une clé de registre. Une entrée de registre doit être créée à côté de la clé "update_url" (voir les instructions ici). Le nom de la valeur est "install_parameter", les données de la valeur sont 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 seront remplacées par la valeur "install_parameter". Si "install_parameter" est absent, les occurrences de "__PARAM__" sont supprimées. Notez que "__PARAM__" ne peut pas faire partie du nom d'hôte. Il doit apparaître après le premier caractère "/" dans l'URL.

Reference

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 (facultatif) nom

    Nom du moteur de recherche présenté à l'utilisateur Cette valeur ne peut être omise que si prepopulated_id est défini.
    chaîne Mot clé (facultatif)

    Mot clé de l'omnibox pour le moteur de recherche. Cette valeur ne peut être omise que si prepopulated_id est défini.
    chaîne (facultatif) favicon_url

    URL d'icône pour le moteur de recherche. Cet attribut ne peut être omis que si prepopulated_id est défini.
    chaîne search_url

    URL de recherche utilisée par le moteur de recherche.
    chaîne Encodage (facultatif)

    Encodage du terme de recherche. Cet attribut ne peut être omis que si le champ prepopulated_id est défini.
    chaîne (facultatif) suggestion_url

    En cas d'omission, ce moteur n'accepte pas les suggestions.
    chaîne (facultatif) image_url

    S'il est omis, ce moteur n'est pas compatible avec la recherche d'images.
    chaîne (facultatif) search_url_post_params

    Chaîne de paramètres des posts dans search_url
    chaîne (facultatif) suggest_url_post_params

    Chaîne de paramètres du post vers suggest_url
    chaîne (facultatif) image_url_post_params

    Chaîne des paramètres de post dans image_url
    tableau de chaînes (facultatif) "alternate_urls"

    Une liste de formats d'URL pouvant être utilisés, en plus de |search_url|.
    integer (facultatif) preremplir_id

    ID du moteur de recherche intégré à Chrome.
    boolean is_default

    Indique si le moteur de recherche doit être utilisé par défaut.

  • startup_pages (tableau de chaînes) : facultatif

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