Расширенное руководство по «Вердж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 настроек плагина. |
Остались вопросы?
Задавайте их на нашем форуме!