Подписаться

Виджеты

Размещаемый на сайте клиента код вставки виджета LiveTex представляет собой небольшое Web-приложение, работающее в контексте страницы сайта.

В большинстве случаев, программный код LiveTex не оказывает какого-либо влияния на работу кода страниц вашего сайта. Однако, такое взаимодействие нельзя исключить полностью, поэтому разработчикам сайта необходимо понимать, что происходит при установке кода.

Системные требования

Компания LiveTex обеспечивает тестирование и гарантирует корректную работу виджета в наиболее популярных браузерах для всех распространенных операционных систем ПК.

Минимальные аппаратные требования к компьютеру посетителя:

    • тактовая частота процессора: не менее 1 ГГц;
    • оперативная память: не менее 256 МБ; *
    • разрешение экрана: не менее 1024×768.

Минимальные системные требования совпадают с требованиями браузера.
* Размер оперативной памяти указан как необходимый после запуска браузера.

Поддерживаемые настольные операционные системы:

  • Microsoft Windows XP SP3, 32 бита;
  • Microsoft Windows 7, 32/64 бита;
  • Microsoft Windows 8, 32/64 бита;
  • Microsoft Windows 8.1, 32/64 бита;
  • Microsoft Windows 10, 32/64 бита; 
  • Apple OS X 10.7 и более поздние;
  • Ubuntu 13.04 и более поздние.

Поддерживаемые браузеры для операционных систем ПК:

  • Google Chrome 28.0 и более поздние;
  • Mozilla Firefox 47.0 и более поздние;
  • Apple Safari 8.0 и более поздние (для OS X);
  • Microsoft Internet Explorer 11.0;
  • Microsoft Edge 13.0 и более поздние;
  • Opera 36.0 и более поздние

Компания LiveTex гарантирует, что в случае обнаружения проблем при работе в указанных средах, служба технической поддержки LiveTex будет рассматривать сообщения о проблемах как инциденты и будет обрабатывать их с максимальным приоритетом в сроки, предписанные действующим соглашением о гарантиях работоспособности и доступности программного обеспечения (SLA).

При возникновении проблем в работе виджета в других средах, компания LiveTex также рассматривает такие обращения, но не предоставляет гарантии по срокам их обработки.

Для мобильных устройств:

Виджет LiveTex также работает и на мобильных устройствах. В настоящее время обеспечивается экспериментальная поддержка функций чата на следующих платформах: 

  • Google Android 5.0 и более поздние:
    Android Browser;
    Google Chrome.
  • Apple iOS 7.0 и более поздние:
    Safari.

* - Статус поддержки «Экспериментальный» означает, что в указанных средах проверяются основные режимы работы виджета, но полное тестирование не обеспечивается.

Особенности работы виджета на страницах сайтов

В данном разделе приводятся подробные разъяснения принципов работы виджета LiveTex, а также технические параметры, в рамках которых компания LiveTex гарантирует работоспособность виджета.

Сетевой трафик

Потребляемый виджетом LiveTex сетевой трафик можно разделить на две составляющие:

  • Начальная загрузка JavaScript, изображений и CSS - не более 300 КБ
    Компания LiveTex стремится минимизировать объем трафика для сокращения времени загрузки виджета. Размер трафика зависит от браузера посетителя и может отличаться от указанного.

    Мы гарантируем, что объем трафика при начальной загрузке не превышает указанную величину для стандартного дизайна виджета (стандартным дизайном считается все вариации внешнего вида виджета, доступные для настройки в Личном кабинете).

    В случае использования виджета с индивидуально разработанным дизайном, размер трафика при начальной загрузке может превышать указанный.
  • Трафик при передаче сообщений между виджетом и серверами LiveTex - не более 256 Кбит/с

    Измерения проводились для среднестатистического сценария переписки посетителя и оператора сайта, среднее количество символов всех сообщений которого составляет 300 символов в минуту. 

