該插件使您的客户可以通過輸入郵政編碼並從給定的選項中選擇地址來完成其賬單/收貨地址。
它利用 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()的郵件正文,以使用過量的電子郵件