WKSS Japan Address Helper -- WordPress 插件

开发者	wkss
更新时间	2026年9月25日 10:25
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPL v2 or later
版权网址:	版权信息

WKSS Japan Address Helper は、日本の WooCommerce ストア向けに、郵便番号から住所入力を補助するプラグインです。通常のお客様による住所検索では、AjaxZip3 や外部の住所検索 API を使用しません。WordPress 内に保存されたローカル郵便番号データベースを検索します。日本郵便へ接続するのは、管理者が設定画面から郵便番号データベースの更新を手動実行した場合だけです。主な機能

WooCommerce の購入手続き、カート、マイアカウントの住所フォームに対応します。
WooCommerce Blocks の購入手続き・カート住所フィールド更新に対応します。
郵便番号から都道府県・市区町村・町域の入力を補助します。
通常の住所検索にはローカル郵便番号データベースを使用します。
購入手続きや住所入力時に、お客様の住所検索情報を日本郵便や外部サービスへ送信しません。
管理者が郵便番号データベース更新を手動実行した場合だけ、日本郵便の公式郵便番号 CSV を取得します。
基本設定、住所不備チェック、郵便番号データ、仕様メモをタブ形式の設定画面で管理できます。
郵便番号との整合性や番地情報に問題がある可能性を検出し、警告または購入停止を行えます。
ローカル郵便番号データベースを使って、郵便番号と都道府県・市区町村の一致を確認します。
クラシック購入手続きと Checkout Block／Store API 注文の両方でサーバー側検証を行います。
住所不備チェックの対象を請求先、配送先、または両方から選択できます。
警告メッセージと停止メッセージを設定画面から編集できます。
プラグイン一覧に設定リンクを追加します。
設定画面にプラグインのバージョンを表示します。

WordPress のプラグイン画面からインストールするか、プラグイン ZIP をアップロードします。
WordPress のプラグイン画面で有効化します。
WooCommerce が有効であることを確認します。
WKSS Japan Address Helper の設定画面を開きます。
必要に応じて郵便番号データベースを更新します。
住所情報が不完全な可能性を警告または購入停止したい場合は、住所不備チェックを設定します。

1.1.21

Checkout Blocks の検証例外メッセージを、例外オブジェクトへ渡す前にエスケープしました。
プラグイン所有の郵便番号テーブルに限定した直接 DB クエリの例外理由を明記し、Plugin Check が意図したローカルデータ操作を判別できるようにしました。
管理画面、設定、データベース構造、住所検索、クラシック／Blocks 検証、利用者が入力した住所の保護動作は変更していません。

1.1.20

WJAH 管理画面を WKSS／WEM 共通レイアウトと情報構造に合わせて最終調整しました。
公式 WJAH アイコン、意味を持つステータスカード、アクセシブルなタブ、レスポンシブな余白、高影響な郵便番号データ削除領域を採用しました。
既存タブを維持し、プラグイン依存を追加しない情報表示専用の WKSS 連携タブを追加しました。
バックアップ、復元、リセット、郵便番号データ取り込み進捗などの処理機能は追加していません。
設定、オプションキー、DB 構造、フック、取り込み、検証、住所処理は v1.1.14 の機能基準から変更していません。

1.1.18

WEM 固有の緑色アクセントを、WJAH 固有の落ち着いた郵便ポスト赤へ変更しました。
WEM 共通レイアウト構造、公式 WJAH アイコン、既存設定・機能ロジックは維持しました。

1.1.17

管理画面を現行 WEM レイアウトへ統一し、識別領域、2×2 ステータスカード、共通ヘッダー、メニュー案内、タブ、余白を調整しました。
ヘッダーカードと重複していたタブ下の状態表示を削除しました。
公式 WJAH アイコン、既存設定、フック、DB 構造、検証、取り込み、住所処理は変更していません。

1.1.16

仮の文字バッジを、承認済み WKSS アイコンパッケージの公式 WJAH アイコンへ変更しました。
既存設定、フック、DB 構造、検証、取り込み、住所処理は変更していません。

1.1.15

管理画面を現行 WKSS／WEM の表示・情報構造へ統一しました。
WKSS スイートアイコン、状態ラベル、要約表示、アクセシブルな現在タブ表示を追加しました。
処理内容を変更せず、郵便番号データ削除を高影響操作として視覚的に分離しました。
情報表示専用の WKSS 連携タブを追加しました。プラグイン依存や連携ロジックは追加していません。
既存の設定フォームへ保存中表示を追加しました。
既存設定、オプションキー、DB 構造、フック、検証、取り込み、住所処理は変更していません。

1.1.14

WooCommerce Blocks の再描画後も安全な置換状態を保つため、WJAH が補完した町域を請求先・配送先ごとにページ内で追跡するようにしました。
現在値が WJAH 管理値と完全一致する場合だけ、以前の自動補完町域を置換します。利用者が入力した番地などは変更しません。
現在の住所 1 が以前の郵便番号から得た町域だけの場合、安全に管理状態を復元します。
郵便番号変更後に古い検索応答が返った場合、その応答を無視するようにしました。

1.1.13

郵便番号変更時に、以前 WJAH が補完した町域を新しい郵便番号の町域へ安全に置換するようにしました。
空欄のみ補完モードでは、利用者が入力した番地などの詳細住所を維持します。
WooCommerce Checkout Blocks の顧客データにも同じ安全な町域置換規則を適用しました。

1.1.12

