Ghi đè cài đặt Chrome

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

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

Sau đây là một ví dụ về cách 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 được 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. Xin 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 bạn.

{
  "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 các giá trị trong tệp kê khai theo các 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 cách sử dụng chrome.i18n API.

  • Đối với các tiện ích bên ngoài, các giá trị URL search_provider, homepage và startup_pages có thể được tham số bằng cách sử dụng khoá đăng ký. Bạn cần tạo một mục nhập mới trong sổ đăng ký bên cạnh khoá "update_url" (xem hướng dẫn tại đây). Tên giá trị là "install_parameter", giá trị dữ liệu 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 là "install_parameter" không có, các lần xuất hiện "__PARAM__" là đã bị xóa. Xin lưu ý rằng "__PARAM__" không được là một phần của tên máy chủ. Phần này cần xuất hiện sau dấu "/" đầu tiên trong URL.

Tài liệu tham khảo

Một 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 Mô tả
    string (không bắt buộc) tên

    Tên của công cụ tìm kiếm hiển thị cho người dùng. Bạn chỉ có thể bỏ qua trường 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. Điều này chỉ có thể được bỏ qua nếu prepopulated_id đã được đặt.
    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. Chỉ có thể bỏ qua thuộc tính này nếu prepopulated_id đã được đặt.
    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 có prepopulated_id thiết lập.
    string (không bắt buộc) recommended_url

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

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

    Chuỗi tham số bài đăng đến search_url
    string (không bắt buộc) recommended_url_post_params

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

    Chuỗi thông số đăng lên image_url
    mảng chuỗi (không bắt buộc) thay thế_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) prepopulated_id

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

    Chỉ định xem nhà cung cấp dịch vụ tìm kiếm có phải là 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 một chứa một URL được dùng làm trang khởi động.