Chaque réglage expliqué, de l'installation à l'API mobile, dans l'ordre où il faut les configurer.
PrérequisWordPress 5.8+ · WooCommerce 6.0+ · PHP 7.4+
AfriRegions ne s'active que pour les pays où vous vendez réellement, et c'est WooCommerce qui décide de cette liste. Réglez-la avant tout le reste.
Le plugin embarque 24 pays mais n'active que ceux que vous avez autorisés ici. Une règle configurée pour un pays absent de cette liste ne se chargera jamais : ajoutez d'abord le pays, puis revenez configurer vos règles.
Au paiement, là où WooCommerce demande normalement la ville, votre client voit apparaître des listes liées : il sélectionne sa région, les villes de cette région apparaissent ; il choisit sa ville, les quartiers apparaissent. Rien ne se tape à la main.
WooCommerce → AfriRegions → Zones affiche l'arborescence de vos données géographiques : pour chaque pays ses régions, pour chaque région ses villes, pour chaque ville ses quartiers. Servez-vous-en pour vérifier ce qui existe et compléter ce qui manque.
Une pastille indique si un lieu est d'origine (livré avec le plugin) ou personnalisé (ajouté par vous).
WooCommerce → AfriRegions → Checkout vous laisse remodeler le formulaire que votre client remplit au moment de payer : l'ordre des champs, leurs libellés, lesquels sont visibles, lesquels sont obligatoires.
La colonne « Layout » indique si le champ s'affiche en pleine largeur ou en demi-largeur (deux champs côte à côte, comme Prénom + Nom quand les deux sont visibles) : c'est automatique. Les champs Ville, Région et Quartier d'AfriRegions sont regroupés à part : ils sont toujours présents au paiement et ne peuvent pas être masqués, mais vous pouvez personnaliser leur libellé, par exemple « Arrondissement » à la place de « Quartier ».
Les tarifs ne se règlent pas dans le menu AfriRegions, mais là où WooCommerce gère l'expédition. Ajoutez la méthode « AfriRegions - Tarifs région / ville / quartier » à une zone d'expédition, puis construisez vos règles.
La règle la plus précise l'emporte : un tarif quartier bat un tarif ville, qui bat un tarif région, qui bat le prix par défaut. Le statut fiscal et la classe de taxe sont sur « Non taxable » par défaut, ne les changez que si vous êtes assujetti à la TVA sur les frais de port. Rappelez-vous qu'une zone d'expédition WooCommerce doit couvrir le pays visé par vos règles, sinon elles ne se déclencheront jamais.
Laissez le client venir chercher sa commande au lieu de se la faire livrer. Moins d'échecs de livraison à domicile, moins de retours.
Le retrait est gratuit. Le point choisi apparaît ensuite sur la confirmation de commande, dans l'e-mail et dans le compte du client, pour qu'il sache toujours où récupérer son colis.
La livraison interurbaine via les agences de bus et de voyage, comme les colis circulent couramment au Cameroun, en Côte d'Ivoire et au Sénégal. Vous fixez le prix du trajet, le client récupère son colis à l'agence de destination.
Priorité : ville, puis région, puis prix par défaut. Un trajet ne s'affiche au paiement que s'il existe au moins une agence pour le desservir, et l'éditeur vous prévient si vous créez un trajet sans agence dans sa zone. L'agence choisie apparaît sur la confirmation de commande, dans l'e-mail et dans le compte du client.
Le plugin vérifie que ce que le client a choisi est cohérent : que la ville appartient bien à la région, et que le quartier appartient bien à la ville. Une adresse incohérente est signalée avant la validation de la commande, avec un message clair et non technique.
WooCommerce → AfriRegions → Developer regroupe les deux réglages destinés aux intégrations avancées. Les deux sont éteints par défaut, et les deux demandent de cliquer sur Enregistrer.
Activez le champ téléphone dès que vos livreurs ont besoin d'appeler vos clients, c'est-à-dire presque toujours.
https://your-store.com/wp-json/scpwoo/v1/Toutes les routes sont publiques, en lecture seule (GET) et renvoient du JSON. Aucune authentification n'est nécessaire puisque les données géographiques sont publiques. Les données sont filtrées sur les pays que votre boutique vend et expédie, et un débit maximum de 120 requêtes par minute protège le serveur : au-delà, réponse 429 avec un en-tête Retry-After.
| Route | Ce qu'elle renvoie |
|---|---|
GET /snapshot | Tout le jeu de données en un seul appel, la méthode recommandée pour les apps offline-first. |
GET /version | Un jeton de version des données, pour savoir quand resynchroniser. |
GET /countries | Les pays pris en charge, avec leur nombre de régions et de villes. |
GET /regions | Toutes les régions (paginé : page, per_page). |
GET /regions/{code} | Une région (code à 2 lettres) et ses villes. |
GET /cities | Toutes les villes. Filtrable avec ?region={code}. |
GET /cities/{name} | Une ville et ses quartiers. |
GET /neighborhoods | Tous les quartiers. Filtrable avec ?city={name}. |
GET /neighborhoods/{city} | Les quartiers d'une ville. |
GET /search?q= | Recherche insensible aux accents sur tous les niveaux (per_page). |
# Le jeton de version (quelques octets)
curl https://votre-boutique.com/wp-json/scpwoo/v1/version
# → {"version":"2.1.0.1784842422","generated_at":"2026-07-23T22:07:11+00:00"}
# Les pays pris en charge
curl https://votre-boutique.com/wp-json/scpwoo/v1/countries
# → [{"code":"CM","name":"Cameroun","region_count":10,"city_count":152}]
# Tout, en un appel
curl https://votre-boutique.com/wp-json/scpwoo/v1/snapshotL'offline-first est la méthode recommandée : appelez /snapshot une seule fois au premier lancement et stockez le résultat sur le téléphone, puis lisez tout en local pour que le choix pays → région → ville → quartier soit instantané et fonctionne hors connexion. Vérifiez de temps en temps avec /version, ou mieux, avec les en-têtes HTTP standard ETag / If-None-Match, qui renvoient 304 Not Modified sans corps tant que rien n'a changé.
L'API AfriRegions ne calcule pas les tarifs de livraison, ce n'est pas son rôle. Les vrais prix viennent de la Store API native de WooCommerce sur /wp-json/wc/store/v1/, qui inclut automatiquement vos méthodes AfriRegions. Vous construisez un panier, vous y posez une adresse, et WooCommerce renvoie les méthodes disponibles et leurs prix calculés. AfriRegions remplit l'adresse, WooCommerce calcule la livraison, votre app affiche les deux.
curl -X POST https://votre-boutique.com/wp-json/wc/store/v1/cart/update-customer \
-H "Content-Type: application/json" \
-H "Cart-Token: <le_token>" \
-H "Nonce: <le_nonce>" \
-d '{
"shipping_address": {
"country": "CM",
"state": "LT",
"city": "Douala",
"address_1": "Rue 123",
"scpwoo/neighborhood": "Bonapriso"
}
}'La Store API connaît nativement le pays, la région et la ville, mais pas le quartier, qui est propre à AfriRegions. Envoyez-le sous scpwoo/neighborhood et votre app obtient le tarif quartier, exactement comme au checkout du site. Sans ce champ, vous n'obtenez que les tarifs ville et région. Ce pont demande WooCommerce 8.9 ou plus récent. Ne réimplémentez jamais le calcul dans l'app : le serveur calcule, l'app affiche, et toute règle modifiée en admin s'applique instantanément au site comme à l'app.
"scpwoo/neighborhood": "Bonapriso"