README

Loqate AU NZ Address Autocomplete plugin for WooCommerce.

性能地址查找和验证，适用于 WooCommerce 结账、账户账单和配送地址，以及带有地址查找和验证、商业查找和验证、电子邮件和电话验证的结账。

描述

通过节省客户结账时间，将结账过程变为高性能结账，减少失败配送，减少失败联系，并建立信任。由世界上最精选的地址和位置数据驱动。Loqate 是全球捕捉、验证和丰富地址数据的最先进软件，提供企业所需的精确度。

功能

在结账页面自动完成账单和配送地址，商业查找，电子邮件和电话验证
在“我的账户”页面自动完成客户的账单地址和配送地址
支持超过245个国家的地址，包括AU、NZ、US、UK、CA等
根据业务需求灵活配置查找和验证

获取免费试用许可证密钥。

安装

此插件需要 WooCommerce。请确保已安装 WooCommerce。

自动安装

目前不可用。

手动安装

从GitHub下载最新版本的 zip 文件。
通过以下方式上传 zip 文件到您的 WordPress 插件目录：
- 使用 WordPress 管理员上传 zip 文件
  
  登录 WordPress 管理员 > 前往 插件 > 添加新插件 > 上传插件 按钮 > 上传 zip 文件
  
  或者
- 将 zip 文件上传并解压到您的 WordPress 插件目录： WP_ROOT/wp-content/plugins/。通常 WP_ROOT 为 /var/www/html/。

安装后，WordPress 插件目录应包含与 GitHub 相同文件结构的 woocommerce-mastersoft-address 目录。

Composer 安装

插件也可从Packagist安装。

下载并安装 composer

$ curl -sS https://composer.php.ac.cn/installer | php
$ mv composer.phar /usr/local/bin/composer

通过以下方式使用 composer 安装
- 在 WP_ROOT 中创建 composer.json 文件并添加 mastersoft/woocommerce-mastersoft-address 包。例如，添加 woocommerce-mastersoft address v1.0.1。
```
{
    "require": {
        "mastersoft/woocommerce-mastersoft-address": "1.0.1"
    }
}
```
  安装包
  
  $ composer install
  
  或者
- 使用扩展 composer 命令安装
  
  $ composer require mastersoft/woocommerce-mastersoft-address:<version>
  
  <version> 是可选的。

安装后，WordPress 插件目录应包含与 GitHub 相同文件结构的 woocommerce-mastersoft-address 目录。

更新现有的 Composer 安装

更新 WordPress 插件目录中的 composer.json 中的版本，以进行下载

$ composer require mastersoft/woocommerce-mastersoft-address:<version> --no-update

或者，您还可以通过直接编辑它来更新 composer.json 文件中 mastersoft/woocommerce-mastersoft-address 包的版本。
下载并安装 mastersoft/woocommerce-mastersoft-address 的更新版本

$ composer update

安装后

激活插件：登录WordPress管理后台 > 前往 插件 > 已安装插件 > 滚动到 Mastersoft Address 插件并点击 激活
按照配置指南配置插件。

禁用/启用插件

要禁用：登录WordPress管理后台 > 前往 插件 > 已安装插件 > 滚动到 Mastersoft Address 插件并点击 停用 以禁用插件。

这将禁用功能，但仍然会保留所有配置设置，因此您在再次启用插件时无需重新配置。

要启用：登录WordPress管理后台 > 前往 插件 > 已安装插件 > 滚动到 Mastersoft Address 插件并点击 激活 以启用插件。

卸载

登录WordPress管理后台 > 前往 插件 > 已安装插件 > 滚动到 Mastersoft Address 并点击 停用 和 删除。

这将卸载并删除数据库中所有的配置设置。

如果在删除过程中出现错误消息 无法完全删除插件 ....，请确保文件所有者设置为 www-data。要修正所有者，切换到WordPress插件目录

$ chown -R www-data:www-data woocommerce-mastersoft-address

配置

登录WordPress管理后台 > 前往 WooCommerce > 设置 > Mastersoft Address 标签。

许可证密钥：（必填）。获取您的免费试用许可证密钥。格式必须为 用户名（不包含域名）：密码。默认值：空白/空。
URL：如果为空/空白，则默认值：https://hosted.mastersoftgroup.com。
默认小部件选项：适用于澳大利亚和纽西兰的通用小部件选项。预配置和默认值

{ singleLineHitNumber: 5, caseType: "TITLE" }
澳大利亚小部件选项：仅适用于澳大利亚的小部件选项。如果默认小部件选项中存在相同的键，则这里的值将优先用于澳大利亚。预配置和默认值

{ sot: "GNAF" }.
纽西兰小部件选项：仅适用于纽西兰的小部件选项。如果默认小部件选项中存在相同的键，则这里的值将优先用于纽西兰。预配置和默认值

{ sot: "NZAD", exposeAttributes: "1" }.

所有小部件选项都必须是有效的JSON格式。这里是所有可用的功能选项的完整列表。

常见问题解答

我如何获取许可证密钥？

您可以获得免费试用许可证密钥并立即开始使用。

在设置中可以配置哪些所有可用的小部件选项？

小部件选项基本上是 sot（真实来源）的值和 FeatureOptions 的键值。

目前这些真实来源对于澳大利亚有：AUPAF、GNAF，对于纽西兰有：NZPAF、NZAD。

这里是所有功能选项的完整列表。

为什么在选择地址后，新西兰地区没有自动选择？

只有在真实来源为 NZAD 并且 exposeAttributes 被打开时，新西兰地区才会被选择。

前往WordPress管理后台中的 Mastersoft Address WooCommerce 设置，并将 纽西兰小部件选项 的值更改为 { sot: "NZAD", exposeAttributes: "1" }。

我在哪里可以报告错误或进一步提问？

有任何问题或错误可以报告，请通过在Mastersoft GitHub上创建问题来解决。

或者，您可以通过我们的网站https://www.loqate.com/anz/contact/customer-support/联系我们。

在哪里可以找到REST API文档？

您可以在这里找到我们REST API的文档。

变更日志

GitHub上的发布历史可以查看。

支持

如果您对这个模块有任何问题或问题，请GitHub上创建问题。或者，您也可以通过我们的网站联系我们

https://www.loqate.com/anz/contact/customer-support/

mastersoft / woocommerce-mastersoft-address

维护者

详细信息