Page Comparison

...

Wizart Web Visualizer представляет собой собой виртуальную примерочную как назависимое веб-приложение, которое внедряется в веб-сайт сайт клиента, и служит для предоставления возможности производить наложение образцов отделочных материалов на фото предразмеченных заранее интерьеров и на фото личных интерьеров пользователейпользователей. Отображает информацию из PIM-системы(см.ниже) либо из базы данных клиента.

Пример приложения без интеграции: https://webdemo2demo.wizart.tech

Пример e-commerce с интеграцией: https://webdemostore.wizart.tech

PIM-система (Product Information Management System)

...

Получение доступа к PIM Admin Tool (генерируется и выдается администратором Wizart) и API Token
Импорт необходимых данных в PIM через PIM Admin Tool (User manual for PIM admin , File upload requirements )
Встраивание приложения Wizart Web в сайт клиента
Тестирование интеграции
Публикация

...

Note
Для корректного отображения Wizart WEB Web Visualizer свойство CSS z-index для тега с id `#wizartwizart-fitting-room-object` должно быть больше чем z-index у всех остальных всплывающих окон на сайте.

Code Block

language	html

<body>

...

<button id="wizart-fitting-room-button" onClick="openFittingRoom()">
  Fitting room
</button>

<object<iframe 
  id="wizart-fitting-room-object" 
  role="dialog" 
  aria-label="Wizart Fitting Room." 
  type="text/html"
  allowfullscreen 
  >
</object>iframe>

<style>
  #wizart-fitting-room-object {
      z-index: 2147483647 !important;
      display: none;
      position: fixed !important;
      top: 0 !important;
      left: 0 !important;
      width: 100%;
      height: 100%;
      background-color: rgba(0, 0, 0, 0.8);
      border: none;
  }
  
  #wizart-fitting-room-object.active {
    display: block;
  }
</style>

<script src="./wizart-integration.js"></script>

</body>

2. Используя следующий листинг ниже, создайте js-файл с именем wizart-integration.js: и загрузите его к существующим исходным файлам клиентского веб-приложения.

Code Block

language	js

// todo get api token from Wizart.
const api_token = 'CLIENT_SPECIFIC_API_TOKEN';
const server_address = 'https://pim-client.wizart.tech';

// bba (back button action) param is used to add back button to wizart component
const fittingRoomEndpoint = server_address
  + '/fitting-room'
  + '?api_token=' + api_token 
  + '&bba=true'
;

function openFittingRoom (searchQuery) {
  const componentEndpoint = searchQuery ? fittingRoomEndpoint + searchQuery : fittingRoomEndpoint;
  
  let fittingRoomObject = document.getElementById('wizart-fitting-room-object');
  const fittingRoomObjectContainer = fittingRoomObject.parentElement;

  fittingRoomObject.setAttribute('datasrc', componentEndpoint);
  // object clonning is necessary as some browsers does not render "object" twice after changing data attribute
  const clonnedFittingRoomObject = fittingRoomObject.cloneNode(true);

  fittingRoomObjectContainer.appendChild(clonnedFittingRoomObject);
  fittingRoomObject.remove();

  clonnedFittingRoomObject.classList.add('active');
  
  // should be added to avoid duplicating scrollbars
  document.getElementsByTagName('html')[0].style.overflow = 'hidden';
}

// bba event - fired when back button is clicked at wizart component
window.addEventListener('message', function (event) {
  if (~event.origin.indexOf(server_address)) {
    // exactly 'close_overlay' as it's sent from wizart component
    if (event.data === 'close_overlay') {
      // return overflow of target page to initial state
      document.getElementsByTagName('html')[0].style.overflow = 'auto';

      document.getElementById('wizart-fitting-room-object').classList.remove('active');
    }
    
    if (event.data && event.data.eventName === 'wizart_shopping_cart') {
      // here you can process the data that comes from the shopping cart after clicking go_to_shop
    }
  }
});

3. (ОПЦИЯ) Для замены логотипа wizart на свой необходимо установить поля logo_path и small_logo_path передав в них ссылку на устанавливаемый логотип. . Корзина покупок.

Пример интеграции корзины покупок указан в листинге выше. Смотри строку 42.

Формат event.data:

Code Block
{ eventName: 'wizart_shopping_cart', payload: [ { article: Article, quantity: number, }, ], }

4. Опциональные параметры:

logo_path – ссылка на ваш логотип. Предпочтительно в формате svg. Логотип должен занимать всю высоту картинки без отступов сверху и снизу

...

.
Формат: logo_path=LINK_TO_YOUR_LOGO
menu_items – дополнительные поля в меню.
Формат: menu_items=JSON.stringify([{ title: string }])
do_not_show_info_about_app – не показывать пункт меню “О приложении“.
Формат: do_not_show_info_about_app=1
original_url – ссылка на страницу. Служит для перенаправления из постов в социальных сетях. По умолчанию wizart.tech.
Формат: original_url=link_to_your_web_site
twitter_mention – mention вашего twitter аккаунта.
Формат: twitter_mention=@your_twitter_mention
facebook_app_id – Идентификатор аккаунта который упоминается в посте facebook при шаринге. Аккаунт по умолчанию - Wizart. Вам необходимо зарегистрировать своё приложение на странице https://developers.facebook.com/ и затем скопировать ID приложения (убедитесь, что вы нажали кнопку активации приложения в Facebook)
back_button_background - фон кнопки Назад.
Формат: back_button_background=#ffffff
back_button_icon_color - цвет иконки внутри кнопки Назад.
Формат: back_button_icon_color=#ffffff
enabled_shopping_cart - Если передано значение 1 функциональность корзины покупок будет активирована. Значение по умолчанию 0.
Формат: enabled_shopping_cart=1
is_shown_shopping_cart_prices - Если передано значение 1 цены в корзине покупок и каталоге будут отображаться. Значение по умолчанию 0.
Формат: is_shown_shopping_cart_prices=1
shopping_cart_button_name - Текст для кнопки перенаправления корзины покупок. По умолчанию “Go to shop“.
Формат: shopping_cart_button_name=your_text_for_shopping_cart_button

Пример интеграции:

Code Block
const fittingRoomEndpoint = server_address + '/fitting-room' + '?api_token=' + api_token + '&bba=true' ;

на этот

Code Block

language	js

const fittingRoomEndpoint = server_address'
  + '&logo_path=LINK_TO_YOUR_LOGO'
  + '&menu_items=' + JSON.stringify([])
  + '&do_not_show_info_about_app=0'
  + '&twitter_mention=@your_twitter_mention'
  + '/fitting-room&original_url=LINK_TO_YOUR_WEB_SITE'
  + '?api_token=' + api_token&facebook_app_id=facebook_app_id'
  + '&back_button_background=#ffffff'
  + '&bba=trueback_button_icon_color=#ffffff'
  + '&logoenabled_shopping_path=LINK_TO_YOUR_LOGOcart=1'
  + '&is_shown_shopping_cart_prices=1'
  + '&smallshopping_cart_logobutton_pathname=LINKyour_text_TOfor_YOURshopping_SMALLcart_LOGObutton'
;

45. Сохраните и перенесите все изменения в рабочее окружении клиентского сайта.

56. Проверьте работоспособность интеграции.

Интеграция считается завершенной.

...

Versions Compared

Old Version 36

New Version Current

Key