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
etstartup_pages
peuvent être localisées à l'aide de l'API chrome.i18n. Pour les extensions externes, les valeurs d'URL
search_provider
,homepage
etstartup_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) : facultatifNouvelle valeur pour la page d'accueil.
search_provider
(objet) : facultatifUn 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) : facultatifTableau de longueurs contenant une URL à utiliser comme page de démarrage.