Переопределение настроек 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-адрес, который будет использоваться в качестве стартовой страницы.