{"id":272428,"date":"2026-01-08T10:14:29","date_gmt":"2026-01-08T10:14:29","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/saudi-address-pro\/"},"modified":"2026-03-26T13:18:49","modified_gmt":"2026-03-26T13:18:49","slug":"saudi-address-pro","status":"publish","type":"plugin","link":"https:\/\/fa.wordpress.org\/plugins\/saudi-address-pro\/","author":23432252,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.4","stable_tag":"1.0.4","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Saudi Address Pro","header_author":"Saudi Address Pro","header_description":"Adds Saudi National Address (SPL) autocomplete to WooCommerce checkout. TGA 2026 compliant. Customers enter short codes like \"RCTB4359\" to auto-fill verified addresses instantly.","assets_banners_color":"","last_updated":"2026-03-26 13:18:49","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/saudiaddresspro.com\/docs","header_author_uri":"https:\/\/saudiaddresspro.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":395,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"abdullahalmulhim1","date":"2026-01-08 10:22:51"},"1.0.1":{"tag":"1.0.1","author":"abdullahalmulhim1","date":"2026-02-18 10:58:26"},"1.0.4":{"tag":"1.0.4","author":"abdullahalmulhim1","date":"2026-03-26 13:18:49"}},"upgrade_notice":{"1.0.4":"<p>Updates WooCommerce compatibility declaration to 10.x, removing the outdated version warning shown on stores running WooCommerce 10+. Recommended update for all users.<\/p>","1.0.3":"<p>Stability fix for WooCommerce block checkout. Resolves a critical issue where the widget could cause infinite loops on block-based checkout pages. Recommended update for all users on WooCommerce 8.3+.<\/p>","1.0.2":"<p>Critical update: Adds support for WooCommerce block checkout (default since WooCommerce 8.3+). If your widget is not appearing at checkout, this update will fix it. Also adds a &quot;Test Connection&quot; button to verify your setup.<\/p>","1.0.1":"<p>Improved compatibility with caching plugins (WP Rocket, LiteSpeed Cache). Recommended update for all users.<\/p>","1.0.0":"<p>Initial release of Saudi Address Pro for WooCommerce.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3436950,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3436952,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Widget appearing at checkout when Saudi Arabia is selected","2":"Address search results dropdown","3":"Auto-filled address fields after selection","4":"Admin settings page with Test Connection button"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[3513,2183,3226,126054,286],"plugin_category":[45,49],"plugin_contributors":[253574],"plugin_business_model":[],"class_list":["post-272428","plugin","type-plugin","status-publish","hentry","plugin_tags-address","plugin_tags-address-validation","plugin_tags-autocomplete","plugin_tags-saudi-arabia","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-maps-and-location","plugin_contributors-abdullahalmulhim1","plugin_committers-abdullahalmulhim1"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/saudi-address-pro\/assets\/icon-128x128.png?rev=3436950","icon_2x":"https:\/\/ps.w.org\/saudi-address-pro\/assets\/icon-256x256.png?rev=3436952","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>Saudi Address Pro<\/strong> is the definitive address autocomplete solution for WooCommerce merchants operating in Saudi Arabia. Designed to meet the Transport General Authority (TGA) 2026 mandate, our plugin ensures every order is captured with a verified, 100% accurate National Address directly from the Saudi Post (SPL) database.<\/p>\n\n<h4>The Problem<\/h4>\n\n<p>In the Saudi market, address accuracy is the single biggest barrier to successful last-mile delivery. Customers often struggle to enter complex address details manually, leading to:<\/p>\n\n<ul>\n<li>Failed deliveries and returns<\/li>\n<li>Customer frustration and cart abandonment<\/li>\n<li>Increased support tickets<\/li>\n<li>Non-compliance with upcoming regulations<\/li>\n<\/ul>\n\n<h4>The Solution<\/h4>\n\n<p>Saudi Address Pro allows customers to enter a simple short code (e.g., \"RCTB4359\"), which instantly auto-fills the complete, official address details\u2014including building number, street name, district, city, and postal code.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Official SPL Database Integration<\/strong> - Connect directly to the authoritative Saudi Post National Address system<\/li>\n<li><strong>Smart Short Code Autocomplete<\/strong> - Customers type their 4-character, 4-digit code and address fields populate instantly<\/li>\n<li><strong>TGA 2026 Compliance Ready<\/strong> - Collect compliant addresses today, before the January 1, 2026 deadline<\/li>\n<li><strong>Seamless Checkout Integration<\/strong> - Works with both classic and block-based WooCommerce checkout<\/li>\n<li><strong>Bilingual Support<\/strong> - Full Arabic and English support with RTL<\/li>\n<li><strong>Zero-Config Field Mapping<\/strong> - Works out of the box with standard WooCommerce checkout<\/li>\n<li><strong>Test Connection<\/strong> - Verify your API key works directly from the settings page<\/li>\n<\/ul>\n\n<h4>Why Choose Saudi Address Pro?<\/h4>\n\n<ul>\n<li><strong>Reduce cart abandonment<\/strong> - Faster checkout with fewer keystrokes<\/li>\n<li><strong>Eliminate address errors<\/strong> - Verified data from official government database<\/li>\n<li><strong>Ensure compliance<\/strong> - Meet TGA 2026 requirements<\/li>\n<li><strong>Improve delivery success<\/strong> - Accurate addresses for first-time delivery<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WooCommerce 5.0 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<li>Saudi Address Pro API key (get one at <a href=\"https:\/\/saudiaddresspro.com\">saudiaddresspro.com<\/a>)<\/li>\n<\/ul>\n\n<h3>Privacy Policy<\/h3>\n\n<p>Saudi Address Pro connects to the Saudi Post (SPL) National Address API to retrieve address data. Customer address queries are sent to our API server (<a href=\"https:\/\/saudiaddresspro.com\">saudiaddresspro.com<\/a>) which forwards requests to the official SPL database.<\/p>\n\n<p>We do not store customer personal data on our servers. API usage logs are retained for service quality and rate limiting purposes only.<\/p>\n\n<p>For more information, see our <a href=\"https:\/\/saudiaddresspro.com\/privacy\">Privacy Policy<\/a> and <a href=\"https:\/\/saudiaddresspro.com\/terms\">Terms of Service<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/saudi-address-pro<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Navigate to <strong>Saudi Address Pro<\/strong> in the admin menu.<\/li>\n<li>Enter your API key (get one at <a href=\"https:\/\/saudiaddresspro.com\/dashboard\">saudiaddresspro.com\/dashboard<\/a>).<\/li>\n<li>Click \"Test Connection\" to verify your API key works.<\/li>\n<li>Configure your preferred language and options.<\/li>\n<li>Save settings and you're ready to go!<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20an%20api%20key%3F\"><h3>Do I need an API key?<\/h3><\/dt>\n<dd><p>Yes, a Saudi Address Pro API key is required. You can get one by signing up at <a href=\"https:\/\/saudiaddresspro.com\">saudiaddresspro.com<\/a>. A 60-day free trial with unlimited validations is available.<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20the%20new%20woocommerce%20block%20checkout%3F\"><h3>Does this work with the new WooCommerce block checkout?<\/h3><\/dt>\n<dd><p>Yes! Starting from version 1.0.2, the plugin fully supports both the classic WooCommerce checkout and the new block-based checkout (default in WooCommerce 8.3+).<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20guest%20checkout%3F\"><h3>Does this work with guest checkout?<\/h3><\/dt>\n<dd><p>Yes, the widget works for both guest and registered customer checkout.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20with%20custom%20checkout%20plugins%3F\"><h3>Can I use this with custom checkout plugins?<\/h3><\/dt>\n<dd><p>Yes, as long as the checkout plugin follows WooCommerce's standard field naming conventions. For custom field mapping, you can listen for the <code>saudi_address_selected<\/code> JavaScript event.<\/p><\/dd>\n<dt id=\"is%20the%20short%20address%20code%20required%3F\"><h3>Is the short address code required?<\/h3><\/dt>\n<dd><p>No, customers can search by typing their full address. The short code is an optional convenience feature that speeds up the process.<\/p><\/dd>\n<dt id=\"does%20this%20validate%20addresses%20in%20real-time%3F\"><h3>Does this validate addresses in real-time?<\/h3><\/dt>\n<dd><p>Yes, all addresses come directly from the Saudi Post (SPL) database and are verified at the time of selection.<\/p><\/dd>\n<dt id=\"is%20arabic%20supported%3F\"><h3>Is Arabic supported?<\/h3><\/dt>\n<dd><p>Yes, the widget fully supports Arabic with proper RTL (right-to-left) layout. You can configure the language in the settings.<\/p><\/dd>\n<dt id=\"how%20can%20i%20verify%20the%20plugin%20is%20working%3F\"><h3>How can I verify the plugin is working?<\/h3><\/dt>\n<dd><p>Go to the Saudi Address Pro settings page in your WordPress admin and click the \"Test Connection\" button next to your API key. This will verify your API key and connection to our server.<\/p><\/dd>\n<dt id=\"what%20is%20the%20tga%202026%20mandate%3F\"><h3>What is the TGA 2026 mandate?<\/h3><\/dt>\n<dd><p>The Transport General Authority (TGA) of Saudi Arabia has mandated that all parcel deliveries must include a valid National Address starting January 1, 2026. This plugin helps you collect compliant addresses.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Updated WC tested up to 10.6 \u2014 removes compatibility warning for stores on WooCommerce 10.x<\/li>\n<li>Fixed output escaping to comply with WordPress security coding standards<\/li>\n<li>Added translator comment for internationalization support<\/li>\n<li>Updated Tested up to header to WordPress 6.9<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fixed critical infinite loop in WooCommerce block checkout (WC 8.3+) caused by MutationObserver feedback cycle<\/li>\n<li>Improved widget stability: debounced visibility toggling and guarded DOM mutations prevent re-entry loops<\/li>\n<li>Widget uses non-animating show\/hide in block checkout to avoid DOM mutation cascades<\/li>\n<li>Observer auto-cleanup: retry interval stops once widget is positioned and fields are detected<\/li>\n<li>Fixed field highlight class changes from re-triggering the block checkout observer<\/li>\n<li>Improved region selection and field value setting with mutation guards<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Added full support for WooCommerce block-based checkout (default in WooCommerce 8.3+)<\/li>\n<li>Added \"Test Connection\" button in admin settings to verify API key<\/li>\n<li>Added widget label for better customer clarity (\"Saudi National Address\")<\/li>\n<li>Improved field detection for block checkout with MutationObserver<\/li>\n<li>Added request timeout handling (10 seconds) to prevent stuck searches<\/li>\n<li>Fixed search request cancellation when typing quickly<\/li>\n<li>Better React-based checkout field value setting for block checkout compatibility<\/li>\n<li>Updated WC tested up to 9.6<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Improved compatibility with caching and optimization plugins (WP Rocket, LiteSpeed Cache, W3 Total Cache)<\/li>\n<li>Fixed address search reliability when JavaScript minification is enabled<\/li>\n<li>Better error messages in Arabic and English<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>WooCommerce checkout integration<\/li>\n<li>Address autocomplete with short code support<\/li>\n<li>Admin settings page<\/li>\n<li>Arabic and English language support<\/li>\n<li>HPOS (High-Performance Order Storage) compatible<\/li>\n<\/ul>","raw_excerpt":"Verified Saudi National Address (SPL) autocomplete for WooCommerce. Short code auto-fill from the official Saudi Post database.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/272428","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=272428"}],"author":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/abdullahalmulhim1"}],"wp:attachment":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=272428"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=272428"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=272428"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=272428"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=272428"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=272428"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}