Плагин электронной коммерции — Софт Эйт Софт
Description: Блоки визуального программирования для реализации 3Д-интернет-магазинов и конфигураторов товаров Ву Коммерц, а также для создания форм заказа.

# Плагин электронной коммерции

Этот встроенный плагин содержит пазлы, которые могут быть использованы для создания различных приложений электронной коммерции. Он поддерживает «Пейпал»-платежи, 3Д-визуализацию товаров и конфигураторов в «Ву Коммерц», а также ряд функций для создания продвинутых форм заказа (с использованием решения для «Вордпресс», также входящего в состав «Вердж3Д»).

## Содержание

- Пазл для PayPal
  - paypal create order
- Пазлы для «Ву Коммерц»
  - connect to WooCommerce
  - product info
  - product attribute
  - product component
- Пазлы для формы заказа «Вордпресс»-плагина
  - place order
  - place order +
  - order item (sku, qty)

#

## Пазл для PayPal

#

### paypal create order

Создать заказ с оплатой через «Пейпал». Этот пазл является наиболее простым способом добавления платежей на ваш сайт, поскольку он не требует использования дополнительных решений на стороне сервера. Всё что вам потребуется — верифицированный бизнес-аккаунт «Пейпал».

На данный момент деятельность «Пейпал» в России и Белоруссии приостановлена. В качестве альтернативы используйте открытую систему «Ву Коммерц», в которой есть возможность осуществления платежей с помощью российских сервисов, таких как «Робокасса».

client ID
  Идентификатор бизнес-аккаунта «Пейпал». Узнайте как получить его на этой странице. Для тестирования «Пейпал» предоставляет аккаунт-песочницу, для осуществления реальных продаж вам потребуется пройти верификацию.
title
  Заголовок продукта.
item price
  Цена продукта.
currency
  Валюта.
quantity
  Количество продукта.
on success do
  Пазлы из этого слота будут выполнены в случае успешной транзакции.
on error do
  Пазлы из этого слота будут выполнены в случае ошибок (недостаточная сумма на карте итд).

#

## Пазлы для «Ву Коммерц»

#

### connect to WooCommerce

Подключиться к системе «Ву Коммерц», и начать получение информации о продукте.

Данная функциональность используется в демо-приложении «Магазин напитков» (исходные файлы доступны в магазине ассетов).

Посмотрите этот урок (англ.) для получения подробной информации.

#

### product info

Возвращает словарь с информацией о продукте, полученной с помощью пазла connect to WooCommerce.

Этот словарь содержит следующие поля:

price
  Цена для выбранного клиентом варианта продукта, например, 12.
quantity
  Количество выбранных клиентом товарных позиций, например, 2.
sku
  Складская единица (артикул) выбранного клиентом варианта продукта.
name
  Название товара, которое будет отображаться в корзине, например, «Спиннер - желтый, большой».
attributes
  Словарь с парами имен/значений атрибутов для выбранного клиентом варианта продукта, например {цвет: "Желтый", размер: "Большой"}.
weight
  Физический вес продукта для выбранного клиентом варианта продукта.
length, width, height
  Физические размеры продукта (длина, ширина, высота) для выбранного клиентом варианта продукта.
type
  Тип товара, указанный в панели администратора «Ву Коммерц», один из следующих: "variable", "simple", "group", "external" или "composite".
children
  Доступно только для «групповых» ("group") продуктов. Включает информацию по каждому субпродукту.
components
  Доступно только для композитных ("composite") продуктов. Возвращает список с информацией по каждому компоненту. Используйте пазл product component чтобы получить эту информацию.
status
  Ответ сервера: "ok" или "error".

#

### product attribute

Возвращает значение атрибута для выбранного клиентом варианта товара, например, "Желтый" для атрибута "цвет". Если указанный атрибут не существует, пазл возвращает `""` (пустую строку).

Наиболее часто данный пазл используется для получения выбранной вариации продукта типа "variable". Имя атрибута не зависит от регистра символов, например "Color", "color" и "COLOR" представляют один и тот же атрибут.

