📦 Vue d’ensemble

Ce guide vous accompagne pas à pas pour installer et configurer la carte interactive des inscriptions au concours Eurêkamaths.

🎯 Étape 1 : Prérequis

Avant de commencer, assurez-vous d’avoir :

• ✅ WordPress installé et fonctionnel
• ✅ Extension « Inscription Concours Eurêkamaths » activée
• ✅ Tables de base de données :
  • wp_inscrits (créée par l’extension Inscription)
  • wp_etabs_geolocalisation (avec les données des établissements)

🔧 Étape 2 : Préparer la table des établissements

Ajouter les colonnes latitude et longitude

Si votre table wp_etabs_geolocalisation n’a pas encore les colonnes de géolocalisation :

ALTER TABLE wp_etabs_geolocalisation
ADD COLUMN latitude DECIMAL(10, 8) DEFAULT NULL,
ADD COLUMN longitude DECIMAL(11, 8) DEFAULT NULL;

-- Créer des index pour améliorer les performances
CREATE INDEX idx_coords ON wp_etabs_geolocalisation(latitude, longitude);

Vérifier la structure de la table

Votre table doit avoir au minimum ces colonnes :

DESCRIBE wp_etabs_geolocalisation;

Résultat attendu :

uai          varchar(8)
nom_etab     varchar(255)
adresse      varchar(255)
commune      varchar(100)
cp           varchar(10)
pays         varchar(100)
latitude     decimal(10,8)    <- NOUVEAU
longitude    decimal(11,8)    <- NOUVEAU

📂 Étape 3 : Installer l’extension Carte

Structure des fichiers à créer

wp-content/plugins/carte-inscriptions/
├── carte-inscriptions.php          <- Fichier principal
├── geocoding-utility.php            <- Utilitaire de géocodage (optionnel)
├── assets/
│   ├── carte-script.js              <- JavaScript
│   └── carte-style.css              <- CSS
└── README.md                         <- Documentation

Commandes pour créer la structure

cd wp-content/plugins/
mkdir carte-inscriptions
cd carte-inscriptions
mkdir assets

Copier les fichiers

1. carte-inscriptions.php → fichier principal fourni
2. assets/carte-script.js → JavaScript Leaflet
3. assets/carte-style.css → styles CSS
4. geocoding-utility.php → utilitaire (optionnel mais recommandé)

🌍 Étape 4 : Géocoder les établissements

Les coordonnées GPS sont indispensables pour afficher les établissements sur la carte.

Option A : Utiliser l’utilitaire de géocodage (RECOMMANDÉ)

1. Ajouter le code de géocodage dans carte-inscriptions.php :

   // À la fin du fichier carte-inscriptions.php, avant la ligne finale
   require_once plugin_dir_path(__FILE__) . 'geocoding-utility.php';
   

2. Créer une page WordPress (en tant qu’administrateur) :
   • Titre : « Géocodage des établissements »
   • Contenu : [geocode_etabs]
   • Publier la page
3. Accéder à la page et cliquer sur « Démarrer le géocodage »
4. Attendre la fin : le processus géocode automatiquement tous les établissements

Option B : Import manuel CSV

Si vous avez déjà un fichier CSV avec les coordonnées :

uai,latitude,longitude
0380001A,45.188529,5.724524
0750001B,48.841684,2.289960

Import SQL :

LOAD DATA LOCAL INFILE 'coordonnees.csv'
INTO TABLE wp_etabs_geolocalisation
FIELDS TERMINATED BY ','
ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 ROWS
(uai, latitude, longitude);

Option C : API externe (pour développeurs)

Utiliser un service de géocodage :

• API Adresse (gouv.fr) : gratuit, France uniquement
• Nominatim (OpenStreetMap) : gratuit, monde entier
• Google Geocoding API : payant mais précis

✅ Étape 5 : Activer l’extension

1. Aller dans WordPress Admin → Extensions
2. Trouver « Carte des Inscriptions Eurêkamaths »
3. Cliquer sur Activer

🎨 Étape 6 : Afficher la carte

Créer une page publique

