Как помочь посетителю сайта обновить свой браузер?

Некоторые посетители вашего сайта могут пользоваться устаревшим или совсем не подходящим для вашего сайта браузером. Чтобы помочь такому посетителю обновить или установить нужный браузер, вы можете настроить уведомления на сайте с помощью скрипта Яндекса.

Доступно два типа уведомлений: «браузер устарел» и «браузер не поддерживается сайтом».

Браузер устарел

Пользователи устаревших браузеров видят предложение обновиться при каждой загрузке страницы. Уведомление выводится в виде плашки вверху страницы. По клике на плашку открывается попап со ссылками на последние версии популярных браузеров.

Вы можете выбрать минимальные версии браузеров самостоятельно, либо положиться на список по умолчанию, который поддерживает Яндекс (подробнее — в инструкциях ниже). Если вы пользуетесь собственным списком, не забывайте обновлять его по мере выхода новых версий браузеров.

Посетитель, который закрыл уведомление и не обновился, по умолчанию не увидит плашку снова в течение 30 дней. Вы можете изменить эту логику, вручную указав нужные значения параметров remember и rememberFor.

Браузер не поддерживается сайтом

Если браузер посетителя не поддерживается сайтом, он увидит только уведомление со ссылкой на последнюю версию поддерживаемого браузера. Уведомление полностью блокирует содержимое страниц, так что пользоваться сайтом в неподходящем браузере становится невозможно.

Код уведомления можно получить двумя способами:

Настроить уведомление с помощью конструктора

В конструкторе вы можете выбрать:

Тип уведомления и язык сообщений (параметры exclusive и lang).
Цвет полоски-уведомления (параметр theme). Если сайт доступен только для одного браузера, параметр не используется.
Список версий браузеров, которые вы хотите считать устаревшими (управляются параметром browsers). Предлагаемый Яндексом список отмечен в конструкторе по умолчанию.

Список по умолчанию время от времени обновляется. Если у вас нет специфических требований к версиям браузеров, вы можете автоматически получать самый свежий список устаревших версий. Для этого достаточно удалить параметр browsers из сгенерированного кода.

Полученный код вставьте на каждой странице вашего сайта после открывающего тега <body>. Для всех дополнительных параметров, не указанных в этом коде, скрипт будет использовать значения по умолчанию.

Настроить уведомление самостоятельно

Код подключения и вызова скрипта нужно вставить после открывающего тега <body> на каждой странице вашего сайта.

Подключите скрипт с сервера Яндекса:

<script type="text/javascript" src="https://static.yandex.net/browser-updater/v1/script.js"  charset="utf-8"></script>

Создайте объект уведомления с помощью метода ya.browserUpdater.init() и передайте параметры уведомления в аргументах:

<script>var browserUpdater = new ya.browserUpdater.init(параметры уведомления);</script>

Пример кода для уведомления об устаревшем браузере

<script type="text/javascript" src="https://static.yandex.net/browser-updater/v1/script.js" charset="utf-8"></script>
<script>var browserUpdater = new ya.browserUpdater.init(
 {
    theme: "yellow",
    lang: "ru",
    exclusive: false,
    browsers: {
      chromium: 35,
      iron: 35,
      flock: "Infinity",
      palemoon: 25,
      camino: "Infinity",
      safari: 5.2,
      yandexinternet: "Infinity",
      fx: 31,
      ie: 9,
      opera: 16,
      chrome: 35,
      maxthon: 4.4,
      seamonkey: 2.4
    },
    remember: true,
    rememberFor: 30,
    cookiePrefix: "yaBrowserUpdater",
    classNamePrefix: "ya-browser-updater",
    jsonpCallback: "yaBrowserUpdaterJSONPCallback",
    onStripeShow: null,
    onStripeHide: null
 });
</script>

Параметры уведомления


