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.