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 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 dùng trong API cài đặt phải được xác minh (thông qua Quản trị viên trang web Tools) được liên kết với mặt hàng đó 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 giá trị trong tệp kê khai theo các cách sau:

  • Tất cả giá trị của thuộc tính search_provider, homepage và startup_pages đều có thể được bản địa hoá thông qua API chrome.i18n.

  • Đố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ý. Một mục nhập đăng ký mới phải được tạo bên cạnh "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 tệp kê khai, URL sẽ được thay thế bằng "install_parameter" giá trị. 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 thể là một phần của tên máy chủ. Việc này cần xảy ra sau khi '/' đầ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 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. Điều này chỉ có thể được bỏ qua nếu prepopulated_id được đặt.
    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 được công cụ tìm kiếm sử dụng.
    string (không bắt buộc) mã hoá

    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ó thuộc tính 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 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 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 thông số bài đăng tới search_url
    string (không bắt buộc) recommended_url_post_params

    Chuỗi các thông số bài đăng cho tới hàm gợi ý_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) prepersonalized_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 có nên đặt nhà cung cấp dịch vụ tìm kiếm làm nhà cung cấp dịch vụ 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 1 chứa URL được sử dụng làm trang khởi động.