Потребление аппаратных ресурсов

  • Время использования процессора в режиме ожидания - не более 10 секунд в минуту.
    Для определения этой величины используется программа Диспетчер задач (ОС Windows). Параметр «Время ЦП» представлен во вкладке «Журнал приложений» в строке, показывающей процесс браузера, например, «Firefox».
    Для замера используется пустая страница, содержащая только код вставки LiveTex.

    Способы измерения:
  1. Открыть браузер. Оставить только одну закладку и открыть в ней пустую страницу с кодом вставки LiveTex. Появление ярлыка у края экрана означает завершение процесса инициализации.
  2. Открыть "Диспетчер задач" (Ctrl-Shift-Esc). Открыть вкладку "Журнал приложений". Найти строку с названием браузера.
  3. Кликнуть по ссылке "Удалить журнал использования" и одновременно засечь время.
  4. По истечении минуты зафиксировать значение "Время ЦП". Значение не должно превышать заявленное в данном разделе.
  • Потребление оперативной памяти не более 16 МБ

    Для определения параметра использовалась панель «Инструменты разработчика» браузера Google Chrome. В браузере была загружена пустая страница, содержащая только код вставки виджета LiveTex. Вне зависимости от режима работы виджета, потребление оперативной памяти не превышает указанного значения.

  • Размер файлов cookies для сайта клиента, сохраняемых на компьютере посетителя, не более 1 КБ

    Виджет LiveTex устанавливает некоторое количество cookie для сайта клиента.
    Общий размер файлов всегда находится в пределах указанного значения.
    Мы стараемся минимизировать количество и размер файлов cookie.

    Индустриальный стандарт на механизм cookie (RFC 6265) рекомендует разработчикам браузеров следующие параметры:

    • как минимум 4096 байт на одну cookie;
    • как минимум 50 cookies на домен;
    • как минимум 3000 cookies в целом.
    http://tools.ietf.org/html/rfc6265
  • Префикс cookie для сайта клиента: «lt-»

    Все файлы cookie, устанавливаемые виджетом для сайта клиента, начинаются с префикса «lt-».
    Если имя cookie, которое устанавливается на сайте клиента, совпадает с cookie LiveTex, то это может привести к ошибкам в работе механизмов сайта, использующих эти cookie, или к ошибкам в работе виджета LiveTex.
    Если вы столкнулись в такими проблемами, обратитесь в службу технической поддержки LiveTex.

  • Размер файлов cookies, сохраняемых для домена сайта livetex.ru, не более 4 КБ

    Cookies для домена livetex.ru никак не влияют на работу сайта клиента, и мы оставляем за собой право использовать эти cookie по своему усмотрению.

Размещение кода вставки в HTML-коде страницы

Код вставки виджета LiveTex должен был размещен непосредственно перед закрывающим тегом </body> страницы сайта. В этом случае гарантируется готовность объектной модели документа (DOM) к моменту начала инициализации виджета LiveTex.

ВНИМАНИЕ! Размещение кода вставки в другом месте документа может привести к тому, что виджет начнет инициализацию до того, как весь документ будет загружен и готов к работе. Это может привести к ошибкам инициализации.

Переменная liveTexID в коде вставки связана с именем хоста. Переменной liveTexID присваивается значение системного идентификатора соответствующего сайта.

В Личном кабинете можно создать несколько точек контакта с типом "Сайт", у каждой из которых будет свой код вставки, отличающийся лишь значением этой переменной.

Посетитель сайта при просмотре страницы с кодом виджета LiveTex маркируется с помощью cookie, устанавливаемой на имя хоста (host name). Этот cookie также закрепляется за идентификатором сайта. 

ВНИМАНИЕ! Коды вставки разных сайтов не могут сосуществовать на одном имени хоста.

Влияние на DOM страницы

Код виджета LiveTex влияет на объектную модель страницы следующим образом:

  • добавляет при инициализации до 2-х контейнеров;
  • в конце документа (перед закрывающим тегом <body>). Один контейнер <div> для ярлыка чата, другой — для ярлыка звонков;
  • наполняет при инициализации необходимым содержимым контейнеры кнопок, размещенных на странице;
  • все контейнеры <div>, с которыми работает код виджета, имеют id с префиксом «liveTexButton_» или «lt_», и именами классов, начинающимися на «lt-»;
  • манипулирует только содержимым этих контейнеров по ходу работы, опираясь при поиске объектов DOM на указанные выше идентификаторы.

