Zastępowanie ustawień Chrome

Zastąpienia ustawień umożliwiają rozszerzeniom zastąpienie wybranych ustawień Chrome. Interfejs API jest dostępny w systemach Windows we wszystkich aktualnych wersjach Chrome, a także na komputerach Mac w Chrome 56 i nowszych wersjach.

Strona główna, dostawca wyszukiwania i strony startowe

Oto przykład zmiany strony głównej, dostawcy wyszukiwania i stron startowych w pliku manifestu rozszerzenia. Witryny używane w interfejsie API ustawień muszą zostać zweryfikowane (przy użyciu Narzędzi dla webmasterów) jako powiązane z danym produktem w Chrome Web Store. Pamiętaj, że jeśli potwierdzisz własność domeny (np. http://example.com), możesz w rozszerzeniu użyć dowolnej subdomeny lub strony (na przykład http://aplikacja.example.com lub http://example.com/strona.html).

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

Dostosowywanie wartości

Wartości w pliku manifestu można dostosowywać na te sposoby:

  • Wszystkie wartości właściwości search_provider, homepage i startup_pages można zlokalizować za pomocą interfejsu chrome.i18n API.

  • W przypadku rozszerzeń zewnętrznych wartości adresów URL search_provider, homepage i startup_pages można sparametryzować za pomocą klucza rejestru. Obok klucza „update_url” utwórz nowy wpis rejestru (instrukcje znajdziesz tutaj). Nazwa wartości to „instalacja_parametru”, a dane wartości to dowolny ciąg znaków:

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

    Wszystkie wystąpienia podłańcucha „__PARAM__” w adresach URL pliku manifestu zostaną zastąpione wartością „install_parameter”. Jeśli brakuje parametru „install_parameter”, wystąpienia „__PARAM__” są usuwane. Pamiętaj, że parametr „__PARAM__” nie może być częścią nazwy hosta. Musi on występować w adresie URL po pierwszym znaku „/”.

Dokumentacja

Rozszerzenie może zastąpić co najmniej 1 z tych właściwości w pliku manifestu:

  • homepage (ciąg znaków) – opcjonalnie

    Nowa wartość adresu strony głównej.

  • search_provider (obiekt) – opcjonalnie

    Wyszukiwarka

    Typ Atrybut Opis
    ciąg znaków (opcjonalnie) imię i nazwisko,

    Nazwa wyszukiwarki wyświetlana użytkownikowi. Tę wartość można pominąć tylko wtedy, gdy ustawiony jest parametr prepopulated_id.
    ciąg znaków (opcjonalne) słowo kluczowe

    Słowo kluczowe w omniboksie dla wyszukiwarki. Tę wartość można pominąć tylko wtedy, gdy ustawiony jest parametr prepopulated_id.
    ciąg znaków (opcjonalnie) favicon_url

    Adres URL ikony wyszukiwarki. Tę wartość można pominąć tylko wtedy, gdy ustawiony jest parametr prepopulated_id.
    ciąg znaków search_url

    Adres URL wyszukiwania używany przez wyszukiwarkę.
    ciąg znaków Kodowanie (opcjonalne)

    Kodowanie wyszukiwanego hasła. Tę wartość można pominąć tylko wtedy, gdy ustawiony jest parametr prepopulated_id.
    ciąg znaków (opcjonalnie)suggest_url

    Jeśli go pominiesz, ta wyszukiwarka nie będzie obsługiwać sugestii.
    ciąg znaków (opcjonalnie) image_url (adres URL obrazu)

    Jeśli go pominiesz, ta wyszukiwarka nie będzie obsługiwać wyszukiwania grafiki.
    ciąg znaków (opcjonalnie) search_url_post_params

    Ciąg parametrów posta do parametru search_url
    ciąg znaków (opcjonalnie)suggest_url_post_params

    Ciąg parametrów posta do sugerowanego adresu URL
    ciąg znaków (opcjonalnie) image_url_post_params

    Ciąg parametrów posta do parametru image_url
    tablica ciągów znaków (opcjonalnie) alternatywne_adresy URL

    Lista wzorców adresów URL, które można używać razem z parametrem |url_wyszukiwania|.
    Liczba całkowita (opcjonalnie) wstępnie wypełniony identyfikator

    Identyfikator wbudowanej wyszukiwarki w Chrome.
    boolean is_default

    Określa, czy dostawca wyszukiwania powinien być domyślnym.

  • startup_pages (tablica ciągu znaków) – opcjonalnie

    Tablica o długości 1 z adresem URL, która ma służyć jako strona startowa.