Remplacement des paramètres Chrome

Les forçages de paramètres permettent aux extensions de remplacer certains paramètres Chrome. L'API est disponible sous Windows dans toutes les versions actuelles de Chrome et sur Mac dans Chrome 56 et ultérieurement.

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

Voici un exemple de modification de la page d'accueil, du fournisseur 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 de différentes manières :

  • 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. Créez une entrée de registre à côté de "update_url" (URL de mise à jour) (pour obtenir des instructions, cliquez ici). Le nom de la valeur est "install_parameter", les données de 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 sera remplacé par le "paramètre_installation" . 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 se trouver après le premier "/" de 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 (facultatif) nom

    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 utilisé. 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 cet élément est omis, ce moteur n'est pas compatible avec les suggestions.
    chaîne (facultatif) image_url

    Si cet élément est omis, ce moteur ne prend pas en charge la recherche d'images.
    chaîne (facultatif) search_url_post_params

    Chaîne de paramètres POST à search_url
    chaîne (facultatif) suggest_url_post_params

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

    Chaîne de paramètres de publication à 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) prepopulated_id

    ID du moteur de recherche intégré dans 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.