WordPress插件

Verge3D附带了一个用于WordPress的插件，WordPress是目前使用的最流行的内容管理系统(CMS)（全球安装量超过6000多万）。

Verge3D for WordPress插件提供以下功能：

应用托管和发布（直接通过 iframe 或 WordPress 简码嵌入）。
与WooCommerce系统集成，支持在产品页面中嵌入 Verge3D 应用。支持简单、分组、可变或外部/附属等多种产品类型。
持久文件存储。
用于处理客户订单的通用电子商务系统，使用 place order，place order+ 或 send data 拼图提交数据。
报价单和收据生成器。
PayPal或银行卡支付。
支持可下载的产品。

这些特性可以相互独立地工作。例如，您可能只需要嵌入，或者您可以处理从其他地方托管的Verge3D应用（如Verge3D Network等）接收的命令。

内容

插件沙箱

要尝试插件的功能，请查看 Verge3D for WordPress沙盒。它提供了一个安全的环境，您可以用来测试您的Verge3D应用。

安装

在安装插件之前，请确保您至少安装了 WordPress 5.0 或更新版本。要在服务器上上传应用，您需要有一个现代浏览器，如Google Chrome、Firefox、Edge或Safari。

安装方式很简单：

在您的WordPress管理仪表板的插件设置页面上点击 Add New 。
在WordPress.org的官方存储库中找到Verge3D插件并安装。
激活插件。Verge3D 菜单将显示在管理面板中。

在某些情况下，您可能需要从Verge3D发行版手动安装插件（例如，当您想要尝试Verge3D预览版中提供的新特性时）。为此,请执行以下步骤：

通过WordPress管理界面上传插件压缩包 verge3d/wordpress/verge3d.zip 。
在插件菜单中激活插件。Verge3D 菜单将显示在管理面板中。

激活后，试着上传您的一些应用或创建一个测试命令，以验证插件是否按预期工作。

请注意，您的WordPress服务器配置可能有严格的上传限制。如果您在上传应用时遇到问题，您需要调整php.ini文件中的以下设置： upload_max_filesize = 128M post_max_size = 128M 查看官方 PHP文档有关php.ini配置的更多信息。

上传应用

使用 Applications 管理菜单查看 Verge3D应用 界面：

要上传新应用，请点击 Add New 按钮，输入应用名称，然后点击 Next 。您会看到 Manage Verge3D Application 对话框。点击 Choose Files，选择一个应用程序文件夹，然后点击 Upload ：

在此表单中，您还可以配置应用的iframe（画布）大小，并设置是否允许使用全屏模式。

要在WordPress页面/文章中嵌入Verge3D应用，请使用以下短代码：

[verge3d id="YOUR_APP_ID"]

其中 your_app_id 是 Verge3D Applications 页面中显示的应用ID。

与WooCommerce整合

WooCommerce 是一种流行的电子商务系统，它驱动了互联网中28%以上的在线商店。Verge3D通过此WordPress插件和 e-commerce拼图提供了与 WooCommerce 的无缝集成。

有关信息，请参阅这篇教程文章关于如何使用此功能，或参考以下视频： YouTube / bilibili。

有关使用示例，请查看 Drink Shop 演示（也可在资源商店中找到）。

上传文件

此特性允许用户持久存储在Verge3D应用中创建的内容，例如屏幕截图、上传的纹理和保存的配置等。

要向服务器上传文件，请使用下面的REST API方法：

https://HOSTNAME/wp-json/verge3d/v1/upload_file/

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

成功后，此方法返回以下JSON文件，其中包含上传文件的信息：


      {
          "id": THE_ID_OF_THE_UPLOADED_FILE,
          "link": LINK_TO_THE_UPLOADED_FILE,
          "size": FILE_SIZE
      }

使用请求中提供的链接或使用ID与 get_file REST API方法来检索文件：

https://HOSTNAME/wp-json/verge3d/v1/get_file/ID

使用拼图

使用 send data 和 loaded data 拼图来上传文件。使用 in dict ... get key ... 拼图解析API响应的JSON字段。

在下面的示例中，将用户在“opened file”拼图中指定的文件上载到Soft8Soft沙箱中，然后把web地址保存到 link 变量里：

若要检索/下载文件，请使用 load data 和 loaded data 拼图。

有关使用示例，请查看 Custom Image 演示（也可在资源商店中找到）。

接收基础订单

要处理Verge3D应用中的常规订单（通过place order 或 place order+ 拼图）,在您的WordPress页面/文章中使用以下短代码添加一个订单表单：

[verge3d_order]

然后将指向该页面/应用的链接指定为“place order”拼图的“send to”参数。每次执行此拼图时，您的应用都会将用户重定向到您的订单表单：

有关使用示例，请查看 Ring 演示（也可在资源商店中找到）。

通过 REST API 在后台接收订单

在某些情况下，您可能希望为下订单创建自定义体验，而不是将用户重定向到订单页面。

