Documentation Mana Zone

Guides et instructions détaillées pour configurer et utiliser Mana Zone sur votre Wi-Fi Zone

Configuration rapide
Guides détaillés
Support expert
Templates prêts
Commencer la configuration Télécharger les templates

Table des matières

Introduction à Mana Zone

Bienvenue dans la documentation de Mana Zone. Ce guide vous accompagnera étape par étape dans la configuration du système de payement automatique de ticket de wifi zone appelé Mana zone

Pour une configuration réussie, nous vous recommandons de suivre les étapes dans l'ordre présenté. Chaque section est identifiée par une couleur distincte pour faciliter la navigation :

  • Bleu - Configuration du routeur
  • Vert - Configuration du portail captif
  • Orange - Interface d'administration

Avant de commencer, assurez-vous d'avoir :

  • Un compte Mana zone sinon créer en un ici
  • Un routeur avec Mikrotik
  • Une connexion Internet stable

Conseil

Si vous rencontrez des difficultés pendant la configuration, n'hésitez pas à contacter notre équipe de support technique ici

Ajout du serveur RADIUS

Étapes pour configurer les paramètres initiaux de votre routeur

1

Accéder à l'interface d'administration de votre miktotik

Connectez-vous à l'interface d'administration de votre routeur en saisissant l'adresse IP du routeur dans votre navigateur web (généralement 192.168.1.1 ou 192.168.0.1).

Utilisez les identifiants administrateur par défaut (souvent "admin" / "admin" ou "admin" / "password") ou vos identifiants personnalisés si vous les avez déjà modifiés.

2

Accédez à la section RADIUS, puis ajoutez un nouveau serveur avec les paramètres suivants

  • Incoming : coché
  • IP : 100.42.177.30
  • Mot de passe : pari1999
  • Timeout : 3500
  • Authentication Port : 1814
  • Accounting Port : 1815
  • Service : cochez "Hotspot"

Attention

Si un serveur RADIUS est déjà configuré avec l'IP 127.0.0.1, veuillez le supprimer, car il n'est pas utilisé.

Attention

L'IP, le mot de passe, ainsi que les ports d'authentification et d'accounting ne sont pas définitifs et sont précisez dans le menu configuration du site lié au routeur au niveau de votre page d'administration.

3

Configurer Hotspot pour utiliser RADIUS

Accédez à Hotspot > Server Profiles :

  • Cochez "Use RADIUS"
  • Réglez "Interim Update" à 00:00:05
4

Ajout de Walled Garden IP

Dans Hotspot > Walled Garden IP List, ajoutez les hôtes suivants (action = accept, server = nom du hotspot) :

  • client.ligdicash.com
  • wifizone.web-ack.com
  • gounspay.com
  • mana-zone.app

Configuration du portail captif

Intégration des liens de payement à votre portail

1

Ajout du script JS au portail captif

Ajoutez le script suivant dans le <head> de votre page "login.html"

<script type="text/javascript">
function getQueryParam(variable) {
  var query = window.location.search.substring(1);
  var vars = query.split("&");
  for (var i = 0; i < vars.length; i++) {
    var pair = vars[i].split("=");
    if (pair[0] === variable) return pair[1];
  }
  return false;
}
function init() {
  var usernameValue = getQueryParam("username");
  var passwordValue = getQueryParam("password");
  if (usernameValue && passwordValue) {
    document.login.username.value = usernameValue;
    document.login.password.value = passwordValue;
    document.login.submit();
  }
}
</script>

Ajoutez onload="init()" dans la balise <body>.

3

Mode Voucher : modification du script

Pour les sites de type "voucher", remplacez dans la fonction java Scriptinit() ça:

document.login.password.value = passwordValue;

par :