1. Créer une nouvelle page :
   • Titre : « Carte des inscriptions »
   • Slug : carte-inscriptions
2. Ajouter le shortcode :

   [carte_inscriptions]
   

3. Personnaliser (optionnel) :

   [carte_inscriptions height="700px" zoom="7" center_lat="46.603354" center_lng="1.888334"]
   

4. Publier la page

Intégrer dans une page existante

Vous pouvez combiner avec d’autres shortcodes :

<h2>Les classes inscrites</h2>
<p>Découvrez toutes les classes participantes sur la carte interactive :</p>

[carte_inscriptions]

<h2>Inscrivez votre classe</h2>

                
Vous devez être connecté pour accéder au formulaire d’inscription.
                
Se connecter |
                   S’inscrire
            

🔍 Étape 7 : Vérification

Vérifier que tout fonctionne

1. Accéder à la page de la carte
2. Vérifier l’affichage :
   • ✅ La carte s’affiche correctement
   • ✅ Les marqueurs apparaissent
   • ✅ Les marqueurs ont les bonnes couleurs (jaune/vert/violet)
   • ✅ Les popups s’ouvrent au clic
   • ✅ Les statistiques sont affichées

En cas de problème

La carte ne s’affiche pas :

-- Vérifier qu'il y a des inscriptions
SELECT COUNT(*) FROM wp_inscrits;

-- Vérifier qu'il y a des coordonnées
SELECT COUNT(*) FROM wp_etabs_geolocalisation
WHERE latitude IS NOT NULL AND longitude IS NOT NULL;

-- Vérifier la jointure
SELECT COUNT(*) FROM wp_inscrits i
INNER JOIN wp_etabs_geolocalisation e ON i.uai = e.uai
WHERE e.latitude IS NOT NULL AND e.longitude IS NOT NULL;

Aucun marqueur :

• Vérifiez la console JavaScript (F12) pour les erreurs
• Vérifiez que l’année scolaire correspond
• Vérifiez les paramètres du shortcode

Les marqueurs sont mal positionnés :

-- Vérifier quelques coordonnées
SELECT uai, nom_etab, latitude, longitude
FROM wp_etabs_geolocalisation
WHERE latitude IS NOT NULL
LIMIT 5;

📊 Étape 8 : Statistiques et suivi

Requêtes SQL utiles

Nombre d’établissements par département :

SELECT
    SUBSTRING(uai, 1, 3) as departement,
    COUNT(*) as nombre
FROM wp_inscrits i
INNER JOIN wp_etabs_geolocalisation e ON i.uai = e.uai
WHERE i.annee_scolaire = '2024-2025'
GROUP BY departement
ORDER BY nombre DESC;

Répartition par niveau :

SELECT
    niveau,
    COUNT(*) as nombre,
    SUM(nb) as total_eleves
FROM wp_inscrits
WHERE annee_scolaire = '2024-2025'
GROUP BY niveau;

Établissements sans coordonnées :

SELECT DISTINCT e.uai, e.nom_etab, e.commune
FROM wp_inscrits i
LEFT JOIN wp_etabs_geolocalisation e ON i.uai = e.uai
WHERE (e.latitude IS NULL OR e.longitude IS NULL)
AND i.annee_scolaire = '2024-2025';

🎯 Étape 9 : Optimisations (optionnel)

Mise en cache

Pour améliorer les performances sur un site à fort trafic :

// Ajouter dans carte-inscriptions.php
public function ajax_get_inscriptions_map() {
    $cache_key = 'carte_inscriptions_' . $annee_scolaire;
    $cached_data = get_transient($cache_key);

    if ($cached_data !== false) {
        wp_send_json_success($cached_data);
        return;
    }

    // ... code existant pour récupérer les données ...

    // Mettre en cache pour 1 heure
    set_transient($cache_key, $data, HOUR_IN_SECONDS);

    wp_send_json_success($data);
}

Invalidation du cache

Ajouter un hook pour vider le cache quand une inscription est créée :

add_action('inscription_created', function($annee_scolaire) {
    delete_transient('carte_inscriptions_' . $annee_scolaire);
});