Расширенное руководство по «Вердж3Д»-плагину к «ВордПресс»

Этот раздел содержит руководство по работе и кастомизации «ВордПресс» плагина «Вердж3Д» с использованием языка программирования «ЯваСкрипт» а также спецификацию на протокол, используемый в этом плагине.

Содержание

Настройка форм электронной коммерции

Для изменения форм e-commerce скопируйте шаблоны форм, расположенные в каталоге templates плагина «Вердж3Д», в каталог вашей темы «ВордПресс», в подкаталог verge3d.

Например, если вам нужно изменить шаблон электронной почты заказа:

WORDPRESS/wp-content/plugins/verge3d/templates/order_email_body.php → THEME/verge3d

Где WORDPRESS — это корневой каталог вашей установки «ВордПресс», а THEME - каталог вашей текущей темы.

Вот список шаблонов, которые вы можете настроить:

Файл шаблона Описание
order_admin_form.php Форма управления заказами на панели администратора «ВордПресс».
order_email_body.php Шаблон тела письма с заказом. Этот шаблон используется как для уведомлений о заказах, отправляемых вам, так и вашим клиентам.
order_email_pdf.php Шаблон с PDF-вложением к электронному письму с заказом. Этот шаблон используется для создания HTML-файлов, которые будут преобразованы в PDF и прикреплены к электронным письмам с заказами.
order_form.php Шаблон формы заказа. Эта форма отображается для ваших клиентов на страницах, где присутствует код [verge3d_order].
order_success.php Сообщение, отображаемое при принятии заказа.
order_failed.php Сообщение, отображаемое при отклонении заказа.

Меры безопасности

При использовании пользовательских форм в приложениях e-commerce не забудьте правильно экранировать выходные данные, отправляемые клиентами. Для получения дополнительной информации воспользуйтесь следующим руководством.

Спецификация на протокол электронной коммерции

Пазлы place order и place order + используют следующий протокол для обработки заказов. Заказы отправляются из браузера на сервер с помощью HTTP POST-запросов со следующими параметрами:

POST-параметр Описание
v3d_items Пункты заказа. Массив со структурами, закодированный в формате «Джейсон»
v3d_attachments[] Опциональные вложения заказа. Массив ссылок «Дата УРИ».

Пункт заказа имеет конфигурацию, зависящую от используемого пазла. Для place order она имеет вид:

Поле Описание
title Название пункта заказа.
price Цена пункта заказа.
quantity Количество товара в пункте: число, вес, длина, и т.д.

Для пазла place order +:

Поле Описание
sku Артикул товара. Этот артикул используется как идентификатор чтобы получить информацию о продукте с сервера.
quantity Количество товара в пункте: число, вес, длина, и т.д.

Более продвинутый протокол на основе «Джейсон» использует следующий набор параметров по умолчанию:

Поле «Джейсон» Описание
user_name Полное имя клиента (также используется как имя владельца карты).
user_email Электронная почта клиента.
user_phone Телефон клиента.
user_comment Комментарии к заказу.
items Массив с пунктами заказа.
attachments Вложения. Опциональный массив со ссылками «Дата УРИ», содержащими вложения заказа.
user_address1 Первая строка адреса владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
user_address2 Вторая строка адреса владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
user_city Город владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
user_state Регион владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
user_country Страна владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
user_postcode Почтовый индекс владельца карты. Чтобы использовать это поле, активируйте опцию Billing address на вкладке General настроек плагина.
shipping_address1 Первая строка адреса доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.
shipping_address2 Вторая строка адреса доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.
shipping_city Город доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.
shipping_state Регион доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.
shipping_country Страна доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.
shipping_postcode Индекс доставки. Чтобы использовать это поле, активируйте опцию Shipping address на вкладке General настроек плагина.

Остались вопросы?

Задавайте их на нашем форуме!