Mengganti setelan Chrome

Penggantian setelan adalah cara ekstensi untuk mengganti setelan Chrome yang dipilih. API ini tersedia di Windows di semua versi Chrome saat ini dan tersedia di Mac di Chrome 56 dan yang lebih baru.

Halaman beranda, penyedia penelusuran, dan halaman awal

Berikut adalah contoh cara halaman beranda, penyedia penelusuran, dan halaman awal dapat diubah di manifes ekstensi. Situs yang digunakan dalam API setelan harus diverifikasi (melalui Webmaster ) yang dikaitkan dengan item tersebut di Chrome Web Store. Perhatikan bahwa jika Anda memverifikasi kepemilikan untuk 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 diparametrikan menggunakan kunci registry. Entri registry baru harus dibuat di sebelah "update_url" kunci (lihat petunjuk di sini). Nama nilainya adalah "install_parameter", data nilainya adalah string arbitrer:

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

  Semua kemunculan substring "__PARAM__" dalam manifes, URL akan diganti dengan "parameter_penginstalan" dengan sejumlah nilai. Jika "install_parameter" tidak ada, kemunculan "__PARAM__" akan dihapus. Perhatikan bahwa "__PARAM__" tidak boleh menjadi bagian dari nama host. Hal ini harus terjadi setelah '/' pertama di 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 ditetapkan.
  string	(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 sudah diatur.
  string	search_url	URL penelusuran yang digunakan oleh mesin telusur.
  string	Encoding (opsional)	Encoding istilah penelusuran. Kolom ini hanya dapat dihilangkan jika prepopulated_id diisi atur.
  string	(opsional) suggest_url	Jika dihilangkan, mesin ini tidak 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)Suggest_url_post_params	String parameter postingan untuk suggested_url
  string	(opsional) image_url_post_params	String parameter post 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 default.

• startup_pages (array string) - opsional

  Array panjangnya berisi URL yang akan digunakan sebagai halaman awal.