Description

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

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

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

主な機能

WooCommerce の購入手続き、カート、マイアカウントの住所フォームに対応します。
WooCommerce Blocks の購入手続き・カート住所フィールド更新に対応します。
郵便番号から都道府県・市区町村・町域の入力を補助します。
通常の住所補完では外部APIを使わず、サイト内の郵便番号DBを検索します。
顧客の住所補完時に、日本郵便や外部APIへ住所情報を送信しません。
管理者が手動で郵便番号DB更新を実行した場合のみ、日本郵便の公式郵便番号CSVデータを取得します。
管理画面を「基本設定」「住所不備チェック」「郵便番号データ」「仕様メモ」のタブ構成に整理しています。
住所不備チェックに対応します。
番地らしき表記が不足している住所を検出できます。
郵便番号DBの町域名だけで住所入力が止まっている可能性を検出できます。
住所不備チェックは、OFF / 警告モード / 停止モードを選択できます。
チェック対象は、請求先住所 / 配送先住所 / 両方から選択できます。
警告文・停止文は管理画面から編集できます。
プラグイン一覧に設定リンクを表示します。
設定画面にプラグインバージョンを表示します。

外部サービス

このプラグインは、管理者が設定画面で郵便番号DB更新を実行した場合のみ、日本郵便の郵便番号CSVデータを取得します。

利用目的

日本郵便の公式郵便番号CSVデータを取得するため。

送信される情報とタイミング

管理者が郵便番号DB更新を手動実行した場合のみ、サーバーから日本郵便へZIPファイル取得リクエストを送信します。
顧客の住所、購入手続き情報、個人情報は、日本郵便へ送信しません。
通常の住所補完時には、日本郵便および外部サービスへ通信しません。

サービス提供元

日本郵便
サービス情報: https://www.post.japanpost.jp/service/search/zipcode/download/utf-zip.html
利用条件: https://www.post.japanpost.jp/
プライバシーポリシー: https://www.post.japanpost.jp/privacy.html

通常の住所補完では、WordPress内に保存されたローカル郵便番号DBを検索します。

動作要件

WordPress 6.0 以上
PHP 7.4 以上
WooCommerce

Installation

WordPress管理画面から「プラグイン」>「新規追加」を開きます。
「WKSS Japan Address Helper」を検索してインストールします。
プラグインを有効化します。
WooCommerce が有効化されていることを確認します。
必要に応じて、管理画面から郵便番号DBを更新してください。
住所不備チェックを使う場合は、設定画面の「住所不備チェック」タブからモードと対象住所を設定してください。

FAQ

通常の住所補完で外部APIを使いますか？: いいえ。通常の住所補完では外部APIを使わず、サイト内の郵便番号DBを検索します。
日本郵便のデータへアクセスするのはいつですか？: 管理者が郵便番号DB更新を実行した場合のみ、日本郵便の公式データを取得します。
顧客の住所情報は日本郵便や外部APIへ送信されますか？: いいえ。顧客の住所補完時には、WordPress内に保存されたローカル郵便番号DBを検索します。
WooCommerce Blocks に対応していますか？: はい。WooCommerce Blocks の購入手続き・カート住所フィールド更新に対応します。
住所不備チェックでは何を確認できますか？: 番地らしき表記が不足している住所や、郵便番号DBの町域名だけで住所入力が止まっている可能性を確認できます。
住所不備チェックは購入を止めますか？: 設定により異なります。OFF、警告モード、停止モードを選択できます。
WooCommerce は必須ですか？: はい。このプラグインは WooCommerce 向けの住所補助プラグインです。

Reviews

There are no reviews for this plugin.

Contributors & Developers

“WKSS Japan Address Helper” is open source software. The following people have contributed to this plugin.

wkss

Translate “WKSS Japan Address Helper” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.8

WordPress.org 公開用に readme の英語要件へ対応しました。
管理画面のタブ化と住所不備チェック機能を含む公開版として整理しました。

1.1.7

Updated version numbering for WordPress.org release workflow.
Adjusted readme metadata for Plugin Check compatibility.

1.1.6

Added tabbed settings screen.
Added address validation settings.
Added warning and blocking modes for incomplete address checks.
Added billing/shipping target selection for address validation.
Added editable warning and blocking messages.

1.1.4

Updated the WordPress.org plugin card short description and main description.
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.