假设您要创建一个基本的表格定制器。您的数据可能如下所示：


    {
        "user_name": "John Smith",
        "user_email": "john.smith@example.com",
        "user_phone": "+123456789"
        "items": [
            {
                "sku": "table_top_white",
                "quantity": 1
            },
            {
                "sku": "table_leg_brown",
                "quantity": 4
            },
        ]
    }

您可以使用字典拼图组合此结构，然后使用 "send data" 拼图将其发送到服务器。

为此，请为您的 "send data" 拼图指定一个正确的 URL ，类似这样：

https://HOSTNAME/wp-json/verge3d/v2/place_order/

其中 HOSTNAME 是您的 WordPress 服务器的域名名，例如 sandbox.soft8soft.com

管理订单

使用 Orders 管理菜单来访问 E-Commerce Orders 页面：

此列表中的订单会在接收到来自Verge3D应用的请求时自动创建。您可以在此页查看和管理客户订单。

管理产品

使用 Products 管理菜单来访问 E-Commerce Products 页面：

每个产品都包含如下字段：

Title: 人类可读的产品标题，例如“Verge3D for Blender”或“Spinner”。此字段是必填字段。
SKU: 产品库存单位。该值不仅用于商家管理订单，而且主要用于在place order +或send data拼图中引用产品项目。通常，此值用作产品 ID。
Price: 产品价格。可以设置为零。
Download link: 可选的可下载产品链接。

获取产品信息

用户可使用此功能接收存储在服务器上的产品的相关信息。

使用时请执行以下 REST API 方法：

https://HOSTNAME/wp-json/verge3d/v1/get_product_info/SKU

其中 HOSTNAME 是您的 WordPress 服务器的主机名，例如 sandbox.soft8soft.com，SKU 是产品的存货种类。

若执行成功，此方法将会返回包含以下产品信息的文件：


    {
        "status": "ok",
        "title": "Product Title",
        "sku": "SKU",
        "price": "Product price"
        "currency": "Currency symbol, such as $"
    }

使用拼图

使用 load data(加载数据) 和 loaded data(已加载的数据) 拼图来获取有关您的产品的信息：

插件设置

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

General tab

Currency: 用于存储和显示价格的货币类型。
Price decimals: 显示价格的小数位数。
Merchant info: 商家信息：公司/品牌，地址，联系人，标志等。
Order form fields: 订单中应包括的字段。
Order success text: 订单执行成功后显示的文本。
Order failed text: 订单失败时显示的文本。

Mail标签

Order notification e-mail: 在此选项中指定负责管理订单的人员的电子邮件地址。当客户下新订单时，您将在此电子邮件中收到有关此订单的通知。
Order e-mails "From": 在此选项中指定负责与客户通信的个人/组织的名称/电子邮件。这可以是一个销售经理的电子邮件，或一些常见的如 sales@yourcompany.com 与 noreply@yourcompany.com 等专用邮箱地址。
New order notifications: 在此选项中配置新订单通知邮件的收件人，及此类邮件的主题、内容和附件。
Updated order notifications: 在此选项中配置订单更新通知邮件的收件人，及此类电子邮件的主题、内容和附件。
Sales quotes: 在这些选项中配置要发送给客户的报价邮件的主题和内容。
Invoices: 在些选项中配置要发送给客户的账单邮件的主题和内容。

Documents标签

要正确使用此功能，您需要在服务器上安装Chrome/Chromium浏览器。它将在被称为 headless mode 中执行将HTML订单转换为PDF格式的操作。如果您在某个自定义目录中安装了Chrome/Chromium可执行文件,请指定路径；如果时安装在系统默认路径,可将路径字段留空。

请注意，要安装Chrome到系统默认路径，您需要对服务器具有管理员访问权限。如果没有，请下载最新的Chromium版本，将其解包到服务器上的某个用户可访问的目录中，然后在path字段中指定到Chromium可执行文件的路径（例如/home/ubuntu/chrome-linux/chrome）。

PDF Generator: 安装Chrome/Chromium浏览器的路径，用于以执行PDF转换。如果是以系统范围(system-wide)权限安装的，请留空。
Quotes: 报价文档中显示的其他内容，及报价被确认为有效时的时间。
Invoices: 收据文档中显示的其他内容。

Payment标签

Paid status: 订单状态设置为成功付款。例如，如果您正在销售实体商品，您可能希望将订单状态设置为Processing(正在处理)，这意味着您正在处理订单以便发货。如果您正在销售数字商品，您可能希望将状态设置为Completed(已完成)。这种情况下，下载链接将通过电子邮件发送给客户。
PayPal: PayPal付款方式激活检查器和app客户端ID。请在此处了解起使用说明。

Security标签

为了使您的服务器更安全，请始终禁用您不使用的功能。

Enable REST APIs: 这些选项用于启用/禁用插件提供的订单管理、持久文件存储或产品API。
Cross-domain requests: 此处选项用于启用/禁用插件提供的 REST API 的跨域请求（来自不同主机）。
Custom products: 允许接收带有自定义产品价格和/或 SKU 的订单。

遇到问题？

欢迎您随时在论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。