WKSS Japan Address Helper -- WordPress 插件

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

WKSS Japan Address Helper helps WooCommerce stores in Japan fill address fields from Japanese postal codes. For normal customer address lookup, this plugin does not use AjaxZip3 or any external lookup API. Address lookup is performed against a local postal code database stored in WordPress. The plugin connects to Japan Post only when an administrator manually runs the postal code database update from the settings screen. Main Features

Supports WooCommerce checkout, cart, and account address forms.
Supports WooCommerce Blocks checkout and cart address field updates.
Helps fill prefecture, city, and town address fields from Japanese postal codes.
Uses a local postal code database for normal address lookup.
Does not send customer address lookup data to Japan Post or any external service during checkout or address entry.
Downloads official Japan Post postal code CSV data only when an administrator manually runs the postal database update.
Provides a tabbed settings screen for basic settings, address validation, postal code data, and implementation notes.
Adds address validation options to warn or block checkout when postal-code consistency or street/block details may be incorrect.
Checks postal code against prefecture and municipality using the local postal code database.
Performs server-side validation for both classic checkout and Checkout Block / Store API order placement.
Address validation can target billing address, shipping address, or both.
Warning and blocking messages can be edited from the settings screen.
Adds a settings link to the plugin list.
Shows the plugin version on the settings screen.

Install the plugin from the WordPress plugin screen, or upload the plugin ZIP file.
Activate the plugin through the Plugins screen in WordPress.
To use customer-facing address features, make sure WooCommerce is active.
Open the WKSS Japan Address Helper settings screen under WooCommerce, or under Settings when WooCommerce is inactive.
Update the postal code database if needed.
Configure address validation options if you want to warn or block checkout when address details may be incomplete.

1.1.34

Limits the administration screen to postal-code data and maintenance tools when the supported address platform is inactive.
Removes platform-dependent settings, status cards, specifications, and integration descriptions from that inactive-state DOM while preserving all saved settings.
Keeps the v1.1.33 Checkout Blocks synchronization fix and all customer-facing address behavior unchanged.

1.1.33

Reconciles Checkout Blocks address state after WooCommerce's delayed postcode update so a newly resolved prefecture and municipality are not replaced by the previous address snapshot.
Keeps the fix limited to Blocks address synchronization and preserves detailed address input, foreign-country protection, Classic Checkout behavior, settings, database, and administration behavior.

1.1.32

Keeps the Checkout Blocks prefecture and municipality synchronized when a postal code changes, while preserving detailed address input and foreign-country selections.

1.1.31

Added the MS-039 shared WKSS administration hub contract and canonical asset set without changing address or postal-data behavior.
Keeps a standard WordPress menu fallback when the shared hub contract or assets are incompatible.

1.1.30

Adds a clear waiting notice and live processing status for postal-code database updates and imports, including guidance not to close or reload the page until completion.

1.1.29

Keep Classic Checkout address updates out of the Blocks customer-data store so a stored JP country cannot overwrite a newly selected foreign country.

1.1.28

Cancel pending postal lookups when the checkout country changes, preventing a Classic Checkout re-render from applying a stale Japanese address to a foreign country selection.

1.1.27

Imports postal data into an isolated staging table and keeps the previous live database when parsing, insertion, or table replacement fails.
Expands postal town text storage so current official Japan Post rows are not rejected when kana content exceeds the previous field limit.
Prevents stale postcode results from being applied while a newer postcode lookup is pending.
Restricts Japanese postcode completion to Japanese or not-yet-selected country fields and no longer overwrites a selected foreign country.
Aligns frontend warnings with the configured validation target and adds address-line warning rules used by server-side validation.
Adds settings export, restore, and reset controls.
Adds an explicit complete-data deletion action while normal WordPress uninstall continues to retain settings and postal data.
Adds file-integrity status and one-time update consent protection.

1.1.23

Added the WKSS standard Compact Header with shared saved state, restore controls, server time, and synchronized description display.
Allowed activation and administration without WooCommerce; WooCommerce-specific customer address features remain unavailable until WooCommerce is active.
Documented the WKSS branding boundary for modified and redistributed versions.
Preserved the existing address lookup, validation, and postal database behavior.

1.1.22

Fixed postcode autofill for municipality fields in Cart and Checkout Blocks by synchronizing the official WooCommerce cart data store before DOM events.
Uses the native input/select value setter so React-controlled address fields recognize WJAH changes without affecting Classic Checkout.
Preserves user-entered street/building details and keeps the Address Core, Classic/Blocks server validation, settings, and database schema unchanged.

1.1.21

