Mengganti setelan Chrome

Penggantian setelan adalah cara ekstensi untuk mengganti setelan Chrome yang dipilih. API-nya merupakan tersedia di Windows di semua versi Chrome saat ini dan tersedia pada Mac di Chrome 56 serta nanti.

Halaman beranda, penyedia penelusuran, dan halaman awal

Berikut contoh cara mengubah halaman beranda, penyedia penelusuran, dan halaman awal 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 API chrome.i18n.

  • Untuk ekstensi eksternal, nilai URL search_provider, homepage, dan startup_pages dapat diparameterisasi menggunakan kunci {i>registry<i}. Entri registry baru harus dibuat di sebelah &quot;update_url&quot; kunci (lihat petunjuk di sini). Nama nilainya adalah "install_parameter", yaitu nilai data 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 &quot;install_parameter&quot; dengan sejumlah nilai. Jika "install_parameter" tidak ada, kejadian "__PARAM__" adalah dihapus. Perhatikan bahwa "__PARAM__" tidak boleh menjadi bagian dari nama {i>host<i}. Hal itu 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 (opsional) nama

    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 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 postingan ke image_url
    array string (opsional) override_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 panjangnya yang berisi URL yang akan digunakan sebagai halaman awal.