Zastępowanie ustawień Chrome

Zastąpienia ustawień to sposób, w jaki rozszerzenia mogą zastąpić wybrane ustawienia Chrome. Interfejs API jest dostępny w Windowsie we wszystkich aktualnych wersjach Chrome, a w przypadku komputerów Mac – w Chrome w wersji 56 i nowszych.

strona główna, strona wyszukiwarki i strony startowe;

Oto przykład modyfikacji strony głównej, usługodawcy wyszukiwania i strony startowej w pliku manifestu rozszerzenia. Witryny internetowe używane w interfejsie API ustawień muszą być zweryfikowane (za pomocą webmastera Narzędzia) jako powiązanego z danym produktem w Chrome Web Store. Pamiętaj, że jeśli potwierdzisz własność domeny (np. http://example.com), możesz użyć dowolnej subdomeny lub strony (np. http://app.example.com lub http://example.com/page.html) w ramach rozszerzenia.

{
  "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 dostosować 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 search_provider, homepage i startup_pages adresu URL mogą być sparametryzowane za pomocą klucza rejestru. Obok klucza „update_url” należy utworzyć nowy wpis rejestru (instrukcje znajdziesz tutaj). Nazwa wartości to „install_parameter”, a wartość danych 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 manifestu zostanie zastąpiony ciągiem „install_parameter” . Jeśli parametr „install_parameter” jest nieobecny, wystąpienia parametru „__PARAM__” są usuwane. Pamiętaj, że parametr „__PARAM__” nie może być częścią nazwy hosta. Musi ona występować po pierwszym „/” w adresie URL.

Dokumentacja

Rozszerzenie może zastąpić jedną lub kilka z tych właściwości w pliku manifestu:

• homepage (ciąg tekstowy) – opcjonalnie

  Nowa wartość dotycząca strony głównej.

• search_provider (obiekt) – opcjonalnie

  wyszukiwarka,

  Typ	Atrybut	Opis
  ciąg znaków	(opcjonalnie) nazwa	Nazwa wyszukiwarki wyświetlana użytkownikowi. Może być pominięty tylko wtedy, gdy parametr prepopulated_id jest ustawiony.
  ciąg znaków	(opcjonalnie) słowo kluczowe.	Słowo kluczowe w omniboksie wyszukiwarki. Może być pominięty tylko wtedy, gdy parametr prepopulated_id jest ustawiony.
  ciąg znaków	(opcjonalnie) favicon_url	Adres URL ikony wyszukiwarki. Tę wartość można pominąć tylko wtedy, gdy atrybut prepopulated_id jest ustawiony.
  ciąg znaków	search_url	Adres URL wyszukiwania używany przez wyszukiwarkę.
  ciąg znaków	kodowanie (opcjonalne)	Kodowanie wyszukiwanego hasła. Może ona być pominięta tylko wtedy, gdy ustawiono parametr prepopulated_id.
  ciąg znaków	(opcjonalnie) suggest_url	Jeśli nazwa zostanie pominięta, ten mechanizm nie obsługuje sugestii.
  ciąg znaków	(opcjonalnie) image_url	Jeśli nie zostanie podany, ten mechanizm nie będzie obsługiwał wyszukiwania obrazów.
  ciąg znaków	(opcjonalnie) search_url_post_params	Ciąg parametrów postów do parametru search_url
  ciąg znaków	(opcjonalnie) suggest_url_post_params	Ciąg parametrów posta do sugerować_url
  ciąg znaków	(opcjonalnie) image_url_post_params	Ciąg parametrów przesyłania do image_url
  tablica ciągu znaków	(opcjonalnie) alternatywne_adresy_url	Lista wzorców adresów URL, które można używać oprócz parametru |search_url|.
  liczba całkowita	(opcjonalnie) uzupełniony_id	Identyfikator wbudowanej wyszukiwarki w Chrome.
  wartość logiczna	is_default	Określa, czy dostawca wyszukiwania ma być domyślny.

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

  Tablica o długości 1 zawierająca adres URL, który ma być używany jako strona uruchamiania.