AfriRegions City & Neighborhood for WooCommerce

Description

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)

How it works

1. Activate the plugin and add a supported African country to your WooCommerce settings
2. Regions, cities, and neighborhoods are automatically available at checkout
3. Configure zone-based shipping rates in WooCommerce Shipping settings
4. Optionally add custom cities/neighborhoods via the Geo Data admin tab
5. Optionally restrict delivery to specific zones

Supported countries

• 🇩🇿 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

Each country includes regions, cities, and neighborhoods for major urban areas.

External Services

All geographic data (regions, cities, neighborhoods) is bundled locally within the plugin. No external API calls are made for checkout functionality.

The optional REST API exposes local geographic data (regions, cities, neighborhoods) via WordPress REST endpoints (/wp-json/scpwoo/v1/).

This plugin uses Freemius to manage licences, upgrades, and optional usage analytics. When the site administrator opts in, diagnostic data (WordPress version, PHP version, active plugins) and the administrator’s email address are sent to Freemius servers at https://freemius.com. No data is collected without explicit opt-in. Opting out is available at any time from the plugin’s account screen.

• Freemius Privacy Policy: https://freemius.com/privacy/
• Freemius Terms of Service: https://freemius.com/terms/

Third-Party Libraries

This plugin bundles the following third-party JavaScript library:

• Fuse.js v7.3.0 — Lightweight fuzzy-search library used for typo-tolerant matching in checkout dropdowns.
  • Source: https://www.fusejs.io/
  • License: Apache License 2.0 (compatible with GPLv2 or later via GPLv3)