Açıklama
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.
- Region City Neighborhood – linked dropdowns that update as the customer picks each level
- Shipping rates by area – 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
- Shipping estimate in the cart – customers check delivery costs before reaching checkout
- Add your own places – add cities or neighborhoods not in the default list, directly from the admin
- 24 African countries with region and city data included – ready to use out of the box
- Dashboard – see at a glance how many countries, regions, and cities are active
- Available in English and French
How it works
- Activate the plugin and choose the countries you sell or ship to in WooCommerce
- Region, city, and neighborhood dropdowns appear at checkout automatically
- Set your shipping rates per area in WooCommerce Shipping
- Optionally add custom places or tweak the checkout form
Supported countries
- 🇩🇿 Algeria – 48 wilayas
- 🇦🇴 Angola – 18 provinces
- 🇧🇯 Benin – 12 departments
- 🇧🇫 Burkina Faso – 13 regions
- 🇨🇲 Cameroon – 10 regions
- 🇨🇮 Cote d’Ivoire – 14 districts
- 🇨🇩 DR Congo – 26 provinces
- 🇪🇬 Egypt – 27 governorates
- 🇪🇹 Ethiopia – 13 regions
- 🇬🇦 Gabon – 9 provinces
- 🇬🇭 Ghana – 16 regions
- 🇰🇪 Kenya – 47 counties
- 🇲🇬 Madagascar – 22 regions
- 🇲🇺 Mauritius – 10 districts
- 🇲🇦 Morocco – 12 regions
- 🇲🇿 Mozambique – 11 provinces
- 🇳🇬 Nigeria – 36 states + FCT
- 🇷🇼 Rwanda – 5 provinces
- 🇸🇳 Senegal – 14 regions
- 🇿🇦 South Africa – 9 provinces
- 🇸🇩 Sudan – 18 states
- 🇹🇿 Tanzania – 31 regions
- 🇹🇳 Tunisia – 24 governorates
- 🇺🇬 Uganda – 4 regions
24 countries, each with regions, cities, and neighborhoods for major urban areas.
Third-Party Libraries
This plugin bundles the following third-party JavaScript library:
- Fuse.js v7.3.0 – used for typo-tolerant address search in the checkout dropdowns.
- Source: https://www.fusejs.io/
- License: Apache License 2.0 (compatible with GPLv2 or later via GPLv3)
Ekran Görüntüleri
Yükleme
- Upload the plugin folder to your WordPress plugins directory
- Activate via the WordPress Plugins menu
- Go to WooCommerce Settings General and add the countries you sell or ship to
- Go to WooCommerce AfriRegions to view your dashboard and start setting up
SSS
-
How do I add a city or neighborhood that is not in the list?
-
Go to WooCommerce AfriRegions Zones. Expand a region to see its cities, then click “Add a city”. Inside a city, click “Add” to add a neighborhood.
-
Can I add many places at once?
-
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.
-
How do I set different shipping prices per area?
-
Go to WooCommerce Shipping select or create a shipping zone 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.
-
How does the shipping estimator in the cart work?
-
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.
-
Does it work with the new WooCommerce order storage format?
-
Yes. The plugin works with both the classic and the new high-performance order storage.
-
Does it work with mobile apps?
-
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.
İncelemeler
Bu eklenti için herhangi bir değerlendirme bulunmuyor.
Katkıda Bulunanlar ve Geliştiriciler
“AfriRegions City & Neighborhood for WooCommerce” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye katkıda bulunmuşlardır.
Katkıda bulunanlar
“AfriRegions City & Neighborhood for WooCommerce” eklentisini dilinize çevirin.
Geliştirmeyle ilgilenir misiniz?
Kodu görüntüleyin, SVN deposuna göz atın ya da RSS ile geliştirme günlüğüne abone olun.
Değişiklik Kaydı
1.0.9
- New: Apply the right tax to shipping – choose the tax status and class per method (tax-free by default, so existing stores are unaffected)
- Changed: Free shipping thresholds and the address data for mobile apps are now part of AfriRegions Pro
- Fixed: More accurate shipping prices – each order is charged for the exact neighborhood chosen, and rate changes take effect right away
- 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
- 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
- Fixed: Your shipping rules are safer – they can no longer be lost while saving a zone, and every change is clearly reported
- Fixed: A more polished order – phone numbers are saved in international format
- Fixed: Cleaner display – addresses with apostrophes look right, the recipient’s name shows before the city, and admin confirmations no longer overlap your settings
- Fixed: A tidier admin – the Zones country filter works, notices stay dismissed, the menu is keyboard-friendly, and dashboard counts update instantly
- Fixed: The plugin now displays fully in French
- Improved: Shipping methods are clearly labelled “AfriRegions”, and every address is double-checked before an order is placed
- Removed: The delivery notes field introduced in 1.0.0
1.0.8
- Fixed: City and neighborhood fields no longer stay disabled when the page loads with a pre-selected region or city
- Fixed: Selecting a saved address no longer triggers a checkout refresh loop
- Improved: Shipping method settings – more compact layout with reduced spacing between fields
- Improved: Shipping method settings page is easier to use on mobile screens
- Improved: The “How does it work?” help panel now mentions the “Hide if no rule matches” option
1.0.7
- Improved: Admin redesigned with a two-column layout – the navigation is now a vertical sidebar, always visible while scrolling
- Improved: “Geo Data” tab renamed to “Zones” for clarity
- Improved: The sidebar footer shows Documentation and Support links and the current version number
- Improved: Address data loads faster after the first visit
- Improved: Address search is significantly faster
- New: 5 new countries added – Angola, Ethiopia, Mozambique, Sudan, and Uganda (24 countries total)
1.0.6
- New: Upgrade to Pro directly from the plugin
- Fixed: Shipping rule highlight animation now replays correctly when the same rule is edited more than once
- Improved: Keyboard navigation for region and city lists (Enter and Space keys)
1.0.5
- Fixed: Address search at checkout was included but not working – now fixed
- Fixed: The upgrade page now correctly describes what is free and what requires Pro
- Improved: Plugin language files load automatically on WordPress 6.7 and later
1.0.4
- New: “Hide if no rule matches” option – hides the shipping method when no rate applies instead of showing the default price
- Improved: Address search now works without accents – typing “yaounde” correctly finds “Yaoundé”
- Improved: Very short search terms no longer return unrelated results
- Fixed: Shipping cost details no longer appear as unreadable text in the admin order view
- Updated: French translations improved
1.0.3
- Fixed: A crash that could occur when the free shipping amount was set to zero
- Fixed: Shipping label prices now display correctly
1.0.2
- Improved: Address fields load more reliably on slow mobile connections
1.0.1
- New: Neighborhood field added to the cart shipping estimator for accurate rate checks before checkout
- New: Shipping rates refresh automatically when the neighborhood changes
- New: Setup guide on the dashboard with a progress checklist
- New: Statistics leaderboard with sorting and search
- Improved: The shipping rules editor highlights areas already in use to prevent duplicates
- Improved: Admin pages redesigned to match the standard WordPress style
- Fixed: A neighborhood saved in the cart no longer overrides an empty selection at checkout
- Fixed: Shipping rates now recalculate correctly when only the neighborhood changes
1.0.0
- Initial release
- 19 African countries supported
- Region, city, and neighborhood dropdowns at checkout
- Shipping rates per region, city, or neighborhood
- Address consistency check at checkout
- Delivery notes field
- Admin dashboard with order statistics
- Address data endpoint for mobile apps
- Available in English and French