=== WKSS Japan Address Helper ===
Contributors: wkss
Tags: woocommerce, japan, address, postcode, zipcode
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

郵便番号から住所入力を補助します。

== Description ==

郵便番号から住所入力を補助します。

通常の住所補完では外部APIを使わず、サイト内の郵便番号DBを検索します。

管理者が郵便番号DB更新を実行した場合のみ、日本郵便の公式データを取得します。

== Features ==

* Supports WooCommerce checkout, cart, and account address forms.
* Supports WooCommerce Blocks checkout and cart address field updates.
* Imports Japan Post UTF-8 CSV and legacy KEN_ALL.CSV postal code data.
* Performs address lookup from a local WordPress database.
* Does not send customer address lookup data to an external service.
* Adds a settings link to the plugin list.
* Shows the plugin version on the settings screen.

== External services ==

This plugin can download a postal code CSV file from Japan Post only when an administrator clicks the import button in the settings screen.

What the service is used for:

* Downloading official Japanese postal code CSV data.

What data is sent and when:

* The server sends a request to Japan Post to download the ZIP file only when an administrator manually runs the postal database update.
* No customer address, checkout data, or personal information is sent to Japan Post during address lookup.

Service provider:

* Japan Post
* Service information: https://www.post.japanpost.jp/service/search/zipcode/download/utf-zip.html
* Terms: https://www.post.japanpost.jp/
* Privacy policy: https://www.post.japanpost.jp/privacy.html

The plugin does not contact Japan Post or any external service during customer checkout/address entry. Customer address lookup uses the local database stored in WordPress.

== Requirements ==

* WordPress 6.0 or later
* PHP 7.4 or later
* WooCommerce

== Installation ==

1. Upload the plugin files to the /wp-content/plugins/wkss-japan-address-helper/ directory, or install the ZIP file from the WordPress plugin screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Open WooCommerce > WKSS Japan Address Helper.
4. Import the postal code CSV data before using address lookup.

== Frequently Asked Questions ==

= Does this plugin send customer address data to an external service? =

No. Customer address lookup uses the local postal code database stored in WordPress.

= Is WooCommerce required? =

Yes. This plugin is designed for WooCommerce address fields.

= Does this plugin download data from Japan Post? =

Only when an administrator manually clicks the import button in the settings screen.

== Changelog ==

= 1.1.4 =
* Updated the WordPress.org plugin card short description and main description in Japanese.
* Prepared WordPress.org plugin directory icon assets.

= 1.1.3 =
* Reduced Plugin Check errors related to filesystem access, uploaded CSV handling, and prepared SQL checks.
* Removed the explicit time limit call during CSV import.

= 1.1.2 =
* Added explicit nonce verification before admin form processing.
* Reduced Plugin Check warnings for form handling and prepared SQL usage.

= 1.1.1 =
* Added SHA-256 hash comparison for downloaded postal data to skip unchanged ZIP files before extraction and CSV import.

= 1.1.0 =
* Changed postal CSV import to stream line-by-line to reduce memory usage during updates.
* Added a current-data check to skip unnecessary re-imports when the same postal data is already stored.
* Added a force re-import button for manual maintenance.

= 1.0.9 =
* Improved settings screen layout for postal database details.
* Split the lead description into clearer lines.
* Improved source URL display to avoid narrow table label wrapping.
* Rechecked plugin metadata, readme stable tag, and PHP syntax.

= 1.0.8 =
* Updated Japan Post data source discovery to use the current UTF-8 ZIP download page.
* Improved relative ZIP URL resolution.
* Improved postal database update error messages.

= 1.0.7 =
* Updated Japan Post download page handling.
* Added support for CSV or ZIP links discovered from the Japan Post download page.

= 1.0.6 =
* Added Japan Post download page discovery before fallback direct URLs.
* Improved handling of redirects and response headers for postal data downloads.

= 1.0.5 =
* Improved Japan Post CSV ZIP download handling.
* Added fallback download URLs and ZIP validation for postal database updates.
* Added Shift_JIS/CP932 conversion support for legacy KEN_ALL.CSV imports.

= 1.0.4 =
* Renamed the plugin to WKSS Japan Address Helper.
* Updated the plugin slug and text domain to wkss-japan-address-helper.
* Documented the Japan Post external service used for manual postal database updates.
* Updated plugin URLs to CustomBox.
* Improved settings screen wording for local database lookup and manual Japan Post data updates.

= 1.0.3 =
* Removed Plugin URI to avoid matching the Author URI in WordPress.org submission.

= 1.0.2 =
* Improved Plugin Check compatibility.
* Replaced direct file operations with WordPress filesystem methods where possible.
* Reworked postal code database inserts to avoid unsafe interpolated SQL parameters.
* Rewrote readme content in standard English.

= 1.0.1 =
* Improved WordPress.org plugin check compatibility.
* Hardened file handling, database inserts, uploaded CSV handling, and readme language.

= 1.0.0 =
* Raised version to first public release candidate.
* Unified plugin header, readme, author, license, WordPress/PHP requirements, and stable tag for release preparation.

= 0.3.0 =
* Removed AjaxZip3 dependency.
* Rebuilt lookup logic around a local postal code database.
* Added CSV download, manual CSV import, and postal data deletion tools.
* Improved support for classic WooCommerce fields and WooCommerce Blocks fields.

