Description
WKSS Japan Address Helperは、日本のWooCommerceストア向けに、郵便番号から住所入力を補助するプラグインです。
通常のお客様による住所検索では、AjaxZip3や外部の住所検索APIを使用しません。WordPress内に保存されたローカル郵便番号データベースを検索します。
日本郵便へ接続するのは、管理者が設定画面から郵便番号データベースの更新を手動実行した場合だけです。
主な機能
- WooCommerceの購入手続き、カート、マイアカウントの住所フォームに対応します。
- WooCommerce Blocksの購入手続き・カート住所フィールド更新に対応します。
- 郵便番号から都道府県・市区町村・町域の入力を補助します。
- 通常の住所検索にはローカル郵便番号データベースを使用します。
- 購入手続きや住所入力時に、お客様の住所検索情報を日本郵便や外部サービスへ送信しません。
- 管理者が郵便番号データベース更新を手動実行した場合だけ、日本郵便の公式郵便番号CSVを取得します。
- 基本設定、住所不備チェック、郵便番号データ、仕様メモをタブ形式の設定画面で管理できます。
- 郵便番号との整合性や番地情報に問題がある可能性を検出し、警告または購入停止を行えます。
- ローカル郵便番号データベースを使って、郵便番号と都道府県・市区町村の一致を確認します。
- クラシック購入手続きとCheckout Block/Store API注文の両方でサーバー側検証を行います。
- 住所不備チェックの対象を請求先、配送先、または両方から選択できます。
- 警告メッセージと停止メッセージを設定画面から編集できます。
- プラグイン一覧に設定リンクを追加します。
- 設定画面にプラグインのバージョンを表示します。
External Services
このプラグインは、管理者が設定画面で郵便番号データベースの更新ボタンを押した場合だけ、日本郵便から郵便番号CSVを取得できます。
外部サービスの利用目的
- 日本郵便の公式郵便番号CSVデータを取得するため。
送信される情報とタイミング
- 管理者が郵便番号データベース更新を手動実行した場合だけ、サーバーから日本郵便へ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内に保存されたローカル郵便番号データベースを使用します。
Requirements
- WordPress 6.0以上
- PHP 7.4以上
- WooCommerce 7.0以上(お客様向け住所補完・購入手続き検証を利用する場合)
データの保持と削除
通常のプラグイン削除では、再インストール後に再利用できるよう設定とローカル郵便番号データベースを保持し、一時的な取り込みロックと更新許可ロックを削除します。
WJAHの設定とローカル郵便番号データベースを完全に削除する場合は、プラグインファイルを削除する前に「バックアップ・保守」タブの明示的な完全削除操作を実行してください。
設定のバックアップ
「バックアップ・保守」タブでは、WJAH設定をJSON形式で書き出し・復元したり、初期値へ戻したりできます。容量の大きいローカル郵便番号データベースは設定バックアップに含まれず、日本郵便から再取得できます。
Installation
- WordPressのプラグイン画面からインストールするか、プラグインZIPをアップロードします。
- WordPressのプラグイン画面で有効化します。
- お客様向け住所機能を利用する場合は、WooCommerceが有効であることを確認します。
- WooCommerce有効時はWooCommerce配下、無効時は設定配下からWKSS Japan Address Helperの設定画面を開きます。
- 必要に応じて郵便番号データベースを更新します。
- 住所情報が不完全な可能性を警告または購入停止したい場合は、住所不備チェックを設定します。
FAQ
お客様の住所情報を外部サービスへ送信しますか?
いいえ。お客様の住所検索には、WordPress内のローカル郵便番号データベースを使用します。
AjaxZip3を使用しますか?
いいえ。通常のお客様による住所検索ではAjaxZip3を使用しません。
日本郵便へ接続するのはいつですか?
管理者が設定画面から郵便番号データベースの更新を手動実行した場合だけです。
WooCommerce Blocksに対応していますか?
はい。WooCommerce Blocksの購入手続き・カート住所フィールド更新に対応しています。
WooCommerceは必須ですか?
お客様向け住所補完と購入手続き検証には必要です。WooCommerceが無効でも、プラグインを有効化し、設定配下からローカル郵便番号データベースの準備・確認と保守を行えます。
住所不備チェックで購入を止められますか?
はい。住所不備チェックは、無効、警告モード、停止モードから選択できます。対象は請求先、配送先、または両方から選択できます。停止モードでは、郵便番号と都道府県または市区町村の不一致を注文確定前にサーバー側で拒否します。
改変版でWKSSの名称やブランドを使用できますか?
ソースコードはGPL v2以降で配布しています。ただし、第三者が改変または再配布する版では、WKSS、WAKAISS WORKS、若井製作所、それらの商品名、スラッグ、ロゴ、公式アイコン、開発者・販売者情報、ドメイン、または公式・推奨・認定・サポート済みと誤認させる表現を使用できません。公式な関係を示唆しない、必要最小限の事実に基づく互換性表記だけを認めます。
Changelog
1.1.34
- 対応する住所プラットフォームが無効な場合、管理画面を郵便番号データと保守機能だけに限定しました。
- 保存済み設定を維持したまま、無効状態ではプラットフォーム依存の設定、状態カード、仕様、連携説明をDOMへ出力しないようにしました。
- v1.1.33のCheckout Blocks同期修正と、お客様向け住所機能の動作は変更していません。
1.1.33
- WooCommerceによる遅延した郵便番号更新後にCheckout Blocksの住所状態を再調整し、新しく解決した都道府県・市区町村が以前の住所スナップショットで置き換えられないようにしました。
- 修正範囲をBlocksの住所同期に限定し、詳細住所入力、国外住所保護、クラシック購入手続き、設定、データベース、管理画面の動作を維持しました。
1.1.32
- 郵便番号変更時にCheckout Blocksの都道府県と市区町村を同期しながら、詳細住所入力と国外住所の選択を維持するよう改善しました。
1.1.31
- 住所処理や郵便番号データの動作を変更せず、MS-039共通WKSS管理ハブ契約と正本アセット一式を追加しました。
- 共通ハブ契約またはアセットに互換性がない場合は、WordPress標準メニューへ安全に縮退します。
1.1.30
- 郵便番号データの更新・取り込み時に、完了まで画面を閉じたり再読み込みしたりしないための待機案内とリアルタイム処理状況を追加しました。
1.1.29
- 保存済みの日本住所の国コードが新しく選択した国外住所を上書きしないよう、クラシック購入手続きの住所更新をBlocks顧客データストアから分離しました。
1.1.28
- 購入手続きの国を変更した場合に保留中の郵便番号検索を取り消し、古い日本住所が国外住所へ適用されないようにしました。
1.1.27
- 郵便番号データを分離した作業用テーブルへ取り込み、解析・登録・テーブル切り替えに失敗した場合は以前の正常なデータベースを保持するようにしました。
- 現行の日本郵便データで、かな文字列が以前の上限を超えても拒否されないよう町域文字列の保存容量を拡張しました。
- 新しい郵便番号検索の待機中に、古い検索結果が適用されないようにしました。
- 日本の郵便番号補完を、国が日本または未選択の住所欄に限定し、選択済みの国外住所を上書きしないようにしました。
- 画面上の警告を設定された検証対象に合わせ、サーバー側検証と共通の住所行警告ルールを追加しました。
- 設定の書き出し、復元、初期化を追加しました。
- 通常のWordPressアンインストールでは設定と郵便番号データを保持しつつ、明示的な完全削除操作を追加しました。
- ファイル整合性表示と、次回更新を一時的に許可する保護機能を追加しました。
1.1.23
- 保存状態を共有するWKSS標準コンパクトヘッダー、復元操作、サーバー時刻、同期された説明表示を追加しました。
- WooCommerceなしでも有効化・管理できるようにしました。WooCommerce固有のお客様向け住所機能はWooCommerceが有効になるまで利用できません。
- 改変版・再配布版に対するWKSSブランド境界を明記しました。
- 既存の住所検索、検証、郵便番号データベースの動作を維持しました。
1.1.22
- カートブロックと購入手続きブロックで、市区町村の住所補完結果が確実に反映されるよう、DOMイベントより先にWooCommerce公式のカートデータストアを同期するよう改善しました。
- Reactで管理される住所入力欄がWJAHの変更を認識できるよう、input/select要素の標準値設定処理を使用しました。クラシック購入手続きの動作には影響しません。
- 利用者が入力した番地・建物名を維持し、住所解析コア、クラシック/Blocksのサーバー側検証、設定、データベース構造は変更していません。
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フィールドへの対応を改善しました。