AfriRegions City & Neighborhood for WooCommerce
| 开发者 | woonet237 |
|---|---|
| 更新时间 | 2026年4月28日 22:41 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Documentation: https://afriregions.com/docs/
AfriRegions City & Neighborhood for WooCommerce adds structured geographic address fields to WooCommerce checkout, cart, and My Account pages:
- Cascading dropdowns: Region → City → Neighborhood (with Select2 search)
- Zone-based shipping rates with cascading priority: Neighborhood > City > Region > Default
- Cart shipping calculator with neighborhood field for accurate rate estimation
- Multi-country support : data filtered by WooCommerce allowed countries
- Address validation : verify region/city/neighborhood consistency at checkout
- Delivery restrictions : block orders from specific regions or cities
- Landmark field : optional "Landmark / Directions" for precise delivery instructions
- Admin dashboard with setup guide and quick actions
- Statistics : order breakdown by region and city with sortable leaderboard
- Anti-duplicate shipping rules : visual indicators prevent assigning the same zone twice
- REST API with rate limiting and pagination for mobile apps
- HPOS compatible (Custom Orders Table)
- Multilingual ready (English default, French included)
- Activate the plugin and add a supported African country to your WooCommerce settings
- Regions, cities, and neighborhoods are automatically available at checkout
- Configure zone-based shipping rates in WooCommerce Shipping settings
- Optionally add custom cities/neighborhoods via the Geo Data admin tab
- Optionally restrict delivery to specific zones
- 🇩🇿 Algeria (DZ) — 48 wilayas
- 🇧🇯 Benin (BJ) — 12 departments
- 🇧🇫 Burkina Faso (BF) — 13 regions
- 🇨🇲 Cameroon (CM) — 10 regions
- 🇨🇮 Cote d'Ivoire (CI) — 14 districts
- 🇨🇩 DR Congo (CD) — 26 provinces
- 🇪🇬 Egypt (EG) — 27 governorates
- 🇬🇦 Gabon (GA) — 9 provinces
- 🇬🇭 Ghana (GH) — 16 regions
- 🇰🇪 Kenya (KE) — 47 counties
- 🇲🇬 Madagascar (MG) — 22 regions
- 🇲🇺 Mauritius (MU) — 10 districts
- 🇲🇦 Morocco (MA) — 12 regions
- 🇳🇬 Nigeria (NG) — 36 states + FCT
- 🇷🇼 Rwanda (RW) — 5 provinces
- 🇸🇳 Senegal (SN) — 14 regions
- 🇿🇦 South Africa (ZA) — 9 provinces
- 🇹🇿 Tanzania (TZ) — 31 regions
- 🇹🇳 Tunisia (TN) — 24 governorates
安装:
- Upload the plugin folder to
/wp-content/plugins/ - Activate via the WordPress Plugins menu
- Add your target countries to WooCommerce Settings → General → Selling/Shipping locations
- Go to WooCommerce → AfriRegions to configure
屏幕截图:
常见问题:
How to add custom cities or neighborhoods?
Go to WooCommerce → AfriRegions → Geo Data tab. Expand a region, then use the "Add a city" or "Add" button for neighborhoods. You can also use the scpwoo_custom_places_{cc} filter (e.g. scpwoo_custom_places_cm for Cameroon).
How to set shipping rates by zone?
Go to WooCommerce → Shipping → your zone → add "Zone Shipping" method. Configure a default rate, then add rules by region, city, or neighborhood. The most specific rule wins (Neighborhood > City > Region > Default).
How to restrict delivery to certain zones?
Go to WooCommerce → AfriRegions → Restrictions tab. Enable restrictions, then check the regions or cities you want to block.
Does it work with the cart shipping calculator?
Yes. The neighborhood field appears in the cart shipping calculator when a city with neighborhoods is selected. Shipping rates update in real-time.
Is it compatible with HPOS (Custom Orders Table)?
Yes. The plugin fully supports both HPOS and classic post-based orders.
Does the REST API expose my data publicly?
The REST API is enabled by default and exposes geographic data (regions, cities, neighborhoods) bundled in the plugin. Rate limiting (120 requests/minute per IP) protects against abuse. The data itself is not sensitive — it is the same public geographic data available at checkout.
更新日志:
1.0.6
- New: Upgrade to Pro directly from the plugin — licence management and opt-in usage analytics via Freemius
- Fixed: Shipping rule highlight animation now replays correctly when the same rule is edited multiple times
- Improved: Keyboard navigation for sortable table columns and region/city accordion (Enter and Space keys)
- Fixed: Typo-tolerant search now works correctly at checkout — it was included but not properly activated
- Fixed: The upgrade page now accurately describes what is available for free and what requires the Pro version
- Improved: Plugin translations load automatically on WordPress 6.7 and later
- New: "Hide if no rule matches" option — hides the shipping method when no rate applies, instead of showing a default price
- Improved: Address dropdowns now work without accents — typing "yaounde" correctly finds "Yaoundé"
- Improved: Typo-tolerant search now requires at least 4 characters to avoid unrelated results
- Fixed: Shipping cost details no longer appear as unreadable text in the admin order view
- Updated: French translations improved
- Fixed: A crash that could occur when the free shipping threshold was set to zero
- Fixed: Shipping label prices now display correctly
- Improved: Address fields load more reliably on slow mobile connections
- New: Neighborhood field added to the cart shipping calculator for accurate rate estimates 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, search, and medals
- Improved: Shipping rules editor highlights zones already in use to prevent duplicates
- Improved: Admin pages redesigned to match the standard WordPress look and feel
- Fixed: Neighborhood saved in the cart no longer overrides an empty selection at checkout
- Fixed: Shipping rates now recalculate correctly when only the neighborhood changes
- Initial release
- 19 African countries supported
- Cascading address fields: Region → City → Neighborhood
- Zone-based shipping with rates per region, city, or neighborhood
- Address validation at checkout
- Landmark and directions field
- Delivery zone restrictions
- Admin dashboard with order statistics
- REST API for mobile app integration
- Compatible with WooCommerce High-Performance Order Storage (HPOS)
- Available in English and French