Documentation

Comment Utiliser AfriRegions

Guide étape par étape pour installer, configurer et tirer le meilleur parti du plugin.

Installation

Prérequis
WordPress 5.8+WooCommerce 6.0+PHP 7.4+
  1. 1Téléchargez le plugin dans /wp-content/plugins/ ou installez depuis WordPress.org
  2. 2Activez via le menu Extensions
  3. 3Allez dans WooCommerce → Réglages → Général et ajoutez vos pays africains aux zones de vente/expédition
  4. 4Naviguez vers WooCommerce → AfriRegions pour configurer

Expédition par Zone

Définissez des tarifs d'expédition différents pour chaque région, ville ou quartier. La règle la plus spécifique l'emporte toujours.

  1. 1Allez dans WooCommerce → Expédition → Créer ou modifier une zone d'expédition
  2. 2Cliquez Ajouter une Méthode → sélectionnez Expédition par Zone
  3. 3Définissez un prix Par défaut (tarif de repli)
  4. 4Ajoutez des règles pour des régions, villes ou quartiers spécifiques
  5. 5Définissez optionnellement un seuil de Livraison Gratuite
  6. 6Ajoutez des Paliers d'Expédition (Pro) pour les options Express / Même Jour avec surcharges
Shipping Rate
Default5,000 FCFA
Centre (Region)4,000 FCFA
Yaoundé (City)2,500 FCFA
Bastos (Neighborhood)1,500 FCFA
Most specific rule wins

Validation d'Adresse

Vérifie automatiquement que le quartier sélectionné appartient à la ville choisie. Bloque le paiement en cas d'incohérence — empêchant les mauvaises livraisons avant qu'elles ne se produisent.

Address validated
Neighborhood doesn't match city

Restrictions de Livraison

Bloquez les commandes de régions ou villes que vous ne desservez pas encore. Les clients voient un message personnalisé comme « Nous nous étendons bientôt à votre zone ! »

  1. 1Allez dans WooCommerce → AfriRegions → Restrictions
  2. 2Activez l'option Activer les Restrictions
  3. 3Définissez votre message de blocage personnalisé
  4. 4Cochez des régions entières ou des villes individuelles à bloquer
  5. 5Enregistrez — les zones bloquées sont appliquées au paiement
Delivery Zones
Centreavailable
Littoralblocked
Ouestavailable
Extrême-Nordblocked

Gestionnaire de Données Géo

Ajoutez, modifiez ou supprimez des villes et quartiers pour n'importe quelle région. Tous les changements se font via AJAX — sans rechargement de page.

  1. 1Allez dans WooCommerce → AfriRegions → Données Géo
  2. 2Utilisez la barre de recherche pour trouver une région
  3. 3Développez une région pour voir ses villes
  4. 4Cliquez « Ajouter une ville » et saisissez le nom
  5. 5Développez une ville pour voir les quartiers, cliquez « Ajouter » pour en créer de nouveaux
  6. 6Supprimez des villes ou quartiers avec le bouton X

Recherche Intelligente

Pro

Les clients tapent un nom de quartier et tous les champs d'adresse se remplissent automatiquement. La correspondance floue tolère les fautes — taper « Bsatos » trouve quand même « Bastos ».

  1. 1Allez dans Paramètres → activez la Recherche Intelligente
  2. 2Personnalisez les couleurs dans Apparence Recherche Intelligente (optionnel)
  3. 3Au paiement, un champ de recherche apparaît au-dessus des menus déroulants
  4. 4Le client tape un nom → les résultats affichent quartiers, villes, régions
  5. 5Sélectionner un résultat remplit automatiquement Région, Ville et Quartier
  6. 6Les 5 dernières sélections sont mémorisées pour les clients réguliers
Bast...|
Bastos
Yaoundé, Centre
Bastos
Douala, Littoral

Points Relais

Pro

Permettez aux clients de récupérer leurs commandes dans des points relais, boutiques partenaires ou agences. Les points sont automatiquement filtrés par la ville du client.

  1. 1Allez dans WooCommerce → Expédition → Ajouter une Méthode → Point Relais
  2. 2Ajoutez des points de retrait avec nom, adresse, ville, téléphone et horaires
  3. 3Au paiement, les clients ne voient que les points de leur ville
  4. 4Si aucun dans leur ville, les points de leur région sont affichés
  5. 5Le point sélectionné est enregistré avec la commande pour le traitement
Select Pickup Point
Express Store Bastos
Rue 1.754, Yaoundé
Relay Point Mokolo
Marché Mokolo, Yaoundé

Expédition par Agence de Voyage

Pro

Livraison interurbaine via agences de voyage et compagnies de bus — un modèle de livraison courant au Cameroun, Sénégal, Côte d'Ivoire et plus. Tarification par itinéraire avec sélection d'agence.

  1. 1Allez dans WooCommerce → Expédition → Ajouter une Méthode → Agence de Voyage
  2. 2Définissez les agences (nom, adresse, téléphone, horaires)
  3. 3Définissez les prix par itinéraire : Par défaut → Région → Ville (le plus spécifique l'emporte)
  4. 4Au paiement, le client sélectionne son agence préférée
  5. 5Le prix est basé sur l'itinéraire, pas l'agence — l'agence est le lieu de retrait

Champ Repère

Ajoute un champ texte optionnel « Comment me trouver » au paiement. Les clients décrivent les repères près de leur adresse — essentiel dans les zones sans noms de rues formels.

Example:

« En face de la station Total, bâtiment bleu, 2e étage »

Statistiques & Journal d'Activité

Suivez les commandes par région et ville avec classements par chiffre d'affaires, filtres par date et répartition géographique. Le Journal d'Activité enregistre chaque changement — qui a ajouté une ville, qui a supprimé un quartier, avec horodatages.

API REST

Pro

Accédez aux données géographiques par programmation via /wp-json/scpwoo/v1/. Limité à 120 req/min, protégé par CORS, activable dans les Paramètres.

GET /wp-json/scpwoo/v1/regions
GET /wp-json/scpwoo/v1/regions/{code}
GET /wp-json/scpwoo/v1/cities
GET /wp-json/scpwoo/v1/cities/{name}
GET /wp-json/scpwoo/v1/neighborhoods
GET /wp-json/scpwoo/v1/neighborhoods/{city}
GET /wp-json/scpwoo/v1/search?q=query