古い値が残っている場合でも、都道府県と市区町村を郵便番号に合わせて補正するよう改善しました。
Checkout Blocks 向けに日本の都道府県コード（JP01～JP47）の同期を追加しました。
空欄のみ補完モードで詳細住所を消さないよう、町域・番地に対する上書き設定を維持しました。
同じ郵便番号を再処理する場合も、都道府県・市区町村を確実に再適用します。

1.1.11

住所解析をアダプター非依存コアと WooCommerce アダプターへ分離しました。
ローカル郵便番号 DB を使った都道府県・市区町村の整合性確認を追加しました。
停止モードが JavaScript の住所補完へ依存しないよう、Checkout Block／Store API のサーバー側検証を追加しました。
WooCommerce 住所欄へ対象を限定した不一致警告を追加しました。
既存設定と住所不足チェックは維持しました。

1.1.10

WKSS 共通 UI の説明表示切り替え位置を修正しました。
住所補完と住所不備チェックの有効・無効を明確なスイッチ表示にしました。
初心者向けの詳細説明と簡易表示時の上部表示を改善しました。

1.1.9

管理画面を WKSS 共通 UI スタイルへ更新しました。
詳細／簡易説明表示の切り替えを設定画面へ追加しました。
他の WKSS プラグインと揃うよう、設定要約カードとタブ配置を調整しました。

1.1.8

WordPress.org Plugin Check へ対応するため readme を英語要件に合わせました。
WordPress.org 向けの短い説明を更新しました。
v1.1.6 と v1.1.7 の機能を維持し、WordPress.org 公開版として整理しました。

1.1.7

v1.1.6 の内部テスト後、WordPress.org 公開情報を更新しました。
テスト済み WordPress バージョンを更新しました。
WordPress.org 向けの短い説明を整理しました。

1.1.6

タブ形式の設定画面を追加しました。
住所不備チェック設定を追加しました。
不完全な住所を検出する警告モードと停止モードを追加しました。
チェック対象として請求先、配送先、両方を選べるようにしました。
警告メッセージと停止メッセージを編集できるようにしました。
郵便番号データベース操作と仕様メモを専用タブへ整理しました。

1.1.4

WordPress.org のプラグインカード用短文とメイン説明を更新しました。
WordPress.org プラグインディレクトリ用アイコンを準備しました。

1.1.3

ファイルシステム、CSV アップロード、prepared SQL に関する Plugin Check エラーを低減しました。
CSV 取り込み時の明示的な実行時間制限変更を削除しました。

1.1.2

管理フォーム処理前の nonce 検証を明示しました。
フォーム処理と prepared SQL に関する Plugin Check 警告を低減しました。

1.1.1

ダウンロードした郵便番号データの SHA-256 比較を追加し、変更がない ZIP の展開・取り込みを省略できるようにしました。

1.1.0

メモリ使用量を抑えるため、郵便番号 CSV を 1 行ずつ処理する方式へ変更しました。
同じ郵便番号データが保存済みの場合、不要な再取り込みを省略するようにしました。
保守用の強制再取り込みボタンを追加しました。

1.0.9

郵便番号 DB 情報の設定画面表示を改善しました。
冒頭説明を読みやすい行に分けました。
狭い画面でソース URL のラベルが折り返さないよう改善しました。
メタデータ、Stable tag、PHP 構文を再確認しました。

1.0.8

日本郵便の現在の UTF-8 ZIP ダウンロードページへ対応しました。
相対形式の ZIP URL 解決を改善しました。
郵便番号 DB 更新時のエラー表示を改善しました。

1.0.7

日本郵便のダウンロードページ処理を更新しました。
ダウンロードページで見つかった CSV または ZIP リンクに対応しました。

1.0.6

予備 URL を試す前に、日本郵便のダウンロードページから取得先を探すようにしました。
リダイレクトとレスポンスヘッダーの処理を改善しました。

1.0.5

日本郵便 CSV ZIP のダウンロード処理を改善しました。
予備ダウンロード URL と ZIP 検証を追加しました。
旧 KEN_ALL.CSV 向けに Shift_JIS／CP932 変換を追加しました。

1.0.4

プラグイン名を WKSS Japan Address Helper へ変更しました。
スラッグとテキストドメインを wkss-japan-address-helper へ変更しました。
手動郵便番号 DB 更新で利用する日本郵便の外部サービスを明記しました。
プラグイン URL を CustomBox へ更新しました。
ローカル DB 検索と日本郵便データ更新に関する設定画面の説明を改善しました。

1.0.3

WordPress.org 申請で Author URI と一致しないよう Plugin URI を削除しました。

1.0.2

Plugin Check への対応を改善しました。
可能な範囲で直接ファイル操作を WordPress ファイルシステム API へ置き換えました。
安全でない SQL 補間を避けるよう郵便番号 DB への登録処理を変更しました。
readme を標準形式の英語へ書き直しました。

1.0.1

WordPress.org Plugin Check への対応を改善しました。
ファイル処理、DB 登録、CSV アップロード、readme 表現を安全化しました。

1.0.0

最初の公開候補としてバージョンを更新しました。
プラグインヘッダー、readme、作者、ライセンス、WordPress／PHP 要件、Stable tag を統一しました。

0.3.0

AjaxZip3 依存を削除しました。
ローカル郵便番号データベースを使う検索処理へ再構築しました。
CSV ダウンロード、手動 CSV 取り込み、郵便番号データ削除を追加しました。
クラシック WooCommerce フィールドと WooCommerce Blocks フィールドへの対応を改善しました。

WKSS Japan Address Helper

标签

下载

详情介绍:

安装:

常见问题:

更新日志: