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

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

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

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

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

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

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