Title: KSA National Address Validator Author: otoglobal Published: 2026年1月29日 Last modified: 2026年3月30日 --- プラグインを検索 ![](https://ps.w.org/ksa-national-address-validator/assets/icon-256x256.png?rev= 3457729) # KSA National Address Validator 作者: [otoglobal](https://profiles.wordpress.org/otoglobal/) [ダウンロード](https://downloads.wordpress.org/plugin/ksa-national-address-validator.1.2.2.zip) * [詳細](https://ja.wordpress.org/plugins/ksa-national-address-validator/#description) * [レビュー](https://ja.wordpress.org/plugins/ksa-national-address-validator/#reviews) * [インストール](https://ja.wordpress.org/plugins/ksa-national-address-validator/#installation) * [開発](https://ja.wordpress.org/plugins/ksa-national-address-validator/#developers) [サポート](https://wordpress.org/support/plugin/ksa-national-address-validator/) ## 説明 This plugin enhances the WooCommerce checkout experience by adding a “National Address Short Code” field. When a customer enters their 8-character short code, the plugin communicates with the OTO National Address API to fetch and automatically populate the checkout address fields (City, District, Street Address, etc.). #### Features * Adds a National Address Short Code field to the WooCommerce checkout page (Classic and Blocks). * Field is shown only when Saudi Arabia is selected as the billing country. * Validates the format of the short code (4 letters followed by 4 digits, e.g. ABCD1234). * Fetches address details from the OTO API and auto-fills City, District, Street, Postcode fields. * Optional: mark the field as required for Saudi Arabia orders only (non-SA orders are never blocked). * Connect/disconnect via email and password login (supports 2FA/TOTP). * Caches the API access token (55 minutes) to minimise API calls. * Compatible with WooCommerce High-Performance Order Storage (HPOS). * Fully compatible with both Classic checkout and WooCommerce Blocks checkout. ### External services This plugin connects to the OTO API to validate Saudi Arabian National Address short codes and retrieve address details during WooCommerce checkout. #### What this service does The OTO National Address API validates 8-character Saudi National Address short codes (e.g., ABCD1234) and returns the corresponding address information including city, district, street name, building number, and postal code. This data is used to automatically populate checkout address fields for customers in Saudi Arabia. #### Data transmitted **During plugin authentication (admin settings page):** – Email address and password are sent to authenticate with the OTO API – If 2FA is enabled, the one-time password( OTP) code is also sent – A refresh token is returned and stored to maintain the connection **During checkout validation (when customer enters a short code):** – The National Address short code entered by the customer is sent to the API – An access token ( obtained via the stored refresh token) is sent for authentication – Address data is returned and used to populate checkout fields #### Service provider This service is provided by OTO Global. * Service website: [https://tryoto.com/](https://tryoto.com/) * Terms and Conditions: [https://www.tryoto.com/terms-and-conditions](https://www.tryoto.com/terms-and-conditions) * Privacy Policy: [https://www.tryoto.com/privacy-policy](https://www.tryoto.com/privacy-policy) ## インストール 1. Upload the `ksa-national-address-validator` folder to the `/wp-content/plugins/` directory, or install directly from the WordPress.org plugin directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Go to **WooCommerce KSA Validator** (or Settings KSA Validator) and click **Connect**. 4. Enter your OTO account email and password to authenticate. If your account uses two-factor authentication (2FA), select “2FA Enabled: Yes” and enter your OTP code. 5. Once connected, the National Address Short Code field will appear automatically on the checkout page when Saudi Arabia is selected as the billing country. ## FAQ ### Where do I get an OTO account? You can sign up for an OTO account at [https://tryoto.com/](https://tryoto.com/). ### Does this work with the WooCommerce Blocks checkout? Yes. The plugin supports both the Classic checkout and the modern WooCommerce Blocks checkout out of the box. ### Will non-Saudi Arabia customers be affected? No. The shortcode field is hidden for all non-SA billing countries and validation is completely skipped for non-SA orders, even when the “required” setting is enabled. ## 評価 このプラグインにはレビューがありません。 ## 貢献者と開発者 KSA National Address Validator はオープンソースソフトウェアです。以下の人々がこの プラグインに貢献しています。 貢献者 * [ otoglobal ](https://profiles.wordpress.org/otoglobal/) * [ hammadoto ](https://profiles.wordpress.org/hammadoto/) [“KSA National Address Validator” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/ksa-national-address-validator) ### 開発に興味がありますか ? [コードを閲覧](https://plugins.trac.wordpress.org/browser/ksa-national-address-validator/) するか、[SVN リポジトリ](https://plugins.svn.wordpress.org/ksa-national-address-validator/) をチェックするか、[開発ログ](https://plugins.trac.wordpress.org/log/ksa-national-address-validator/) を [RSS](https://plugins.trac.wordpress.org/log/ksa-national-address-validator/?limit=100&mode=stop_on_copy&format=rss) で購読してみてください。 ## 変更履歴 #### 1.2.2 * Fixed: “Required” setting now correctly blocks Blocks checkout submission for Saudi Arabia orders when shortcode field is empty * Fixed: Non-SA countries can now complete Blocks checkout without being incorrectly blocked by the required shortcode validation * Fixed: Classic checkout no longer enforces shortcode required validation for non-Saudi Arabia orders on server-side * Fixed: Blocks checkout field now shows native required indicator (*) when the required setting is enabled * Improved: Required field validation is now country-aware for both Classic and Blocks checkout engines #### 1.2.1 * Changed plugin prefix from ksa_nav_ to otoksa_ for WordPress.org compliance ( minimum 4 characters required) * Updated all PHP classes, functions, options, AJAX actions, and JavaScript globals to use new prefix * Maintains backward compatibility with existing installations using old prefix * Order meta display checks both old and new key formats #### 1.2.0 * Added “Set Shortaddress Field Required” setting for checkout validation * Added External Services documentation for WordPress.org compliance * Fixed all prefixing issues for WordPress.org guidelines compliance * Improved uninstall cleanup for options and transients * Removed unnecessary WooCommerce logger modification #### 1.1.0 * feat: Integrate OTO National Address API and enhance validation * feat: Add loading spinner and refine client-side validation * fix: Clear access token cookie if API key is empty * feat: Add CSS for KSA National Address Shortcode styling * feat: Swap buildingName and streetName mapping #### 1.0.0 * Initial release. ## メタ * バージョン **1.2.2** * 最終更新日 **6か月前** * 有効インストール数 **80+** * WordPress バージョン ** 5.0またはそれ以降 ** * 検証済み最新バージョン: **6.9.10** * PHP バージョン ** 7.2またはそれ以降 ** * 言語 * [English (US)](https://wordpress.org/plugins/ksa-national-address-validator/) * タグ * [address](https://ja.wordpress.org/plugins/tags/address/)[checkout](https://ja.wordpress.org/plugins/tags/checkout/) [Saudi Arabia](https://ja.wordpress.org/plugins/tags/saudi-arabia/)[validation](https://ja.wordpress.org/plugins/tags/validation/) [woocommerce](https://ja.wordpress.org/plugins/tags/woocommerce/) * [詳細を表示](https://ja.wordpress.org/plugins/ksa-national-address-validator/advanced/) ## 評価 レビューはまだ送信されていません。 [Your review](https://wordpress.org/support/plugin/ksa-national-address-validator/reviews/#new-post) [すべてのレビューを見る](https://wordpress.org/support/plugin/ksa-national-address-validator/reviews/) ## 貢献者 * [ otoglobal ](https://profiles.wordpress.org/otoglobal/) * [ hammadoto ](https://profiles.wordpress.org/hammadoto/) ## サポート 意見や質問がありますか ? [サポートフォーラムを表示](https://wordpress.org/support/plugin/ksa-national-address-validator/) ## 寄付 このプラグインが今後も改善できるよう応援しませんか ? [ このプラグインに寄付 ](https://tryoto.com/)