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

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

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

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

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

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

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