Настройки позиции веб-виджета Zendesk не работают в неклассическом режиме.

Вопрос или проблема

zE('webWidget', 'updateSettings', {
        webWidget: {
          color: {
            theme: '#0a0713',
            launcherText: '#ffffff',
          },
          position: {horizontal: 'left'},
        },
      });

Ответ или решение

Вопрос о настройках позиционирования веб-виджета Zendesk SDK актуален для многих разработчиков, которые переходят от Classic Web Widget к более современному инструменту. Давайте рассмотрим, как работает позиционирование в SDK и какие нюансы стоит учесть.

Проблема с позиционированием в Zendesk Web Widget SDK

Как вы уже отметили, попытка задать позицию виджета через настройки, применимые к Classic Web Widget, не работает в новом SDK. Например, следующий код:

zE('webWidget', 'updateSettings', {
    webWidget: {
        color: {
            theme: '#0a0713',
            launcherText: '#ffffff',
        },
        position: {horizontal: 'left'}, // Эта настройка не срабатывает в SDK
    },
});

Причины неработоспособности

1. Изменения в архитектуре SDK: Новое SDK имеет иную архитектуру и набор функций, поэтому некоторые параметры, которые работали в классической версии, могут отсутствовать или подразумевать другое применение.

2. Ограниченная документация: Как вы отметили, документация может быть не обновлена или не давать полную информацию о новых функциях SDK. Это создает трудности для разработчиков, пытающихся адаптировать уже известные им решения.

Позиционирование в Web Widget SDK

В текущей вариации Web Widget SDK возможности настройки позиции ограничены. Вы не сможете напрямую изменить горизонтальное или вертикальное положение виджета с помощью простых параметров position, как это делалось ранее. Вместо этого можно использовать следующие подходы:

1. CSS-стилизация: Вы можете изменить стили виджета с помощью CSS. Например, можно использовать position: fixed или position: absolute для изменения местоположения контейнера виджета на странице.

   Пример:

   #zEwidget { /* Замените на правильный селектор вашего виджета */
       position: fixed; 
       bottom: 50px; 
       left: 20px; 
   }

2. Скрипт для настройки позиции (JavaScript): Вы также можете использовать JavaScript после загрузки виджета, чтобы изменить его позицию.

   Пример:

   window.onload = function() {
       var widget = document.querySelector('#zEwidget'); // Замените
       if (widget) {
           widget.style.position = 'fixed';
           widget.style.left = '20px';
           widget.style.bottom = '50px';
       }
   };

Рекомендации

1. Проверяйте обновления документации: Следите за обновлениями на официальных страницах документации Zendesk, чтобы быть в курсе изменений и новых функций.

2. Обратная связь с поддержкой: Рекомендуется обратиться в службу поддержки Zendesk для получения разъяснений по конкретным аспектам работы виджета SDK и задать вопросы, касающиеся настройки параметров, которые вас интересуют.

3. Обсуждения и сообщества: Принимайте участие в форумах разработчиков Zendesk, где можно задавать вопросы и получать советы от других пользователей и профессионалов.

В результате, хотя возможность прямого позиционирования в Web Widget SDK ограничена, существуют альтернативные способы решения этой проблемы. Надеюсь, указанная информация поможет вам разобраться и адаптировать виджет в соответствии с вашими требованиями.