Параметр	Описание	Возможные значения	Формат
Основные параметры
`exclusive`	Признак того, что сайт доступен только для одного браузера.	`true —` сайт доступен только для одного браузера. `false` — браузер посетителя устарел. Значение по умолчанию — `false`.	boolean
`theme`	Цвет полоски-уведомления. Игнорируется, если вы используете уведомление, что сайт доступен только для одного браузера.	Доступны следующие цвета: `yellow` — желтый; `red` — красный; `blue` — синий; `green` — зеленый; `white` — белый; `black` — черный; `grey` — серый. Значение по умолчанию — `yellow`.	string
`lang`	Язык уведомления.	Доступны следующие языки: `ru` — русский; `tr` —турецкий; `en` — английский. Значение по умолчанию — `ru`.	string
`browsers`	Ограничения для версий браузеров. Чтобы всегда использовать список по умолчанию, который поддерживается Яндексом, не указывайте параметр `browsers` совсем. Для некоторых браузеров все версии считаются устаревшими, если вы не укажете какую-либо старую версию в качестве максимально допустимой. Версиии можно указать для следующих браузеров: `chromium` — Chromium; `iron` — Iron; `flock` — Flock; `palemoon` — Pale Moon; `camino` — Camino; `safari` — Safari; `yandexinternet` — Yandex Internet; `fx` — Firefox; `ie` — Internet Explorer; `opera` — Opera; `chrome` — Google Chrome; `maxthon` — Maxthon; `seamonkey` — SeaMonkey; `yabrowser` — Yandex Browser.	Поддерживаемые значение ключа зависят от значения параметра `exclusive`. exclusive=true Сайт доступен только для одного браузера. Можно выбрать следующие браузеры: `chrome`; `fx`; `ie`; `yabrowser` (по умолчанию). exclusive=false Список идентификаторов браузеров с минимальными поддерживаемыми версиями. Версию можно задать числом или словом `Infinity`, которое означает, что все версии браузера считаются устаревшими.	string или object
Параметр	Описание	Возможные значения	Формат
Дополнительные параметры Учитываются только для уведомления об устаревшем браузере.
`remember`	Признак того, что нужно выставить куку `yaBrowserUpdaterHide`, где записано, что посетитель сайта закрыл полоску-уведомление, и нужно сделать паузу в ее выдаче. Пауза действует в течении срока, заданного параметром `rememberFor`, при условии, что посетитель сайта не почистит куки.	`true` — не показывать уведомление в течение времени, заданного параметром `rememberFor` (по умолчанию — 30 дней. `false` — показывать уведомление при каждой загрузке страницы. Значение по умолчанию — `true`.	boolean
`rememberFor`	Продолжительность паузы в выдаче уведомлений, в днях. Учитывается при отсутствии параметра `remember` или значении`remember=true`.	Значение по умолчанию — 30.	number
`cookiePrefix`	Имя куки, устанавливаемой скриптом. Если вы уже выставляете куку с именем `yaBrowserUpdaterHide`, то имя куки, которую должен выставлять скрипт, нужно задать с помощью этого параметра.	Ваше имя куки.	string
`classNamePrefix`	Префикс в имени CSS-классов, генерируемых скриптом. Если вы уже используете CSS-класс с префиксом `ya-browser-updater`, то префикс, который должен использоваться скриптом, нужно задать с помощью этого параметра.	Ваш префикс имени CSS-классов.	string
`jsonpCallback`	Название глобальной callback-функции JSONP, которая будет вызвана после получения обработанных данных о браузере. Если вы уже используете callback-функцию с именем `yaBrowserUpdaterJSONPCallback` в другом месте, то имя функции, которая должна использоваться скриптом, нужно задать с помощью этого параметра.	Ваше имя callback-функции.	string
`onStripeShow`	Функция, срабатывающая при выдаче полоски-уведомления. С ее помощью можно передать информацию о достижении цели в Метрику или задать верхний отступ на странице, чтобы полоска не перекрывала часть содержимого.	Название функции или сама функция, например: `onStripeShow: function () { alert('show') }` Значение по умолчанию — `null`.	string или function
`onStripeHide`	Функция, срабатывающая при исчезновении полоски-уведомления. С ее помощью можно передать информацию о достижении цели в Метрику или убрать верхний отступ на странице.	Название функции или сама функция, например: `onStripeHide: function() { yaCounterXXXXXX.reachGoal('stripe_hidden'); }` Значение по умолчанию — `null`.	string или function


Параметр	Описание	Возможные значения	Формат
Основные параметры
`exclusive`	Признак того, что сайт доступен только для одного браузера.	`true —` сайт доступен только для одного браузера. `false` — браузер посетителя устарел. Значение по умолчанию — `false`.	boolean
`theme`	Цвет полоски-уведомления. Игнорируется, если вы используете уведомление, что сайт доступен только для одного браузера.	Доступны следующие цвета: `yellow` — желтый; `red` — красный; `blue` — синий; `green` — зеленый; `white` — белый; `black` — черный; `grey` — серый. Значение по умолчанию — `yellow`.	string
`lang`	Язык уведомления.	Доступны следующие языки: `ru` — русский; `tr` —турецкий; `en` — английский. Значение по умолчанию — `ru`.	string
`browsers`	Ограничения для версий браузеров. Чтобы всегда использовать список по умолчанию, который поддерживается Яндексом, не указывайте параметр `browsers` совсем. Для некоторых браузеров все версии считаются устаревшими, если вы не укажете какую-либо старую версию в качестве максимально допустимой. Версиии можно указать для следующих браузеров: `chromium` — Chromium; `iron` — Iron; `flock` — Flock; `palemoon` — Pale Moon; `camino` — Camino; `safari` — Safari; `yandexinternet` — Yandex Internet; `fx` — Firefox; `ie` — Internet Explorer; `opera` — Opera; `chrome` — Google Chrome; `maxthon` — Maxthon; `seamonkey` — SeaMonkey; `yabrowser` — Yandex Browser.	Поддерживаемые значение ключа зависят от значения параметра `exclusive`. exclusive=true Сайт доступен только для одного браузера. Можно выбрать следующие браузеры: `chrome`; `fx`; `ie`; `yabrowser` (по умолчанию). exclusive=false Список идентификаторов браузеров с минимальными поддерживаемыми версиями. Версию можно задать числом или словом `Infinity`, которое означает, что все версии браузера считаются устаревшими.	string или object
Параметр	Описание	Возможные значения	Формат
Дополнительные параметры Учитываются только для уведомления об устаревшем браузере.
`remember`	Признак того, что нужно выставить куку `yaBrowserUpdaterHide`, где записано, что посетитель сайта закрыл полоску-уведомление, и нужно сделать паузу в ее выдаче. Пауза действует в течении срока, заданного параметром `rememberFor`, при условии, что посетитель сайта не почистит куки.	`true` — не показывать уведомление в течение времени, заданного параметром `rememberFor` (по умолчанию — 30 дней. `false` — показывать уведомление при каждой загрузке страницы. Значение по умолчанию — `true`.	boolean
`rememberFor`	Продолжительность паузы в выдаче уведомлений, в днях. Учитывается при отсутствии параметра `remember` или значении`remember=true`.	Значение по умолчанию — 30.	number
`cookiePrefix`	Имя куки, устанавливаемой скриптом. Если вы уже выставляете куку с именем `yaBrowserUpdaterHide`, то имя куки, которую должен выставлять скрипт, нужно задать с помощью этого параметра.	Ваше имя куки.	string
`classNamePrefix`	Префикс в имени CSS-классов, генерируемых скриптом. Если вы уже используете CSS-класс с префиксом `ya-browser-updater`, то префикс, который должен использоваться скриптом, нужно задать с помощью этого параметра.	Ваш префикс имени CSS-классов.	string
`jsonpCallback`	Название глобальной callback-функции JSONP, которая будет вызвана после получения обработанных данных о браузере. Если вы уже используете callback-функцию с именем `yaBrowserUpdaterJSONPCallback` в другом месте, то имя функции, которая должна использоваться скриптом, нужно задать с помощью этого параметра.	Ваше имя callback-функции.	string
`onStripeShow`	Функция, срабатывающая при выдаче полоски-уведомления. С ее помощью можно передать информацию о достижении цели в Метрику или задать верхний отступ на странице, чтобы полоска не перекрывала часть содержимого.	Название функции или сама функция, например: `onStripeShow: function () { alert('show') }` Значение по умолчанию — `null`.	string или function
`onStripeHide`	Функция, срабатывающая при исчезновении полоски-уведомления. С ее помощью можно передать информацию о достижении цели в Метрику или убрать верхний отступ на странице.	Название функции или сама функция, например: `onStripeHide: function() { yaCounterXXXXXX.reachGoal('stripe_hidden'); }` Значение по умолчанию — `null`.	string или function