Описание
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)
Скриншоты
Установка
- 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
Часто задаваемые вопросы
-
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.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«AfriRegions City & Neighborhood for WooCommerce» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
«AfriRegions City & Neighborhood for WooCommerce» переведён на 1 язык. Благодарим переводчиков за их работу.
Перевести «AfriRegions City & Neighborhood for WooCommerce» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
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