Escaped the Checkout Blocks validation exception message before passing it to the exception object.
Documented narrowly scoped direct-database-query exceptions for the plugin-owned postal-code table so Plugin Check can distinguish the intentional local dataset operations.
Kept the administration UI, settings, database schema, address lookup, Classic/Blocks validation behavior, and user-entered address protection unchanged.

1.1.20

Finalized the WJAH administration UI against the WKSS/WEM shared layout and information hierarchy.
Uses the official WJAH icon, semantic status cards, accessible tabs, responsive spacing, and a visually separated high-impact postal-data deletion area.
Keeps the existing tabs and adds an informational WKSS integration tab without adding plugin dependencies.
Does not add backup, restore, reset, postal-data import progress, or other processing behavior.
Kept all settings, option keys, database structures, hooks, imports, validation, and address logic unchanged from the v1.1.14 functional baseline.

1.1.18

Replaced the WEM-specific green administration accent with WJAH's own restrained Japanese postbox-red palette.
Preserved the shared WEM layout structure, the official WJAH icon, and all existing settings and feature logic.

1.1.17

Aligned the administration shell with the current WEM layout: wider identity column, stable 2-by-2 status cards, green suite header treatment, menu guidance placement, tabs, and spacing.
Removed the redundant visible status strip below the tabs because the same state remains available in the header cards.
Kept the official WJAH icon and all existing settings, hooks, database structures, validation, import, and address logic unchanged.

1.1.16

Replaced the temporary letter badge with the official WKSS WJAH icon from the approved WKSS icon package.
Kept all settings, hooks, database structures, validation, import, and address logic unchanged.

1.1.15

Unified the administration screen with the current WKSS/WEM visual and information structure.
Added the WKSS suite icon, semantic status labels, compact expert summaries, and accessible current-tab state.
Visually separated postal-data deletion as a high-impact operation without changing its processing.
Added an informational WKSS integration tab; no plugin dependency or integration logic was added.
Added a visible saving state to existing settings forms.
Kept all existing settings, option keys, database structures, hooks, validation, imports, and address logic unchanged.

1.1.14

Tracks WJAH-managed town values by billing/shipping scope in page memory so WooCommerce Blocks re-renders do not lose safe replacement state.
Replaces a previous auto-filled town only when the current value still exactly matches WJAH's managed value; shopper-entered house numbers and other edits remain untouched.
Recovers safe town ownership when the current address line contains only the exact town from the previously resolved postcode.
Ignores stale postcode lookup responses when a shopper changes postcodes before an earlier request finishes.

1.1.13

Fixed postcode changes so a town previously auto-filled by WJAH is safely replaced with the new postcode's town.
Keeps detailed user-entered street and house-number text unchanged in empty-only mode.
Applies the same safe town-replacement rule to WooCommerce Checkout Blocks customer data.

1.1.12

Fixed postal-code autofill so prefecture and municipality are corrected even when stale values already exist.
Added WooCommerce Japanese prefecture-code synchronization (JP01-JP47) for Checkout Blocks.
Preserved the configured overwrite policy for town/street/house-number fields so existing detailed addresses are not erased in empty-only mode.
Reapplies deterministic prefecture/city data when the same cached postcode is processed again.

1.1.11

Split address analysis into an adapter-neutral core and a WooCommerce adapter.
Added local postal-code database consistency checks for prefecture and municipality.
Added server-side Checkout Block / Store API validation so blocking mode does not depend on JavaScript address completion.
Added scoped frontend mismatch warnings for WooCommerce address fields.
Preserved existing settings and existing incomplete-address checks.

1.1.10

Fixed the WKSS common UI explanation toggle alignment.
Added clearer enable/disable switch UI for address completion and address validation.
Improved beginner-friendly detail descriptions and simplified the top area in simple display mode.

1.1.9

Updated the admin screen layout to align with the WKSS common UI style.
Added the detail/simple explanation display toggle to the settings screen.
Refined the settings summary cards and tab layout for consistency with other WKSS plugins.

1.1.8

Updated the readme content in English for WordPress.org Plugin Check compatibility.
Updated the plugin short description for WordPress.org compatibility.
Kept the v1.1.6 and v1.1.7 feature set while preparing the package for WordPress.org release.

1.1.7

Updated WordPress.org release metadata after v1.1.6 internal testing.
Updated the tested WordPress version header.
Prepared the readme short description for WordPress.org Plugin Check compatibility.

1.1.6

Added a tabbed settings screen.
Added address validation settings.
Added warning mode and blocking mode for incomplete address detection.
Added billing, shipping, and both-address validation targets.
Added configurable warning and blocking messages.
Organized postal code database tools and implementation notes into dedicated settings tabs.

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.

WKSS Japan Address Helper

标签

下载

详情介绍:

安装:

常见问题:

更新日志: