=== LW Postcode Autofill for WooCommerce ===
Contributors: lindalove70
Tags: woocommerce, checkout, postcode, taiwan, address
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce 結帳地址小幫手，輸入 3 碼郵遞區號後自動帶入縣市與鄉鎮市區，秒填地址讓結帳更便捷。

== Description ==

想無痛提升轉換率？讓結帳一氣呵成就可以！LW Postcode Autofill for WooCommerce 是專為台灣 WooCommerce 商店設計的結帳小幫手。結帳時僅輸入 3 碼郵遞區號，系統自動帶入縣市與鄉鎮市區，更直覺且大幅降低人工輸入錯誤。

現在支援台灣、香港、澳門、馬來西亞、新加坡，不支援的國家或地區會維持 WooCommerce 原生地址流程，不強制套用台灣地址格式。

此版本主要支援 WooCommerce Classic Checkout，保留原本的結帳、付款與訂單流程。

LW Postcode Autofill for WooCommerce 不會修改 WooCommerce 付款流程，不會改變 Apple Pay、LINE Pay 或信用卡付款生命週期，也不會修改訂單狀態流程，並保留 WooCommerce HPOS 相容性宣告。

若 WooCommerce 未啟用，或系統無法確認目前結帳頁類型，外掛會採取保守處理，避免載入不適合的結帳欄位邏輯。

主要行為：

* 台灣顧客可輸入 3 碼郵遞區號，自動帶入縣市與鄉鎮市區。
* 新加坡與馬來西亞保留對應郵遞區號長度的檢查。
* 不支援的國家或地區會維持 WooCommerce 原生地址欄位。
* 超商取貨地址需求維持獨立，不介入超商取貨外掛的流程。
* 付款頁、授權、付款失敗與付款成功流程仍由原本的 WooCommerce 金流外掛負責。

== Features ==

* 台灣 3 碼郵遞區號自動帶入縣市與鄉鎮市區。
* 支援 WooCommerce Classic Checkout。
* 手機版結帳欄位操作友善。
* Safari 與 Chrome 瀏覽器相容。
* 不支援國家維持 WooCommerce 原生地址流程。
* 保留 WooCommerce HPOS 相容性宣告。
* 提供設定頁，可啟用或停用自動帶地址功能。
* 不改動金流生命週期。

== Installation ==

1. 在 WordPress 後台前往「外掛」>「安裝外掛」。
2. 從 WordPress.org 安裝外掛，或上傳 LoveWoo 提供的外掛 ZIP。
3. 啟用外掛。
4. 在 WordPress 左側選單開啟「自動帶地址」設定頁。
5. 確認自動帶地址功能已啟用。
6. 前往結帳頁，輸入台灣 3 碼郵遞區號測試自動帶入流程。

== Frequently Asked Questions ==

= 支援哪些國家或地區？ =

目前支援台灣、香港、澳門、新加坡與馬來西亞。

= 不支援的國家會如何處理？ =

不支援的國家或地區會維持 WooCommerce 原生地址流程。外掛不會強制海外顧客套用台灣地址格式。

= 這個外掛會修改 WooCommerce 付款流程嗎？ =

不會。這個外掛只處理郵遞區號與地址欄位輔助，不修改付款流程、訂單狀態生命週期或金流回呼。

= 會影響 Apple Pay、LINE Pay 或信用卡付款嗎？ =

不會。外掛不改變 Apple Pay、LINE Pay 或信用卡付款生命週期，結帳付款流程仍由啟用中的 WooCommerce 金流外掛負責。

= 支援 HPOS 嗎？ =

支援。外掛宣告相容 WooCommerce High-Performance Order Storage（HPOS），且不直接處理訂單生命週期或操作 WooCommerce 訂單儲存。

= 會影響超商取貨外掛嗎？ =

不會。超商取貨地址需求維持獨立，門市資訊與取貨流程仍由原本的超商取貨外掛負責；本外掛只處理支援結帳流程中的郵遞區號與地址欄位輔助。

== Screenshots ==

1. 輸入 3 碼郵遞區號並自動顯示縣市、鄉鎮市區的動態示範。

== Changelog ==

= 1.1.2 =
* 初始公開版本。
* 新增台灣、香港、澳門、新加坡與馬來西亞的郵遞區號輔助結帳欄位。
* 協助降低 WooCommerce Classic Checkout 地址填寫阻力。
* 不支援國家維持 WooCommerce 原生地址流程。
* 不修改付款流程、Apple Pay 或訂單狀態生命週期。
