
Nos sites prenaient leurs rendez-vous par un service de planification externe. Le visiteur quittait le site, le rendez-vous vivait dans un autre outil, et quelqu’un le recopiait à la main dans le CRM. Notre thème Kailua a déjà un CRM avec un planning d’équipe dans le back office EmDash : nous avons fait de la réservation une option de ce planning. Elle est sortie avec notre socle 3.35.0, le 13 novembre 2026.
Cet article montre comment elle est construite, avec le code réel. La même approche vaut pour tout site EmDash qui garde ses propres données dans sa base.
Les règles posées
Des règles courtes, exprès :
- des plages d’ouverture par jour de la semaine, une ou plusieurs (matin, après-midi) ;
- un délai minimum avant un rendez-vous (48 heures par défaut) et un horizon (60 jours par défaut) ;
- un créneau n’est proposé que si l’hôte est libre dans son planning, battement compris ;
- le visiteur ne voit jamais ce qui occupe l’hôte, seulement ce qui est libre.
Aucune table nouvelle. Le réglage est une valeur JSON rangée dans la table des réglages du CRM sous la clé reservation, fermée par défaut. Un rendez-vous pris en ligne est un rendez-vous du planning comme un autre, avec le visiteur en participant externe, et une fiche contact créée si l’adresse est inconnue.
Les créneaux libres sont une fonction pure
Le cœur est une fonction sans accès à la base. Elle prend le réglage, un jour, une durée, les plages occupées et l’heure courante, et rend les débuts de créneau libres :
export function creneauxDuJour(r: ReglageReservation, jour: string, duree: number, occupe: readonly { debut: number; fin: number }[], maintenant: number): number[] {
const d = lireJour(jour);
if (!d) return [];
const { de, a } = fenetre(r, maintenant);
const pris = fusionner(occupe.map((o) => ({ debut: o.debut - r.tampon * MINUTE, fin: o.fin + r.tampon * MINUTE })));
const sortie: number[] = [];
for (const [debut, fin] of r.plages[String(jourSemaine(jour))] ?? []) {
const fermeture = minutesDe(fin);
for (let m = minutesDe(debut); m + duree <= fermeture; m += r.pas) {
const t = instant({ ...d, h: Math.floor(m / 60), mi: m % 60 });
const c = { debut: t, fin: t + duree * MINUTE };
if (t < de || c.fin > a) continue;
if (pris.some((x) => chevauche(x, c))) continue;
sortie.push(t);
}
}
return sortie;
}
Les plages occupées sont élargies du battement, puis fusionnées. La boucle parcourt chaque plage du jour par pas, et ne garde un créneau que s’il commence après le délai, finit avant l’horizon et ne chevauche rien. Les heures voyagent en UTC ; chaque limite de jour se calcule dans le fuseau du site.
Parce qu’elle est pure, elle se teste en Node, sans rien d’autre. Le self-check du module de réservation joue 23 contrôles sans base et sans EmDash.
La route publique
EmDash tourne dans Astro : une extension native peut donc ajouter une route avec injectRoute() d’Astro. La nôtre est déclarée à côté des autres routes du CRM, dans l’intégration :
injectRoute({ pattern: ROUTE_RESERVATION, entrypoint: ici("./reservation.route.ts"), prerender: false });
La route répond à /_emdash/kailua/reservation. GET rend la part publique du réglage et les créneaux libres d’un mois. POST prend le rendez-vous.
Les gardes, dans l’ordre :
- jamais en cache, jamais indexée : chaque réponse porte
Cache-Control: no-storeetX-Robots-Tag: noindex, nofollow; POSTen JSON, 16 Ko au plus, même origine (vérifiée sur l’en-têteOrigin) ;- un champ piège que seul un robot remplit, et un formulaire envoyé en moins de deux secondes : le robot reçoit un faux succès et rien n’est écrit ;
- puis la fonction de réservation relit le créneau dans le planning, parce qu’il a pu partir entre l’affichage et le clic, et applique un plafond de réservations en ligne par heure.
Chaque refus est une phrase que la page peut montrer au visiteur. Un courriel qui ne part pas n’annule jamais la réservation : le rendez-vous est écrit, le visiteur le voit à l’écran, et la raison de l’échec va au journal du Worker.
Ce qui se passe à la réservation
La fonction reserver fait toute l’écriture :
- elle vérifie le nom, l’adresse, le téléphone (facultatif ou obligatoire selon le réglage) et les réponses aux questions de l’hôte ;
- elle lit les occupations de l’hôte autour du jour et vérifie que le créneau figure encore dans la liste rendue par
creneauxDuJour; - elle retrouve le contact par son adresse, ou le crée ;
- elle crée le rendez-vous au nom de l’hôte, avec le visiteur en participant, les réponses dans la description et un lien vers le contact.
La route envoie ensuite deux courriels : une invitation au visiteur avec un fichier d’agenda, et un avis à l’hôte avec le même fichier et un lien qui ouvre le rendez-vous dans le back office.
Le widget reste dans une page en cache
Côté site, c’est Reservation.astro : du HTML, une feuille et un script. Ni React ni dépendance. La page reste statique et peut être gardée en cache, parce que les créneaux arrivent par le script, jamais au rendu. Sans JavaScript, le visiteur lit une phrase de repli et un lien.
Sur la démo Kailua, c’est une ligne dans l’accueil :
<Reservation hote="Atelier Makani" role={locale === "fr" ? "Entretien et réparation" : "Servicing and repairs"} />
Le widget montre l’hôte, les durées, la grille du mois et les créneaux libres du jour choisi, puis une confirmation avec le jour, l’heure et le fichier d’agenda.
Les réglages dans le back office
L’hôte règle tout depuis l’écran Planning, par un bouton « Réservation en ligne » dans son en-tête : ouverte ou fermée, qui reçoit, durées, délai minimum, horizon, horaires par jour avec pause, et les questions posées au visiteur (texte libre ou liste de choix). La lecture et l’écriture du réglage sont des routes réservées aux administrateurs.
Depuis le socle 3.38.0, le titre, la phrase d’accueil et les questions se saisissent par langue du site. Une langue sans texte propre retombe sur le texte par défaut. Quand un visiteur coche un choix dans sa langue, il est rangé dans le texte par défaut, celui que l’équipe lit dans le planning.
Ce que nous avons laissé de côté
Exprès :
- pas de choix du fuseau : les heures sont celles du site, dites en clair ;
- pas de comparaison avec l’agenda du visiteur ;
- pas de paiement à la réservation ;
- pas de nouvelle collection dans EmDash : la réservation vit dans les tables du CRM que le thème possède déjà.
Ce dernier point est la vraie raison de le faire soi-même. Les données restent dans la base du site, dans le compte Cloudflare de l’acheteur, à côté de la fiche du client et de son historique.
Où elle est livrée
La réservation fait partie du CRM, livré dans le template Kailua avec la licence Kailua 3 Pro. Elle a sa propre page : Plugin Réservation en ligne pour EmDash. L’exemple en service est sur la démo Kailua, en anglais à la racine et en français sous /fr/. Elle demande le moteur allumé, donc EmDash sur Cloudflare ; la documentation explique comment mettre le back office en ligne.



