WordPress插件

从版本2.7开始，Verge3D附带了一个WordPress插件，这是目前最流行的内容管理系统（CMS）（超过6000万次安装）。Verge3D WordPress插件提供两个主要功能：

  • 应用程序托管和发布。
  • 用于处理客户订单的电子商务系统，使用place order拼图提交。
  • 完全可定制的电子商务系统，用于处理由send data拼图以JSON格式提交的订单。
    这些功能相互独立。例如，您可以只使用嵌入，也可以处理从其他地方托管的应用程序（例如Verge3D网络等）接收的订单。

沙盒

要试用插件功能，请查看官方Verge3D for WordPress sandbox。

安装

在安装此插件之前，请确保最低WordPress 4.7版本。要在服务器上传应用程序，您需要拥有一个现代浏览器，例如Google Chrome，Firefox，Edge或Safari 11.1+。 请按照以下步骤安装Verge3D插件：

  • 通过Wordpress管理界面从verge3d / wordpress / verge3d.zip上传插件。
  • 在插件菜单中激活插件。 Verge3D菜单应出现在管理面板中。
    尝试上传部分应用或创建测试订单，以验证插件是否正常工作。请注意，您的WordPress服务器配置可能具有严格的上传限制。如果您在上传应用程序时遇到麻烦，可能需要在php.ini文件中调整以下设置：upload_max_filesize = 100Mmax_file_uploads = 100

添加和管理应用程序

使用Applications管理菜单访问Verge3D Applications屏幕：

WordPress插件 - 图1

要上传您的应用，请单击应用程序标题下的编辑，单击选择文件，然后在更新Verge3D应用程序表单中选择一个应用程序文件夹：

WordPress插件 - 图2

在此表单上，您还可以配置应用程序的iframe（画布）大小，并使用全屏模式允许/拒绝。要在WordPress页面/帖子中嵌入Verge3D应用程序，请使用以下短代码：[verge3d id=”YOUR_APP_ID”]其中YOUR_APP_ID是Verge3D应用程序屏幕上表格中显示的应用程序的ID。

设置订单

要处理Verge3D应用程序发送的订单，请使用以下短代码向您的某些WordPress页面/帖子添加订单：[verge3d_order]在 place order拼图中指定指向该页面/帖子的链接以使其有效。

WordPress插件 - 图3

管理订单

使用电子商务管理菜单访问电子商务订单屏幕：

WordPress插件 - 图4

此列表中的订单是在收到Verge3D应用程序的请求时自动创建的。您可以使用此屏幕查看和管理客户订单。

插件设置

使用“设置”管理菜单修改插件全局设置：

WordPress插件 - 图5

订单通知电子邮件选项用于指定负责管理订单的人员的电子邮件地址。当客户下新订单时，您将在此电子邮件中收到有关此订单的通知。 订购电子邮件“发件人”选项用于指定负责与客户通信的个人/组织的名称/电子邮件。这可以是销售经理的电子邮件，一些常见的地址，例如sales@yourcompany.com，或者只是一个无回复的地址，例如noreply@yourcompany.com。

高级电子商务应用程序

在某些情况下，您可能希望扩展电子商务系统的功能。例如，如果您开发3D配置器或需要客户端的更多信息来正确处理订单，则需要请求添加更多数据以及在服务器上处理此数据。对于这种情况，您需要使用“send data”拼图以JSON格式对数据进行编码，然后为您的电子商务系统创建自定义模板表单。

假设您要创建一个基本的自定义表单。您的数据会是这个样子：

  1. {
  2.     "width": 120,
  3.     "length": 150,
  4.     "height": 100,
  5.     "color": "Redwood",
  6.     "title": "Custom Table",
  7.     "price" 100,
  8.     "user_name", "John Smith",
  9.     "user_email", "john.smith@example.com",
  10.     "user_phone", "+123456789"
  11. }

您可以使用字典拼图构建此结构，然后使用“send data”拼图将其发送到服务器。之后，您需要为订单管理页面创建自定义模板，以及将其发送给您的客户和销售人员的电子邮件。为此，请将以下源模板复制到verge3d子目录下的WP主题目录中：

  1. WORDPRESS/wp-content/plugins/verge3d/templates/order_admin_form.php
  2. WORDPRESS/wp-content/plugins/verge3d/templates/order_email_body.php

WORDPRESS是WordPress安装的根目录。根据为您的订单指定的结构编辑这些文件。

最后一部分是为“send data”拼图分配正确的URL。这个看起来像：

  1. https://HOSTNAME/wp-json/verge3d/v1/place_order/

其中HOSTNAME是WordPress服务器的主机名，例如www.soft8soft.com

电子商务协议规范

Verge3D插件和place order拼图使用简单且可扩展的协议来处理订单。如果您要创建自定义服务器端或前端脚本，可以使用下面提供的信息。使用带有以下参数的HTTP POST请求从浏览器向服务器发送订单：

POST 参数描述
v3d_titleOrder title. This field is used to describe the order. Since this value is of no use to customers, it is of use solely for persons that are responsible for handling orders.
v3d_contentOrder content. This text field includes a complete order information and is visible to both the customer and the sales manager.
v3d_priceOrder total price. It can be a number or a string, for example 99, 99.99, “$99.99”.
v3d_screenshotOrder screenshot. This optional value must be a data URI representing an image. This value is generated by the HTMLCanvasElement.toDataURL() method.

由于此协议是可扩展的，因此您可以将任何带有v3d_前缀的参数添加到POST请求中，或使用JSON，XML，CSV或任何其他格式的数据将数据序列化为v3d_content参数。