Chrome ayarlarını geçersiz kılma

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 ve startup_pages özelliklerinin tüm değerleri chrome.i18n API kullanılarak yerelleştirilebilir.

• Harici uzantılar için search_provider, homepage ve startup_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.