document.login.password.value = """;

et modifiez la fonction setpass() :

function setpass() {
  var user = username.value;
  if (user.startsWith("Bi") || user.startsWith("Ci")) {
    password.value = "";
  } else {
    password.value = user;
  }
}

Créer et configurer un site

Créez et configurez un site à partir de votre compte

1

C'est quoi un site

Un site Mana Zone est une entité virtuelle correspondant à un point d’accès Wi-Fi (généralement un routeur Mikrotik) géré via la plateforme Mana Zone. Ce site permet de

  • Vendre des tickets de connexion Wi-Fi en ligne ou physiquement.
  • Associer un portail captif (page de connexion personnalisée) pour gérer l’accès au Wi-Fi.
  • Suivre les statistiques de connexion et les ventes de tickets.
  • Automatiser les paiements via Mobile Money ou autres moyens.

Chaque site possède :

  • Un nom (ex. : BoutiqueDaloa, CitéWiFi, etc.)
  • Une localisation (utile pour le suivi ou l’organisation multi-sites)
  • Un type de site ("Voucher" ou "Non voucher" )
  • Des paramètres de configuration spécifiques (ex: port radius, prix, etc.)

Attention

Un Compte Mana peut avoir plusieurs sites ce qui vous permet de gérer tout vos points wifi zone à partir d'un seule compte. Connectez vous ici.

2

Création d'un site

A partir de votre compte Mana cliquer sur le Menu Gestion Sites > Ajouter un Site. Remplissez les champs nécessaires et validez

Attention

Pour le champs localisation veuillez vous trouvez sur le site en physique pour fournir la localisation correcte cela permettra de déterminer les meilleur paramètres de configuration

2

Type voucher / Type non voucher

✅ Type Voucher:

  • L’utilisateur se connecte en saisissant un seul code (appelé voucher)
  • Il n’y a pas de nom d’utilisateur ou de mot de passe.
  • Idéal pour une vente rapide de codes, surtout dans des lieux publics ou des boutiques.

📌 Exemple : Un client paie 100 FCFA, il reçoit un code unique (ex. : ABCD1234), il le saisit sur le portail captif et la connexion démarre.


✅ Type Non Voucher:

  • L’utilisateur se connecte en saisissant un nom d’utilisateur et un mot de passe.

📌 Exemple : Un client paie 100 FCFA (nom: uffgss / mot de passe: 1234).

Mode Local

Par défaut sur Mana Zone vous n'avez pas à générer les tickets vendus.
Vous créez juste votre compte vous configuré vos sites et vos routeurs et vous regardez le système vendre pour vous
L'insuffisance de ce système est que vous pouvez pas géré la validité de vos tickets (les validités sont configurées par défaut)


Si vous voulez gérer la validité des tickets vos même vous devez passez votre compte MAna en mode local
Le mode local vous permet d'importer les tickets de votre routeur sur Mana pour les vendres


Pour Cela veuillez suivre les étapes suivantes :

🛠️ Prérequis

  • Avoir accès à Mikhmon (connecté à ton routeur MikroTik)
  • Avoir un compte boutique sur Mana Zone
1

Accéder à l’interface Mikhmon

  • Ouvre ton navigateur et va à l’adresse de ton Mikhmon (ex. : http://192.168.88.10/mikhmon)
  • Connecte-toi à l’interface avec ton identifiant administrateur
2

Créer des tickets dans Mikhmon

  • Dans le menu à gauche, clique sur "Hotspot", puis sélectionne le routeur actif
  • Clique sur "Generate" ou "Users" > "Add"
  • Renseigne les paramètres du ticket :
    • Username : identifiant du ticket
    • Password : mot de passe du ticket
    • Duration : durée de validité (ex. : 1 jour, 1 semaine)
    • Price : prix du ticket (optionnel)
  • Clique sur "Create" ou "Generate"

📌 Les tickets apparaîtront dans la liste des utilisateurs (Users).

3

Exporter les tickets (en CSV)

  • Dans la section des utilisateurs, clique sur le bouton "Export"
  • Choisis le format CSV (Seul le format csv est accépté)
  • Télécharge le fichier généré sur ton ordinateur
4

Importer dans Mana Zone

  • Va sur Mana Zone et connecte-toi à ton compte boutique
  • Dans le menu, clique sur "Mes sites" > choisis ton site
  • Accède à la section "Importer tickets"
  • Clique sur "Choisir un fichier", sélectionne le fichier CSV/TXT exporté depuis Mikhmon
  • Valide l’importation

📌 Les tickets seront ajoutés à votre site et visibles dans la section "Tickets"

Dépannage

Solutions aux problèmes courants

Le portail de paiement ne s'ouvre pas

  • Vérifiez les liens de paiement sur votre portail captif - Assurez-vous que le boutton de rédirection vers la page de paiement est correcte (https://payement.mana-zone.app/?idBoutique=??&idSite=??). Ce lien est disponible dans la page de configuration du site relié au point wifi

  • Vérifiez la configuration de votre mikrotik - Assurez-vous que le routeur peut laisser passer la connexion à la page de paiement. dans la configuration du walled garden IP. A voir ici

Les utilisateurs n'arrivent pas à se connecter après achat d'un ticket

  • Vérifiez la configuration RADIUS - Assurez-vous que le serveur RADIUS est correctement configuré et accessible (les ports, et l'adresse ip).

  • La connexion automatique ne passe pas - Assurez-vous que le script js dans le head est correct et bien appelé dans la balise body. Vérifié ici.

Problèmes de performance du réseau

  • Vérifiez la charge du routeur - Un trop grand nombre d'utilisateurs peut surcharger le routeur.
  • Vérifiez les interférences Wi-Fi - Utilisez un analyseur de canal pour détecter les interférences.
  • Ajustez les limites de bande passante - Réduisez les limites par utilisateur si nécessaire.

Assistance technique

Si vous ne parvenez pas à résoudre un problème, contactez nous au +22667009024 support technique.

Télécharger un Portail Captif

Téléchargez le template de portail captif correspondant à votre configuration

Nous avons préparé des templates de portail captif prêts à l'emploi. Choisissez le type qui correspond à votre configuration et téléchargez le fichier ZIP correspondant :

Template Voucher

Pour les sites configurés en mode voucher où l'utilisateur saisit uniquement un code d'accès.

  • Champ de saisie unique pour le code voucher
  • Interface simplifiée
  • Script JavaScript adapté pour vouchers
  • Bouton de paiement Mana Zone intégré
Télécharger Template Voucher

Template Non-Voucher

Pour les sites configurés en mode classique avec nom d'utilisateur et mot de passe.

  • Champs utilisateur et mot de passe
  • Interface complète
  • Script JavaScript standard
  • Bouton de paiement Mana Zone intégré
Télécharger Template Non-Voucher

Instructions d'installation

1
Téléchargez le template correspondant à votre configuration (voucher ou non-voucher)
2
Décompressez le fichier ZIP sur votre ordinateur
3
Personnalisez les fichiers selon vos besoins (nom, couleurs, lien de paiement)
4
Transférez les fichiers vers votre routeur MikroTik via FTP ou interface web dans le dossier /hotspot/

Important

N'oubliez pas de modifier le lien de paiement dans les fichiers HTML avec vos identifiants Mana Zone :

https://payement.mana-zone.app/?idBoutique=VOTRE_ID&idSite=VOTRE_SITE_ID

Récupérez ces informations depuis votre interface d'administration Mana Zone.

Conseil

Les templates incluent tous les fichiers nécessaires : login.html, status.html, logout.html, error.html ainsi que les styles CSS et scripts JavaScript adaptés à chaque mode.