Смотрите этот урок (англ.) чтобы узнать больше об использовании данного пазла.

#

### product component

Возвращает значение из компонента, предоставляемого расширением WooCommerce Composite Products.

Для удобства, вы можете подать имя компонента (заголовок) (напр. "Drawer Top") или его идентификатор (напри. "1685435951") в качестве первого параметра пазла.

Вы можете получить следующие свойства компонента:

product name
  Имя продукта в выбранном компоненте. Равно `""` (пустой строке) если ничего не выбрано.
sku
  Артикул продукта в выбранном компоненте. Равен `""` (пустой строке) если ничего не выбрано, либо если артикул продукта не назначен.
quantity
  Количество выбранных товарных позиций.
type
  Тип продукта: "simple", "variable" или "none" если продукт не выбран.
weight
  Вес продукта. Равен 0 (нулю) если вес продукта не назначен.
width
  Ширина продукта. Равна 0 (нулю) если ширина продукта не назначена.
height
  Высота продукта. Равна 0 (нулю) если высота продукта не назначена.
length
  Длина продукта. Равна 0 (нулю) если длина продукта не назначена.
attributes
  Словарь с атрибутами, назначенными для выбраного продукта. Наиболее часто данный пазл используется для получения атрибутов выбранной вариации продукта типа "variable".
component title
  Имя компонента (заголовок), напр. "Drawer Top". Не следует путать его с именем продута!
component id
  Идентификатор компонента, напр. "1685435951".

#

## Пазлы для формы заказа «Вордпресс»-плагина

#

### place order

Составляет и отправляет форму заказа товара на указанный УРЛ. По умолчанию форма заказа отправляется в песочницу «Вордпресс».

Данная функциональность используется в демо-приложении «Кольцо» (исходные файлы доступны в магазине ассетов).

«Вердж3Д» поставляется с бесплатным плагином «Вордпресс», который способен обрабатывать запросы, отправленные этим пазлом. При получении такого запроса плагин «Вордпресс» отображает страницу с формой, дополненной полями контактов и комментариев, а также скриншотом товара (при необходимости). Заполненная форма отправляется клиентом, а в админ-интерфейсе «Вордпресс» создается новый заказ.

send to
  Ссылка на форму заказа (УРЛ) предоставляемая «Вордпресс»-плагином. За подробной информацией о конфигурации «Вордпресс»-сервера обратитесь к этому разделу.
content
  Содержимое закала.
item price
  Цена единицы товара.
quantity
  Количество товара.
make screenshot
  Сделать скриншот перед отправкой заказа. Обязательно включите скриншоты в пазле configure application, иначе скриншот может отображаться черным цветом.

Учтите, что проверка корректности и цены заказа ложится на ваши плечи (или менеджера по продажам). И хотя это маловероятно, хакер может попытаться изменить содержимое заказа на своей стороне и попытаться купить товар за меньшую цену. Чтобы этого не происходило, требуется автоматизированная верификация заказов на сервере, которая предусмотрена в пазле place order +.

#

### place order +

Составляет и отправляет форму заказа товара на указанный УРЛ. Этот пазл работает аналогично пазлу place order, но имеет расширенный функционал и более безопасен в использовании.

Данная функциональность используется в демо-приложении «Магазин кресел» (исходные файлы доступны в магазине ассетов).

send to
  Ссылка на форму заказа (УРЛ) предоставляемая «Вордпресс»-плагином. За подробной информацией о конфигурации «Вордпресс»-сервера обратитесь к этому разделу.
item(s)
  Товар или список товаров. Читайте ниже чтобы узнать больше.
attachment(s)
  Вложение к товару или список вложение. Вложение это ссылка вида Data URL которая содержит скриншот, изображение, звук, видео, ПДФ, текст или модель в формате glTF.

Пример использования:

#

### order item (sku, qty)

Структура товара используемая в пазле place order +.

sku
  Артикул товара, зарегистрированного в «Вордпресс»-плагине. Читайте о добавлении новых артикулов здесь.
quantity
  Количество товара.

## Проблемы с пазлами?

Обратитесь за помощью на наш форум!