该插件使您的客户可以通过输入邮政编码并从给定的选项中选择地址来完成其账单/收货地址。
它利用 getAddress.io(https://getaddress.io)来使用其 Royal Mail 邮政编码地址文件进行查找。
必须使用 API密钥才能进行集成,并且仅在客户为其国家/地区选择英国(或更具体地说,ISO-3166-2 代码 “ GB”)时,集成才会显示。
可以选择关闭送货地址或帐单地址,并且可以将其配置为在 getAddress.io API 密钥达到使用限制时将电子邮件通知发送到指定地址。
测试中
getAddress.io 提供了几个测试邮政编码,可以输入这些测试邮政编码以测试其是否正常运行,而不影响您的使用限制。这些是:
XX2 00X-返回 “成功” 响应 200 。您的请求成功。
XX4 04X-返回 “未找到” 错误 404 。找不到该邮政编码的地址。
XX4 00X-返回 “错误请求” 错误 400 。您的邮政编码无效。
XX4 01X-返回 “禁止” 错误 401 。您的 api 密钥无效。
XX4 29X-返回 “请求太多” 错误 429 。您发出的请求数超出了允许的限制。
XX5 00X-返回 “服务器错误” 错误 500 。服务器错误,永远不要看到此错误。
有关更多详细信息,请参见 getAddress.io 文档(https://getaddress.io/Documentation)。
要求
WordPress 。已测试至 5.4 版。
WooCommerce 。经过测试的最高版本为 4.2.0,最低版本可能为 3.0.0 。
getAddress.io API 密钥。有许多定价计划。
用法
安装并激活后,您需要转到 WordPress 仪表板中的 WooCommerce-> 设置-> 常规页面。您可以在此处输入 API 密钥并设置其他选项。
筛选参考
对于开发人员,我提供了一些过滤器,可用于自定义插件的某些方面。这些是:
错误讯息
所有这些过滤器都带有一个参数 $ message,该错误消息将显示给用户。
gazchaps-woocommerce-getaddress-io_api_error_400-当提供的邮政编码无效/空时显示
gazchaps-woocommerce-getaddress-io_api_error_401-当设置中提供的 API 密钥无效时显示
gazchaps-woocommerce-getaddress-io_api_error_404-在找不到提供的邮政编码的地址时显示
gazchaps-woocommerce-getaddress-io_api_error_429-当 API 密钥达到使用限制时显示
gazchaps-woocommerce-getaddress-io_api_error_500-在 getAddress.io 发生服务器错误时显示
注意:默认情况下,错误消息是 “客户友好” 的,即它们不会详细说明错误原因!
造型
gazchaps-woocommerce-getaddress-io_billing_selector_row_class-更改将帐单地址选择器置于其上的表单行上的 CSS 类
gazchaps-woocommerce-getaddress-io_shipping_selector_row_class-更改将送货地址选择器置于其上的表格行上的 CSS 类
gazchaps-woocommerce-getaddress-io_clear_additional_fields-默认为 true,设置为’__return_false’ 以停止结帐的 “附加字段” 区域具有清晰的样式
过度使用电子邮件通知
gazchaps-woocommerce-getaddress-io_overusage_email_recipient-更改传递给 wp_mail()的收件人
gazchaps-woocommerce-getaddress-io_overusage_email_subject-更改过度使用电子邮件的传递给 wp_mail()的主题行
gazchaps-woocommerce-getaddress-io_overusage_email_message-更改传递给 wp_mail()的邮件正文,以使用过量的电子邮件