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
, danstartup_pages
dapat dilokalkan menggunakan chrome.i18n API. Untuk ekstensi eksternal, nilai URL
search_provider
,homepage
, danstartup_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) - opsionalNilai baru untuk halaman beranda.
search_provider
(objek) - opsionalMesin 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) - opsionalArray panjang satu yang berisi URL yang akan digunakan sebagai halaman awal.