Переопределение настроек Chrome

Переопределение настроек – это способ расширений переопределить выбранные настройки Chrome. API доступен в Windows во всех текущих версиях Chrome и доступен на Mac в Chrome 56 и более поздних версиях.

Домашняя страница, поисковая система и стартовые страницы

Вот пример того, как домашнюю страницу , поисковую систему и стартовые страницы можно изменить в манифесте расширения . Веб-сайты, используемые в API настроек, должны быть проверены (с помощью Инструментов для веб-мастеров) как связанные с этим элементом в Интернет-магазине Chrome. Обратите внимание: если вы подтвердите право собственности на домен (например, http://example.com), вы можете использовать любой субдомен или страницу (например, http://app.example.com или http://example.com/). page.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",
   ...
}

Настройка значений

Значения в манифесте можно настроить следующими способами:

• Все значения свойств search_provider , homepage и startup_pages можно локализовать с помощью API chrome.i18n .

• Для внешних расширений значения URL-адресов search_provider , homepage и startup_pages можно параметризовать с помощью ключа реестра. Рядом с ключом «update_url» должна быть создана новая запись реестра (инструкции см. здесь ). Имя значения — «install_parameter», данные значения — произвольная строка:

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

  Все вхождения подстроки «__PARAM__» в URL-адресах манифеста будут заменены значением «install_parameter». Если «install_parameter» отсутствует, вхождения «__PARAM__» удаляются. Обратите внимание, что «__PARAM__» не может быть частью имени хоста. Это должно произойти после первого символа «/» в URL-адресе.

Ссылка

Расширение может переопределить одно или несколько из следующих свойств в манифесте:

• homepage (строка) – необязательно

  Новое значение главной страницы.

• search_provider (объект) – необязательно

  Поисковая система

  Тип	Атрибут	Описание
  нить	(необязательно) имя	Название поисковой системы, отображаемое пользователю. Это можно пропустить, только если установлен prepopulated_id .
  нить	(необязательно) ключевое слово	Ключевое слово омнибокса для поисковой системы. Это можно пропустить, только если установлен prepopulated_id .
  нить	(необязательно) favicon_url	URL-адрес значка для поисковой системы. Это можно пропустить, только если установлен prepopulated_id .
  нить	URL-адрес поиска	URL-адрес поиска, используемый поисковой системой.
  нить	(необязательно) кодировка	Кодирование поискового запроса. Это можно пропустить, только если установлен prepopulated_id .
  нить	(необязательно) submit_url	Если этот параметр опущен, этот движок не поддерживает предложения.
  нить	(необязательно) image_url	Если этот параметр опущен, этот движок не поддерживает поиск изображений.
  нить	(необязательно) search_url_post_params	Строка параметров публикации для search_url
  нить	(необязательно) submit_url_post_params	Строка параметров публикации для submit_url.
  нить	(необязательно) image_url_post_params	Строка параметров публикации в image_url
  массив строк	(необязательно) альтернативные_urls	Список шаблонов URL-адресов, которые можно использовать помимо |search_url|.
  целое число	(необязательно) prepopulated_id	Идентификатор встроенной поисковой системы в Chrome.
  логическое значение	is_default	Указывает, должен ли поставщик поиска использоваться по умолчанию.

• startup_pages (массив строк) — необязательно

  Массив длиной один, содержащий URL-адрес, который будет использоваться в качестве стартовой страницы.