Ghi đè cài đặt Chrome

Ghi đè chế độ cài đặt là một cách để tiện ích ghi đè các chế độ cài đặt đã chọn của Chrome. API này có trên Windows trong tất cả các phiên bản Chrome hiện tại và có trên Chrome 56 trở lên trên máy Mac.

Trang chủ, nhà cung cấp dịch vụ tìm kiếm và trang khởi động

Sau đây là ví dụ về cách bạn có thể sửa đổi trang chủ, nhà cung cấp dịch vụ tìm kiếm và trang khởi động trong tệp kê khai tiện ích. Các trang web dùng trong API cài đặt phải được xác minh (thông qua Công cụ quản trị trang web) là được liên kết với mục đó trong Cửa hàng Chrome trực tuyến. Lưu ý rằng nếu bạn xác minh quyền sở hữu đối với một miền (ví dụ: http://example.com), bạn có thể sử dụng bất kỳ miền con hoặc trang nào (ví dụ: http://app.example.com hoặc http://example.com/page.html) trong tiện ích của mình.

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

Tuỳ chỉnh giá trị

Bạn có thể tuỳ chỉnh giá trị trong tệp kê khai theo những cách sau:

  • Bạn có thể bản địa hoá tất cả giá trị của các thuộc tính search_provider, homepage và startup_pages bằng API chrome.i18n.

  • Đối với tiện ích bên ngoài, giá trị URL search_provider, homepage và startup_pages có thể được tham số hoá bằng khoá đăng ký. Bạn cần tạo một mục nhập sổ đăng ký mới bên cạnh khoá "update_url" (xem hướng dẫn tại đây). Tên giá trị là "install_parameter", dữ liệu giá trị là một chuỗi tuỳ ý:

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

    Tất cả các lần xuất hiện của chuỗi con "__PARAM__" trong URL tệp kê khai sẽ được thay thế bằng giá trị "install_parameter". Nếu không có "install_parameter", thì các lần xuất hiện của "__PARAM__" sẽ bị xoá. Lưu ý rằng "__PARAM__" không thể là một phần của tên máy chủ. Nó cần xuất hiện sau "/" đầu tiên trong URL.

Tài liệu tham khảo

Tiện ích có thể ghi đè một hoặc nhiều thuộc tính sau trong tệp kê khai:

  • homepage (chuỗi) – không bắt buộc

    Giá trị mới cho trang chủ.

  • search_provider (đối tượng) – không bắt buộc

    Công cụ tìm kiếm

    Loại Thuộc tính Nội dung mô tả
    string Tên (không bắt buộc)

    Tên của công cụ tìm kiếm mà người dùng nhìn thấy. Bạn chỉ có thể bỏ qua thuộc tính này nếu đặt prepopulated_id.
    string Từ khoá (không bắt buộc)

    Từ khoá trên thanh địa chỉ cho công cụ tìm kiếm. Bạn chỉ có thể bỏ qua thuộc tính này nếu đặt prepopulated_id.
    string (không bắt buộc) biểu tượng trang web_url

    URL biểu tượng cho công cụ tìm kiếm. Bạn chỉ có thể bỏ qua thuộc tính này nếu đặt prepopulated_id.
    string search_url

    URL tìm kiếm mà công cụ tìm kiếm sử dụng.
    string Mã hoá (không bắt buộc)

    Mã hoá cụm từ tìm kiếm. Bạn chỉ có thể bỏ qua thuộc tính này nếu đã đặt thuộc tính prepopulated_id.
    string (không bắt buộc) suggested_url

    Nếu bỏ qua, công cụ này sẽ không hỗ trợ các đề xuất.
    string (không bắt buộc) image_url

    Nếu bạn bỏ qua thì công cụ này sẽ không hỗ trợ tìm bằng hình ảnh.
    string (không bắt buộc) search_url_post_params

    Chuỗi thông số bài đăng tới search_url
    string (không bắt buộc) suggested_url_post_params

    Chuỗi thông số bài đăng đến recommended_url
    string (không bắt buộc) image_url_post_params

    Chuỗi thông số bài đăng vào image_url
    mảng chuỗi (không bắt buộc) alternate_url

    Danh sách các mẫu URL có thể sử dụng, ngoài |search_url|.
    số nguyên (không bắt buộc) prefilled_id

    Mã của công cụ tìm kiếm tích hợp sẵn trong Chrome.
    boolean is_default

    Chỉ định xem có nên đặt nhà cung cấp dịch vụ tìm kiếm theo mặc định hay không.

  • startup_pages (mảng chuỗi) – không bắt buộc

    Một mảng có độ dài là một mảng chứa URL sẽ được dùng làm trang khởi động.