Ayarları geçersiz kılma, uzantıların seçili Chrome ayarlarını geçersiz kılmasına olanak tanıyan bir yöntemdir. API, Windows'da Chrome'un güncel tüm sürümlerinde, Mac'te ise Chrome 56 ve sonraki sürümlerde kullanılabilir.
Ana sayfa, arama sağlayıcısı ve başlangıç sayfaları
Ana sayfanın, arama sağlayıcısının ve başlangıç sayfalarının uzantı manifestinde nasıl değiştirilebileceğine dair bir örneği burada görebilirsiniz. Ayarlar API'sinde kullanılan web siteleri, Chrome Web Mağazası'ndaki söz konusu öğeyle ilişkili olarak doğrulanmalıdır (Web Yöneticisi Araçları üzerinden). Bir alan adı (örneğin, http://example.com) için sahipliği doğruluyorsanız uzantınızda herhangi bir alt alan adını veya sayfayı (örneğin, http://app.example.com veya http://example.com/page.html) kullanabilirsiniz.
{
"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",
...
}
Değerleri özelleştirme
Manifest'teki değerler aşağıdaki şekillerde özelleştirilebilir:
search_provider
,homepage
vestartup_pages
özelliklerinin tüm değerleri chrome.i18n API kullanılarak yerelleştirilebilir.Harici uzantılar için
search_provider
,homepage
vestartup_pages
URL değerleri, bir kayıt defteri anahtarı kullanılarak parametre haline getirilebilir. "update_url" anahtarının yanında yeni bir kayıt defteri girişi oluşturulmalıdır (talimatları burada bulabilirsiniz). Değer adı "install_parameter", değer verileri ise rastgele bir dizedir:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
Manifest URL'lerindeki "__PARAM__" alt dizesinin tüm tekrarları "install_parameter" değeriyle değiştirilir. "install_parameter" yoksa "__PARAM__" örnekleri kaldırılır. "__PARAM__", ana makine adının bir parçası olamayacağını unutmayın. URL'deki ilk "/" karakterinden sonra gelmelidir.
Referans
Bir uzantı, manifest dosyasında aşağıdaki özelliklerden birini veya daha fazlasını geçersiz kılabilir:
homepage
(dize) - isteğe bağlıAna sayfa için yeni değer.
search_provider
(nesne) - isteğe bağlıArama motoru
Tür Özellik Açıklama dize (isteğe bağlı) ad Kullanıcıya gösterilen arama motorunun adı. Bu, yalnızca prepopulated_id ayarlanmışsa atlanabilir.
dize (isteğe bağlı) anahtar kelime Arama motoru için çok amaçlı adres çubuğu anahtar kelimesi. Bu, yalnızca prepopulated_id ayarlanmışsa atlanabilir.
dize (isteğe bağlı) favicon_url Arama motoru için bir simge URL'si. Bu, yalnızca prepopulated_id ayarlanmışsa atlanabilir.
dize search_url Arama motoru tarafından kullanılan bir arama URL'si.
dize (isteğe bağlı) kodlaması Arama teriminin kodlaması. Bu, yalnızca prepopulated_id ayarlanmışsa atlanabilir.
dize (isteğe bağlı)suggest_url Atlanırsa bu motor, önerileri desteklemez.
dize (isteğe bağlı) image_url Atlanırsa bu motor resim aramayı desteklemez.
dize (isteğe bağlı) search_url_post_params search_url için yayın parametrelerinin dizesi
dize (isteğe bağlı)suggest_url_post_params öneri_url'si için yayın parametreleri dizesi
dize (isteğe bağlı) image_url_post_params image_url için yayın parametrelerinin dizesi
dize dizisi (isteğe bağlı) alternate_urls |search_url|'ye ek olarak kullanılabilecek URL kalıplarının listesi.
tam sayı (isteğe bağlı) prefilled_id Chrome'daki yerleşik arama motorunun kimliği.
boolean is_default Arama sağlayıcısının varsayılan olup olmayacağını belirtir.
startup_pages
(dize dizisi) - isteğe bağlıBaşlangıç sayfası olarak kullanılacak URL'yi içeren bir uzunluk dizisi.