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
istartup_pages
można zlokalizować za pomocą interfejsu chrome.i18n API. W przypadku rozszerzeń zewnętrznych wartości adresów URL
search_provider
,homepage
istartup_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) – opcjonalnieNowa wartość adresu strony głównej.
search_provider
(obiekt) – opcjonalnieWyszukiwarka
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) – opcjonalnieTablica o długości 1 z adresem URL, która ma służyć jako strona startowa.