# Afficher un compteur de places restantes sur un événement de collectivité

> Calculer et afficher en direct le nombre de places disponibles sur une page d'inscription publique, sans extension de billetterie ni requête lourde.

- Auteur : WordPress Développement
- Publié le : 2021-10-11
- Mis à jour le : 2021-10-11
- Catégorie : Astuces
- URL : https://www.wpmoderne.fr/tips/compteur-places-restantes-evenement-collectivite/

## L’essentiel

- Calcul en direct à chaque affichage de la page
- Aucune extension de billetterie nécessaire
- Repose sur un simple comptage d'inscriptions

Cinquante places, pas une de plus. C'est la contrainte que nous avons reçue d'une communauté de communes qui organisait sa réunion publique annuelle dans une salle municipale soumise à un plafond ERP strict. Le formulaire d'inscription existait déjà, construit avec un simple Custom Post Type « participant » relié à l'événement par un champ personnalisé. Ce qui manquait, c'était l'affichage : combien de places restait-il, en direct, sans recharger la page toutes les cinq minutes pour vérifier ?

Poser une extension de billetterie complète pour un besoin aussi ponctuel n'avait pas de sens : la collectivité gère trois ou quatre événements par an, pas un programme de festival. Nous avons donc construit un compteur minimal, calculé à la volée à partir des inscriptions déjà enregistrées, sans jamais toucher à un système de paiement ou de réservation.

## Modéliser la capacité de l'événement

Chaque événement est un article du CPT `evenement`, avec un champ personnalisé `capacite_max` enregistré via `register_post_meta()`. Les inscriptions, elles, sont des entrées du CPT `inscription`, chacune reliée à l'événement par un champ `evenement_id`. Cette séparation permet de compter les inscriptions sans jamais modifier la fiche de l'événement lui-même, ce qui évite les problèmes de concurrence si plusieurs personnes s'inscrivent au même instant.

- Un champ `capacite_max` de type entier sur l'événement
- Un champ `evenement_id` de type entier sur chaque inscription
- Aucun champ de comptage stocké : tout est recalculé à l'affichage

## Compter les inscriptions avec WP_Query

Le comptage repose sur une requête `WP_Query` ciblée, avec un nombre de résultats réduit au strict nécessaire puisque c'est `found_posts` qui nous intéresse, pas la liste elle-même.

> L'essentiel à retenir : Calcul en direct à chaque affichage de la page ; Aucune extension de billetterie nécessaire ; Repose sur un simple comptage d'inscriptions

```
function wpm_places_restantes( $evenement_id ) {
    $capacite = (int) get_post_meta( $evenement_id, 'capacite_max', true );

    $query = new WP_Query( array(
        'post_type'      => 'inscription',
        'post_status'    => 'publish',
        'posts_per_page' => 1,
        'meta_query'     => array(
            array(
                'key'   => 'evenement_id',
                'value' => $evenement_id,
            ),
        ),
    ) );

    $inscrits = (int) $query->found_posts;

    return max( 0, $capacite - $inscrits );
}
```

Le `posts_per_page` à 1 peut surprendre : on ne veut pas la liste des inscriptions, seulement leur nombre total, exposé par `found_posts` quel que soit le nombre de résultats réellement retourné. Sur un événement de quelques dizaines de participants, cette requête s'exécute en quelques millisecondes.

## Afficher le compteur côté public

Le compteur s'affiche via un shortcode simple, appelé dans le contenu de la page d'inscription :

```
add_shortcode( 'places_restantes', function( $atts ) {
    $atts = shortcode_atts( array( 'evenement' => 0 ), $atts );
    $restantes = wpm_places_restantes( (int) $atts['evenement'] );

    if ( $restantes <= 0 ) {
        return '<p><strong>Complet</strong> — la liste d'attente est ouverte.</p>';
    }

    return sprintf(
        '<p><strong>%d place(s)</strong> encore disponible(s) sur cet événement.</p>',
        $restantes
    );
} );
```

Le message « Complet » renvoie implicitement vers une liste d'attente, gérée par ailleurs comme un simple statut sur les inscriptions au-delà du quota — un sujet distinct de celui-ci.

## Éviter de recalculer à chaque visite

Pour un événement très consulté (relayé sur les réseaux sociaux de la collectivité, par exemple), recalculer la requête à chaque chargement de page reste négligeable en volume, mais autant s'en prémunir. Un transitoire de courte durée, invalidé à chaque nouvelle inscription, suffit :

- `set_transient()` avec une durée de vie de 60 secondes pour absorber les pics de trafic
- `delete_transient()` déclenché sur le hook `save_post_inscription`
- Aucune dépendance à un cache objet externe, ce transitoire suffit largement à ce volume

Sur les trois événements suivis depuis la mise en production de ce compteur, jamais plus de deux inscriptions simultanées n'ont été enregistrées à la même seconde : le risque de sur-réservation par calcul concurrent reste théorique à cette échelle, mais le transitoire à durée courte le couvre sans effort.

## En résumé

Un compteur de places restantes n'a pas besoin d'un module de billetterie : deux CPT reliés par un champ personnalisé, une requête `WP_Query` qui exploite `found_posts`, et un shortcode suffisent pour un événement de collectivité. La logique de liste d'attente et la billetterie payante restent des sujets à part entière, à ne raccorder que si le besoin se confirme sur la durée.