{"id":300181,"date":"2026-04-26T12:05:07","date_gmt":"2026-04-26T12:05:07","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/afriregions-city-neighborhood-for-woocommerce\/"},"modified":"2026-07-24T02:56:34","modified_gmt":"2026-07-24T02:56:34","slug":"afriregions-city-neighborhood-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/mg.wordpress.org\/plugins\/afriregions-city-neighborhood-for-woocommerce\/","author":23468482,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.9","stable_tag":"1.0.9","tested":"7.0.2","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"AfriRegions City & Neighborhood for WooCommerce","header_author":"woonet237","header_description":"Structured address fields for WooCommerce \u2014 cascading regions, cities, and neighborhoods with zone-based shipping and address validation.","assets_banners_color":"fbf5f0","last_updated":"2026-07-24 02:56:34","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/afriregions.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":472,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.7":{"tag":"1.0.7","author":"woonet237","date":"2026-07-02 12:02:54"},"1.0.8":{"tag":"1.0.8","author":"woonet237","date":"2026-07-02 14:27:58"},"1.0.9":{"tag":"1.0.9","author":"woonet237","date":"2026-07-24 02:56:34"}},"upgrade_notice":{"1.0.9":"<p>Adds tax options on the shipping method; the free shipping threshold and the mobile address API are now Pro features. Important fixes to shipping rates, phone number storage, and checkout for Ethiopia and Rwanda. Recommended for all users.<\/p>","1.0.8":"<p>Fixes address fields staying disabled at checkout on page load. Improves the shipping method admin layout. Recommended for all users.<\/p>","1.0.7":"<p>Admin redesigned with sidebar navigation. Faster address data loading. Adds 5 new countries. Recommended for all users.<\/p>","1.0.6":"<p>Fixes the shipping rule highlight animation. Recommended for all users.<\/p>","1.0.5":"<p>Fixes address search at checkout and improves the upgrade page accuracy.<\/p>","1.0.4":"<p>Adds &quot;hide if no rule matches&quot; option. Improves address search without accents. Fixes shipping cost display in the order view.<\/p>","1.0.3":"<p>Stability fixes - recommended for all users.<\/p>","1.0.2":"<p>Improved address field loading on slow mobile connections.<\/p>","1.0.1":"<p>Recommended update. Fixes shipping calculations, adds the cart neighborhood field, and improves the admin interface.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3515779,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3515779,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3515779,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3515779,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.7","1.0.8","1.0.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3594143,"resolution":"1","location":"assets","locale":"","width":1500,"height":1139},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3594143,"resolution":"2","location":"assets","locale":"","width":1500,"height":693},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3594143,"resolution":"3","location":"assets","locale":"","width":1500,"height":602},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3594143,"resolution":"4","location":"assets","locale":"","width":1500,"height":1450},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3594143,"resolution":"5","location":"assets","locale":"","width":1500,"height":1372},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3594143,"resolution":"6","location":"assets","locale":"","width":1500,"height":1103}},"screenshots":{"1":"Checkout page with Region, City, and Neighborhood dropdowns","2":"Cart shipping estimator with the neighborhood field","3":"Admin dashboard showing active countries and city counts","4":"Zones tab - expand a region to add or edit cities and neighborhoods","5":"Shipping method settings - default rate and per-area rules table"}},"plugin_section":[],"plugin_tags":[32976,35402,45117,3546,286],"plugin_category":[45],"plugin_contributors":[258827],"plugin_business_model":[],"class_list":["post-300181","plugin","type-plugin","status-publish","hentry","plugin_tags-africa","plugin_tags-cities","plugin_tags-neighborhoods","plugin_tags-shipping","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-woonet237","plugin_committers-woonet237"],"banners":{"banner":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/banner-772x250.png?rev=3515779","banner_2x":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/banner-1544x500.png?rev=3515779","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/icon-128x128.png?rev=3515779","icon_2x":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/icon-256x256.png?rev=3515779","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-1.png?rev=3594143","caption":"Checkout page with Region, City, and Neighborhood dropdowns"},{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-2.png?rev=3594143","caption":"Cart shipping estimator with the neighborhood field"},{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-3.png?rev=3594143","caption":"Admin dashboard showing active countries and city counts"},{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-4.png?rev=3594143","caption":"Zones tab - expand a region to add or edit cities and neighborhoods"},{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-5.png?rev=3594143","caption":"Shipping method settings - default rate and per-area rules table"},{"src":"https:\/\/ps.w.org\/afriregions-city-neighborhood-for-woocommerce\/assets\/screenshot-6.png?rev=3594143","caption":""}],"raw_content":"<!--section=description-->\n<p>AfriRegions replaces the basic city field at checkout with linked address selectors adapted for African cities. Your customers choose their region, then city, then neighborhood - no typing, no spelling mistakes, no wrong addresses.<\/p>\n\n<ul>\n<li><strong>Region \u2192 City \u2192 Neighborhood<\/strong> - linked dropdowns that update as the customer picks each level<\/li>\n<li><strong>Shipping rates by area<\/strong> - set one rate for the whole country, a different rate for a region, an even more precise rate for a specific city or neighborhood. The closest match always wins<\/li>\n<li><strong>Shipping estimate in the cart<\/strong> - customers check delivery costs before reaching checkout<\/li>\n<li><strong>Add your own places<\/strong> - add cities or neighborhoods not in the default list, directly from the admin<\/li>\n<li><strong>24 African countries<\/strong> with region and city data included - ready to use out of the box<\/li>\n<li><strong>Dashboard<\/strong> - see at a glance how many countries, regions, and cities are active<\/li>\n<li><strong>Available in English and French<\/strong><\/li>\n<\/ul>\n\n<h4>How it works<\/h4>\n\n<ol>\n<li>Activate the plugin and choose the countries you sell or ship to in WooCommerce<\/li>\n<li>Region, city, and neighborhood dropdowns appear at checkout automatically<\/li>\n<li>Set your shipping rates per area in WooCommerce \u2192 Shipping<\/li>\n<li>Optionally add custom places or tweak the checkout form<\/li>\n<\/ol>\n\n<h4>Supported countries<\/h4>\n\n<ul>\n<li>\ud83c\udde9\ud83c\uddff Algeria - 48 wilayas<\/li>\n<li>\ud83c\udde6\ud83c\uddf4 Angola - 18 provinces<\/li>\n<li>\ud83c\udde7\ud83c\uddef Benin - 12 departments<\/li>\n<li>\ud83c\udde7\ud83c\uddeb Burkina Faso - 13 regions<\/li>\n<li>\ud83c\udde8\ud83c\uddf2 Cameroon - 10 regions<\/li>\n<li>\ud83c\udde8\ud83c\uddee Cote d'Ivoire - 14 districts<\/li>\n<li>\ud83c\udde8\ud83c\udde9 DR Congo - 26 provinces<\/li>\n<li>\ud83c\uddea\ud83c\uddec Egypt - 27 governorates<\/li>\n<li>\ud83c\uddea\ud83c\uddf9 Ethiopia - 13 regions<\/li>\n<li>\ud83c\uddec\ud83c\udde6 Gabon - 9 provinces<\/li>\n<li>\ud83c\uddec\ud83c\udded Ghana - 16 regions<\/li>\n<li>\ud83c\uddf0\ud83c\uddea Kenya - 47 counties<\/li>\n<li>\ud83c\uddf2\ud83c\uddec Madagascar - 22 regions<\/li>\n<li>\ud83c\uddf2\ud83c\uddfa Mauritius - 10 districts<\/li>\n<li>\ud83c\uddf2\ud83c\udde6 Morocco - 12 regions<\/li>\n<li>\ud83c\uddf2\ud83c\uddff Mozambique - 11 provinces<\/li>\n<li>\ud83c\uddf3\ud83c\uddec Nigeria - 36 states + FCT<\/li>\n<li>\ud83c\uddf7\ud83c\uddfc Rwanda - 5 provinces<\/li>\n<li>\ud83c\uddf8\ud83c\uddf3 Senegal - 14 regions<\/li>\n<li>\ud83c\uddff\ud83c\udde6 South Africa - 9 provinces<\/li>\n<li>\ud83c\uddf8\ud83c\udde9 Sudan - 18 states<\/li>\n<li>\ud83c\uddf9\ud83c\uddff Tanzania - 31 regions<\/li>\n<li>\ud83c\uddf9\ud83c\uddf3 Tunisia - 24 governorates<\/li>\n<li>\ud83c\uddfa\ud83c\uddec Uganda - 4 regions<\/li>\n<\/ul>\n\n<p>24 countries, each with regions, cities, and neighborhoods for major urban areas.<\/p>\n\n<h3>Third-Party Libraries<\/h3>\n\n<p>This plugin bundles the following third-party JavaScript library:<\/p>\n\n<ul>\n<li><strong>Fuse.js v7.3.0<\/strong> - used for typo-tolerant address search in the checkout dropdowns.\n\n<ul>\n<li>Source: https:\/\/www.fusejs.io\/<\/li>\n<li>License: Apache License 2.0 (compatible with GPLv2 or later via GPLv3)<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to your WordPress plugins directory<\/li>\n<li>Activate via the WordPress Plugins menu<\/li>\n<li>Go to WooCommerce \u2192 Settings \u2192 General and add the countries you sell or ship to<\/li>\n<li>Go to WooCommerce \u2192 AfriRegions to view your dashboard and start setting up<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20add%20a%20city%20or%20neighborhood%20that%20is%20not%20in%20the%20list%3F\"><h3>How do I add a city or neighborhood that is not in the list?<\/h3><\/dt>\n<dd><p>Go to WooCommerce \u2192 AfriRegions \u2192 Zones. Expand a region to see its cities, then click \"Add a city\". Inside a city, click \"Add\" to add a neighborhood.<\/p><\/dd>\n<dt id=\"can%20i%20add%20many%20places%20at%20once%3F\"><h3>Can I add many places at once?<\/h3><\/dt>\n<dd><p>Places are added one at a time from the Zones tab. Most stores only need a handful of extra cities or neighborhoods, since 24 countries ship with their regions and cities already included.<\/p><\/dd>\n<dt id=\"how%20do%20i%20set%20different%20shipping%20prices%20per%20area%3F\"><h3>How do I set different shipping prices per area?<\/h3><\/dt>\n<dd><p>Go to WooCommerce \u2192 Shipping \u2192 select or create a shipping zone \u2192 add \"AfriRegions - Region \/ City \/ Neighborhood Rates\" as a method. Set a default price, then add specific rules for regions, cities, or neighborhoods. The most specific match always takes priority - a neighborhood rate overrides the city rate, which overrides the region rate.<\/p><\/dd>\n<dt id=\"how%20does%20the%20shipping%20estimator%20in%20the%20cart%20work%3F\"><h3>How does the shipping estimator in the cart work?<\/h3><\/dt>\n<dd><p>The cart estimator shows the neighborhood field once a city with neighborhoods is selected. As the customer picks their neighborhood, the shipping cost estimate updates on the spot.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20the%20new%20woocommerce%20order%20storage%20format%3F\"><h3>Does it work with the new WooCommerce order storage format?<\/h3><\/dt>\n<dd><p>Yes. The plugin works with both the classic and the new high-performance order storage.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20mobile%20apps%3F\"><h3>Does it work with mobile apps?<\/h3><\/dt>\n<dd><p>The address data endpoint (REST API) for mobile apps is available in AfriRegions Pro. It exposes the full country, region, city and neighborhood dataset for offline-first apps, with built-in protection against excessive requests.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>New: Apply the right tax to shipping - choose the tax status and class per method (tax-free by default, so existing stores are unaffected)<\/li>\n<li>Changed: Free shipping thresholds and the address data for mobile apps are now part of AfriRegions Pro<\/li>\n<li>Fixed: More accurate shipping prices - each order is charged for the exact neighborhood chosen, and rate changes take effect right away<\/li>\n<li>Fixed: A smoother checkout everywhere - including Ethiopia and Rwanda, stores that sell to several countries, and cases where the address fields used to fail to load<\/li>\n<li>Fixed: Managing cities and neighborhoods is more reliable - editing one no longer affects a same-named place in another region, and address data is now complete for Angola, Ethiopia, Mozambique, Sudan and Uganda<\/li>\n<li>Fixed: Your shipping rules are safer - they can no longer be lost while saving a zone, and every change is clearly reported<\/li>\n<li>Fixed: A more polished order - phone numbers are saved in international format<\/li>\n<li>Fixed: Cleaner display - addresses with apostrophes look right, the recipient's name shows before the city, and admin confirmations no longer overlap your settings<\/li>\n<li>Fixed: A tidier admin - the Zones country filter works, notices stay dismissed, the menu is keyboard-friendly, and dashboard counts update instantly<\/li>\n<li>Fixed: The plugin now displays fully in French<\/li>\n<li>Improved: Shipping methods are clearly labelled \"AfriRegions\", and every address is double-checked before an order is placed<\/li>\n<li>Removed: The delivery notes field introduced in 1.0.0<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Fixed: City and neighborhood fields no longer stay disabled when the page loads with a pre-selected region or city<\/li>\n<li>Fixed: Selecting a saved address no longer triggers a checkout refresh loop<\/li>\n<li>Improved: Shipping method settings - more compact layout with reduced spacing between fields<\/li>\n<li>Improved: Shipping method settings page is easier to use on mobile screens<\/li>\n<li>Improved: The \"How does it work?\" help panel now mentions the \"Hide if no rule matches\" option<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Improved: Admin redesigned with a two-column layout - the navigation is now a vertical sidebar, always visible while scrolling<\/li>\n<li>Improved: \"Geo Data\" tab renamed to \"Zones\" for clarity<\/li>\n<li>Improved: The sidebar footer shows Documentation and Support links and the current version number<\/li>\n<li>Improved: Address data loads faster after the first visit<\/li>\n<li>Improved: Address search is significantly faster<\/li>\n<li>New: 5 new countries added - Angola, Ethiopia, Mozambique, Sudan, and Uganda (24 countries total)<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>New: Upgrade to Pro directly from the plugin<\/li>\n<li>Fixed: Shipping rule highlight animation now replays correctly when the same rule is edited more than once<\/li>\n<li>Improved: Keyboard navigation for region and city lists (Enter and Space keys)<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Fixed: Address search at checkout was included but not working - now fixed<\/li>\n<li>Fixed: The upgrade page now correctly describes what is free and what requires Pro<\/li>\n<li>Improved: Plugin language files load automatically on WordPress 6.7 and later<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>New: \"Hide if no rule matches\" option - hides the shipping method when no rate applies instead of showing the default price<\/li>\n<li>Improved: Address search now works without accents - typing \"yaounde\" correctly finds \"Yaound\u00e9\"<\/li>\n<li>Improved: Very short search terms no longer return unrelated results<\/li>\n<li>Fixed: Shipping cost details no longer appear as unreadable text in the admin order view<\/li>\n<li>Updated: French translations improved<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fixed: A crash that could occur when the free shipping amount was set to zero<\/li>\n<li>Fixed: Shipping label prices now display correctly<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Improved: Address fields load more reliably on slow mobile connections<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>New: Neighborhood field added to the cart shipping estimator for accurate rate checks before checkout<\/li>\n<li>New: Shipping rates refresh automatically when the neighborhood changes<\/li>\n<li>New: Setup guide on the dashboard with a progress checklist<\/li>\n<li>New: Statistics leaderboard with sorting and search<\/li>\n<li>Improved: The shipping rules editor highlights areas already in use to prevent duplicates<\/li>\n<li>Improved: Admin pages redesigned to match the standard WordPress style<\/li>\n<li>Fixed: A neighborhood saved in the cart no longer overrides an empty selection at checkout<\/li>\n<li>Fixed: Shipping rates now recalculate correctly when only the neighborhood changes<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>19 African countries supported<\/li>\n<li>Region, city, and neighborhood dropdowns at checkout<\/li>\n<li>Shipping rates per region, city, or neighborhood<\/li>\n<li>Address consistency check at checkout<\/li>\n<li>Delivery notes field<\/li>\n<li>Admin dashboard with order statistics<\/li>\n<li>Address data endpoint for mobile apps<\/li>\n<li>Available in English and French<\/li>\n<\/ul>","raw_excerpt":"Replace the plain city text box at checkout with smart address dropdowns for 24 African countries - and charge the right shipping price for every neig &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/300181","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=300181"}],"author":[{"embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/woonet237"}],"wp:attachment":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=300181"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=300181"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=300181"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=300181"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=300181"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=300181"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}