Если вы столкнулись с проблемами пересечения имен объектов, обратитесь в службу технической поддержки LiveTex.

Виджет LiveTex работает с любым HTML doctype. Рекомендуем «doctype html».

ВНИМАНИЕ! Мы не поддерживаем режим совместимости IE (quirks mode).

Влияние на JavaScript

JavaScript-код виджета LiveTex в своей работе опирается на следующие принципы:

  • виджет LiveTex оперирует в глобальном пространстве имен следующими переменными: «liveTex», «liveTexID», «livetexSettings», «lt_init», «LiveTex»;
  • для отслеживания событий используется безопасная функция addEventListener();
  • регулярные операции (setTimeout) выполняются не чаще, чем один раз в 200 миллисекунд;
  • код виджета предполагает, что стандартные JavaScript / DOM методы не переопределены. Это могут делать некоторые старые версии библиотек (MooTools). Минимально поддерживаемая версия Mootools — 1.2.5. Любые переопределения такого рода могут привести к потере работоспособности виджета и это не является инцидентом;
  • мы обязуемся никогда не указывать наши обработчики событий в свойствах типа window.onload и т.д. Все обработчики событий указываются исключительно стандартными методами addEventListener и attachEvent;
  • мы оставляем за собой право корректно использовать любые методы DOM современных браузеров;
  • мы не препятствуем распространению события по иерархии объектов DOM 
    http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-flow-bubbling.

Влияние на CSS

Все классы CSS имеют префикс «lt-».
Если вы столкнулись с конфликтом имен классов - обратитесь в службу технической поддержки LiveTex.

Перед обращением в техническую поддержку LiveTex

Обращения в техническую поддержку принимаются в письменном виде на адрес электронной почты support@livetex.ru.

Перед отправкой сообщения, пожалуйста, убедитесь, что проблема действительно находится в зоне ответственности LiveTex.

  1. Аппаратные характеристики, операционная система и браузер устройства на стороне посетителя соответствуют системным требованиям, указанным в этом документе.
  2. Настройки компьютера и браузера не препятствуют обработке JavaScript и не блокируют отображение элементов на страницах сайтов.
  3. На компьютере не используются программные средства, которые могут препятствовать корректной работе кода страницы и/или отображению элементов на странице сайта (включая антивирусные программы, брандмауэры, дополнения браузеров и т.д.).
    Попробуйте воспроизвести ситуацию в другом браузере. Вполне возможно, что проблемы возникают из-за настроек браузера.
  4. Если проблемы возникают с функцией звонков, убедитесь, что у вас установлен и не заблокирован какими-либо средствами Adobe Falsh плагин версии не ниже 9.0. Сделать это можно на странице Adobe: https://get.adobe.com/ru/flashplayer/.
  5. Используется стабильное интернет-соединение и скорость трафика составляет не менее 256 Kbps.
  6. Проблемы возникают только после добавления кода вставки LiveTex на страницу.
  7. Внимательно ознакомьтесь с изложенными выше техническими аспектами работы виджета LiveTex. Возможно, вы столкнулись с конфликтом имен и вам не составит труда просто переименовать какую-либо переменную JavaScript, id элемента или название класса.

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

  1. Если проблемы связаны с отображением элементов на странице, то сделайте скриншот нормально работающей страницы без кода LiveTex, и скриншот страницы с ошибками отображения при наличии кода LiveTex.
  2. По возможности, сохраните текст сообщения об ошибке в панели разработчика браузера (JavaScript Console).
  3. Зафиксируйте название и версию браузера.
    Например: Firefox 24
  4. Зафиксируйте название, версию и разрядность операционной системы.
    Например: Windows 8, 64 бита

Эта информация позволит нам существенно сократить время на анализ причин возникновения проблемы.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии