Mengganti setelan Chrome

Penggantian setelan merupakan cara bagi ekstensi untuk mengganti setelan Chrome yang dipilih. API ini tersedia di Windows di semua versi Chrome terbaru dan tersedia di Mac pada Chrome 56 dan yang lebih baru.

Halaman beranda, penyedia penelusuran, dan halaman awal

Berikut adalah contoh cara mengubah halaman beranda, penyedia penelusuran, dan halaman awal di manifes ekstensi. Situs yang digunakan di API setelan harus diverifikasi (melalui Alat Webmaster) sebagai terkait dengan item tersebut di Chrome Web Store. Perhatikan bahwa jika Anda memverifikasi kepemilikan domain (misalnya, http://example.com), Anda dapat menggunakan subdomain atau halaman apa pun (misalnya, http://app.example.com atau http://example.com/page.html) dalam ekstensi Anda.

{
  "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",
   ...
}

Menyesuaikan nilai

Nilai dalam manifes dapat disesuaikan dengan cara berikut:

• Semua nilai properti search_provider, homepage, dan startup_pages dapat dilokalkan menggunakan chrome.i18n API.

• Untuk ekstensi eksternal, nilai URL search_provider, homepage, dan startup_pages dapat ditetapkan menggunakan kunci registry. Entri registry baru harus dibuat di samping kunci "update_url" (lihat petunjuk di sini). Nama nilainya adalah "install_parameter", data nilai adalah string arbitrer:

  {
    "update_url": "https://clients2.google.com/service/update2/crx",
    "install_parameter": "Value"
  }
  

  Semua kemunculan substring "__PARAM__" di URL manifes akan diganti dengan nilai "install_parameter". Jika "install_parameter" tidak ada, kemunculan "__PARAM__" akan dihapus. Perhatikan bahwa "__PARAM__" tidak boleh berupa bagian dari nama host. Nama ini harus muncul setelah '/' pertama pada URL.

Referensi

Ekstensi dapat mengganti satu atau beberapa properti berikut dalam manifes:

• homepage (string) - opsional

  Nilai baru untuk halaman beranda.

• search_provider (objek) - opsional

  Mesin telusur

  Jenis	Atribut	Deskripsi
  string	Nama (opsional)	Nama mesin telusur yang ditampilkan kepada pengguna. Kolom ini hanya dapat dihilangkan jika prepopulated_id sudah ditetapkan.
  string	Kata kunci (opsional)	Kata kunci omnibox untuk mesin telusur. Kolom ini hanya dapat dihilangkan jika prepopulated_id sudah ditetapkan.
  string	(opsional) favicon_url	URL ikon untuk mesin telusur. Kolom ini hanya dapat dihilangkan jika prepopulated_id hanya ditetapkan.
  string	search_url	URL penelusuran yang digunakan oleh mesin telusur.
  string	Encoding (opsional)	Encoding istilah penelusuran. Nilai ini hanya dapat dihilangkan jika prepopulated_id sudah ditetapkan.
  string	(opsional) suggested_url	Jika dihilangkan, mesin ini tidak akan mendukung saran.
  string	(opsional) image_url	Jika dihilangkan, mesin ini tidak mendukung penelusuran gambar.
  string	(opsional) search_url_post_params	String parameter postingan ke search_url
  string	(opsional) suggested_url_post_params	String parameter postingan untuk suggested_url
  string	(opsional) image_url_post_params	String parameter postingan ke image_url
  array string	(opsional) alternate_urls	Daftar pola URL yang dapat digunakan, selain |search_url|.
  bilangan bulat	(opsional) prefilled_id	ID mesin telusur bawaan di Chrome.
  boolean	is_default	Menentukan apakah penyedia penelusuran harus ditetapkan secara default.

• startup_pages (array string) - opsional

  Array panjang satu yang berisi URL yang akan digunakan sebagai halaman awal.