Первый вариант интеграции
...
First integration option
Tip |
---|
For successful integration of this button, you need to add several lines of JS-code to the place, where you would like to display the button. The minimum amount of integration code is: |
Code Block | ||
---|---|---|
| ||
<script class="wizart__floating-button" data-token="token" src="https://wizart-files.fra1.cdn.digitaloceanspaces.com/production/integration/floating-button.min.js"></script> |
Плавающая кнопка поддерживает следующие параметрыFloating button maintains the following parameters:
Code Block | ||
---|---|---|
| ||
<script class="wizart__floating-button" data-title="Custom button title" data-token="token" data-vendor_code="" data-article_query="" data-parameters="" data-background="" data-color="" data-image="" data-tooltip-_title="" data-tooltip-_position="" data-tooltip-_disable="" data-glitter-_disable="" data-width="" data-height="" data-border="" data-border_radius="" data-class_name="" data-compact="" data-tutorial="" data-tutorial-delay="" data-on-button-click="" data-element-selector="" data-insert-element-position="" data-iframe-element-selector="" data-insert-iframe-element-position="" src="https://wizart-files.fra1.cdn.digitaloceanspaces.com/production/integration/floating-button.min.js" ></script> |
ПараметрParameter | ОписаниеDescription | ТипType | ||||
---|---|---|---|---|---|---|
классclass | Обязательный параметрRequired parameter. | обязательный required | ||||
src | Ссылка на Link to js-файл с кодом интеграцииfile with integration code. | обязательный | ||||
токен данных | токен api - генерируется и выдается администратором Wizart. | обязательный | ||||
заголовок данных | Текст, который будет работать на кнопке (значение по умолчанию - «в комнате в один клик!»). | по желаниюrequired | ||||
data-token | api token - generated and issued by Wizart Administrator. | required | ||||
data-title | Text to be displayed on the button (the default value is "Try it in your room in one click!"). | optional | ||||
data-vendor_code | Уникальный Unique SKU ID продукта, загруженного в систему Wizart.по желаниюof the product uploaded to Wizart system. | optional | ||||
data-article_query | Обязателен в случае, если программа Required in the case if parameter data-vendor_code недостаточно для поиска товара в системе Wizart. Результат результата быть результатом функции is not enough for product search in the Wizart system. Parameter value should be a result of the function | по желанию | ||||
фон данных | Фон кнопки | по желанию | ||||
цвет данных | Цвет текста кнопки | по желаниюoptional | ||||
data-background | Button background | optional | ||||
data-color | Button text color | optional | ||||
data-tooltip-_disable | Если значение равно «истина», всплывающая подсказка характер не будет. | по желаниюIf the value is “true”, the tooltip will not be displayed. | optional | |||
data-tooltip-_title | Текст, который будет во всплывающей подсказке (значение по умолчанию - «Смотри в его комнате!»). | по желаниюText to be displayed on the tooltip (the default value is "See it in your room!"). | optional | |||
data-tooltip-_position | Положение всплывающей подсказки по направлению к кнопке. Доступные значения: верхнее, правое, нижнее, левое (значение по умолчанию - верхнее). | по желанию | ||||
данные-glitter-disable | Если блеск не будет значение истинно. | по желанию | ||||
ширина данных | Максимальная ширина кнопки | по желанию | ||||
высота данных | Высота кнопки | по желанию | ||||
граница данных | Граница кнопки | по желанию | ||||
data-border-radius | Радиус границы кнопки | по желанию | ||||
данные-изображение | Ссылка на значок, который будет на кнопке. | по желанию | ||||
data-class_name | Класс, который будет установлен для кнопки на странице | по желанию | ||||
компактный | Если значение истинно, кнопка будет в компактном режиме. | по желанию | ||||
данные-учебник | Если значение true, а data-compact - true, кнопка будет анимирована: из компактного в полный режим, а затем обратно в компактный режим. Анимация повторяется только один раз. | по желанию | ||||
данные-учебник-задержка | Период времени до активации анимации. | по желанию | ||||
данные-параметры | Результат результата быть результатом функции | по желанию | ||||
data-onload-callback | Имя функции, которая будет в глобальной области видимости. Функция будет вызываться при загрузке визуализатора. | По желанию | ||||
данные при закрытии обратного вызова | Имя функции, которая будет в глобальной области видимости. Функция будет вызвана после закрытия визуализатора. | По желанию | ||||
селектор-элемент-данных | Селектор CSS для выбора элемента на странице и вставки кнопки в нужное место. | По желанию | ||||
данные-вставка-элемент-позиция | Позиция вставки элемента. Значения: добавить, до, после. значение по умолчанию: добавить. | По желаниюTooltip position towards the button. Available values are top, right, bottom, left (the default value is top) | optional | |||
data-glitter_disable | If the value is true, glitter will not be displayed | optional | ||||
data-width | Max button width | optional | ||||
data-height | Button height | optional | ||||
data-border | Button border | optional | ||||
data-border_radius | Button border-radius | optional | ||||
data-image | Link to the icon that will be displayed on the button. | optional | ||||
data-class_name | Class to be set for the button element on the page | optional | ||||
data-compact | If the value is true, button will be displayed in the compact mode | optional | ||||
data-tutorial | If the value is true and data-compact is true, the button will be animated: from the compact to the full mode and then back to compact mode. Animation repeats only once. | optional | ||||
data-tutorial-delay | Period of time before the animation is activated. | optional | ||||
data-parameters | Parameter value should be a result of the function | optional | ||||
data-onload-callback | The name of the function to be in the global scope. The function will be called when the visualizer is loaded. | Optional | ||||
data-on-close-callback | The name of the function to be in the global scope. The function will be called after the visualizer is closed. | Optional | ||||
data-element-selector | A CSS selector to select an element on the page to insert a button where you want. | Optional | ||||
data-insert-element-position | The insertion position of the element. Values: append, before, after. default value: append. | Optional | ||||
data-iframe-element-selector | Селектор CSS для выбора элемента на странице и вставки примерочной в нужное место. | По желанию | данные-вставка-iframe-элемент-позиция | Позиция вставки элемента. Значения: добавить, до, после. значение по умолчанию: добавить. | По желаниюA CSS selector to select an element on the page to insert the fitting room where you want. | Optional |
data-insert-iframe-element-position | The insertion position of the element. Values: append, before, after. default value: append. | Optional |
Additional parameters for “data-parameters” attribute
...
Two-way shopping cart synchronization:
Когда визуализатор открыт, в window.wizartDK добавляются методы для синхронизации корзины покупок.
...
When the visualizer is open, methods are added to the window.wizartDK to synchronize the shopping cart.
Setting the current state of items in the shopping cart –
setShoppingCartStore
. To transfer the current state of the shopping cart to the visualizer, call the methodCode Block language js const payload = [{vendor_code: 'vendor_code1', quantity: 1 }]; window.wizartDK.setShoppingCartStore(payload);
Метод доступен после открытия визуализатора.
Получение текущего состояния товаров в корзине -
getShoppingCartStore
. Чтобы получить товары в корзине, вызовите методgetShoppingCartStore
с функцией обратного вызова. Функция обратного вызова получит товары из корзины. Метод доступен после открытия визуализатораThe method is available after opening the visualizer.Getting the current state of items in the shopping cart –
getShoppingCartStore
. To get the items in the shopping cart, call thegetShoppingCartStore
method with a callback function. The callback function will receive the items in the shopping cart. The method is available after opening the visualizer.Code Block language js const callback = () => { console.log(payload); // [{vendor_code: 'vendor_code1', quantity: 1}, ...] } window.wizartDK.getShoppingCartStore(callback);
Удаление товара из корзины -
onRemoveShoppingCartItem
. Чтобы получить товары при их удалении, необходимо вызвать методonRemoveShoppingCartItem
с функцией обратного вызова. Метод доступен после открытия визуализатораRemoving an item from the shopping cart –onRemoveShoppingCartItem
. To get the goods when they are removed, you must call theonRemoveShoppingCartItem
method with a callback function. The method is available after opening the visualizer.Code Block language js const callback = () => { console.log(payload); // { vendor_code: 'vendor_code', removeAll: true } } window.wizartDK.onRemoveShoppingCartItem(callback);
Добавление товара в корзину -
onAddShoppigCartItem
. Чтобы добавить товар, вам нужно вызвать функциюonAddShoppigCartItem
с параметром Adding an item to the shopping cart –onAddShoppigCartItem
. To add a product, you need to call theonAddShoppigCartItem
function with a parameter{ vendor_code: 'vendor_code' }
. Метод доступен после открытия визуализатораThe method is available after opening the visualizer.Code Block window.wizartDK.onAddShoppigCartItem({ vendor_code: 'vendor_code' });
...
Second integration option:
Tip |
---|
Чтобы эта кнопка успешно интегрировалась, вам необходимо включить следующую библиотеку в заголовок вашего сайтаTo get this button successfully integrate, you need to include the following library in the header of your website: |
Code Block |
---|
<script type="application/javascript" src="https://wizart-files.fra1.cdn.digitaloceanspaces.com/production/integration/floating-button.min.js"></script> |
Tip |
---|
Чтобы инициализировать кнопку, вам нужно вызвать этот код с помощью токена, элемента и кода поставщика или запроса статьиTo initialize the button, you need to call this code with a token, element and vendor code or article query: |
Code Block |
---|
const floatingButton = new window.WFloatingButton({ token: "your token for wizart", element: "link to the element to insert the entry point button", // example document.getElementById("0000") vendorCode: "vendor code for first apply", articleQuery: Json.stringify({ vendor_code: 'vendor code for first apply', collection_name: '', }), }); |
Info |
---|
Элемент |
Tip |
---|
Чтобы отобразить кнопку, нужно вызвать метод рендерингаTo display the button, you need to call the render method. |
Code Block |
---|
floatingButton.render(); |
В метод рендеринга можно передать следующие параметрыThe following parameters can be passed to the render method:
Code Block |
---|
fontSize, title, tooltipTitle, tooltipPosition, tooltipDisable, glitterDisable, className, borderRadius, parameters, background, color, width, height, border, image, compact, tutorial, tutorialDelay, onloadCallback, onCloseCallback, onButtonClick, iframeElementSelector, insertIframeElementPosition, onAddShoppigCartItem, // the function is called on the event of adding an article to the cart onRemoveShoppingCartItem, // the function is called on the event of deleting an article to the cart |
...
Code Block |
---|
const onAddShoppigCartItem = (payload) => { console.log(payload); // { item: { vendor_code: 'vendor_code' }}; } const onRemoveShoppingCartItem = () => { console.log(payload); // { item: { vendor_code: 'vendor_code', removeAll: true }}; } |
Info |
---|
Метод set можно использовать для установки vendorCode или The set method can be used to set vendorCode or articleQuery. |
Code Block |
---|
floatingButton.set({ vendorCode: '' }); floatingButton.set({ articleQuery: Json.stringify({ vendor_code: '' })}); |
Info |
---|
Метод |
Code Block | ||
---|---|---|
| ||
floatingButton.setShoppingCartStore(payload); // payload format [{vendor_code: 'vendor_code', quantity: 1 }, ...] |