FAIR

Federated and Independent Repositories

WKSS Japan Address Helper

Plugin Banner

WKSS Japan Address Helper

by wkss

Download
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
  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.
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.

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.
Back to top