HappenBoard → Settings → Tools propose deux allers-retours : vos événements sous forme de tableur CSV, et vos réglages sous forme de fichier JSON. Par défaut, seuls les administrateurs peuvent s’en servir.
Le même écran contient un bouton Re-run setup wizard. Il relance l’assistant de configuration sans toucher à vos données.
Exporter vos événements
- Allez dans HappenBoard → Settings → Tools.
- Cliquez sur Export events (CSV).
Votre navigateur télécharge un fichier nommé d’après votre site et la date. Il contient tous les événements publiés, planifiés, en brouillon, en attente de relecture ou privés. Les événements à la corbeille sont exclus : restaurer une sauvegarde ne fait jamais revenir ce que vous avez supprimé.
Le fichier compte une ligne par événement. Un événement récurrent (un événement qui se répète, comme un cours hebdomadaire) n’apparaît qu’une fois, avec sa règle de répétition. Les accents s’affichent correctement à l’ouverture dans Excel.
Les colonnes
| Colonne | Contenu |
|---|---|
title | Le titre de l’événement. Obligatoire pour un import. |
status | publish, draft, future (planifié), pending ou private. |
start_utc, end_utc | Début et fin en UTC (pas en heure locale), écrits comme 2026-06-15T16:00:00Z. Obligatoires pour un import. |
all_day | 1 pour un événement sur la journée entière, 0 sinon. |
rrule | La règle de répétition, par exemple FREQ=WEEKLY;BYDAY=MO;COUNT=8. Vide pour un événement unique. |
venue_name, venue_address | Le nom du lieu et son adresse complète. |
organizer_name, organizer_email | Le nom et l’e-mail de l’organisateur. |
capacity | Le nombre de places. 0 signifie illimité. |
categories, tags | Des noms séparés par une barre verticale, par exemple Yoga|Plein air. |
excerpt, content | Le résumé et la description de l’événement. |
format | in_person (présentiel), virtual (en ligne) ou hybrid (hybride). |
online_url, online_provider | Le lien et le service d’un événement en ligne. |
image_url | L’adresse de l’image mise en avant. |
Si vous modifiez le fichier dans un tableur, vérifiez que les dates gardent ce format avant de l’importer. Une cellule qui commence par =, +, - ou @ est écrite précédée d’une apostrophe, pour qu’un tableur ne l’exécute jamais comme une formule. L’import retire cette apostrophe.
Importer des événements depuis un fichier CSV
- Préparez un fichier CSV avec une ligne d’en-tête. Seules les colonnes
title,start_utcetend_utcsont obligatoires. Les colonnes peuvent être dans n’importe quel ordre, et celles que HappenBoard ne connaît pas sont ignorées. - Allez dans HappenBoard → Settings → Tools.
- Cliquez sur Import events (CSV) et choisissez votre fichier.
- Lisez le résultat : le nombre d’événements créés (Created) et ignorés (Skipped), avec les dix premières erreurs listées en dessous.
L’import ne fait que créer des événements. Il ne met jamais à jour ni ne remplace un événement existant : importer deux fois le même fichier vous donne deux exemplaires de chaque événement.
Ce que devient chaque ligne :
- une ligne sans titre, sans début ou sans fin est ignorée, et son numéro de ligne est indiqué ;
- une ligne dont le début ou la fin n’est pas une date avec heure, comme
2026-06-15T16:00:00Zou2026-06-15 16:00, est ignorée, tout comme une ligne qui finit avant de commencer ; - une ligne dont HappenBoard ne peut pas utiliser la règle de répétition est ignorée, avec la raison ;
- un statut inconnu ou vide devient un brouillon ;
- les catégories et étiquettes sont retrouvées par leur nom, et créées si elles n’existent pas ;
- le lieu et l’organisateur arrivent en texte sur l’événement, sans lien avec vos fiches lieu ;
- l’image mise en avant n’est appliquée que si
image_urldésigne une image de la médiathèque de ce site. Les images hébergées ailleurs ne sont pas téléchargées ; - l’e-mail de l’organisateur n’est conservé que s’il s’agit d’une adresse valide.
Après l’import
Les événements importés apparaissent tout de suite sur l’écran Événements, dans le calendrier d’administration et dans les blocs de calendrier et de liste. Un événement récurrent reçoit toutes ses dates. Les événements importés avec le statut draft restent hors de vos pages publiques tant que vous ne les publiez pas.
Les participants et les rendez-vous ne font pas partie de ce fichier. Les écrans Attendees et Bookings ont leur propre export CSV, présenté dans gérer les participants.
Sauvegarder et restaurer vos réglages
Cliquez sur Export settings (JSON) pour télécharger un petit fichier avec vos réglages HappenBoard :
- les réglages General et Email ;
- les options de carte, de météo et de protection contre le spam de l’écran Integrations ;
- l’interrupteur AI agents.
Servez-vous-en pour reproduire une configuration sur un site de préproduction ou un second site. Les réglages de HappenBoard Pro ne sont pas inclus.
Les clés secrètes sont exclues volontairement : la clé secrète Turnstile et les clés Akismet, Google Maps et Open-Meteo. Un import n’efface jamais les clés déjà enregistrées sur le site qui reçoit le fichier. Sur un nouveau site, saisissez-les à la main.
Pour restaurer, cliquez sur Import settings (JSON) et choisissez le fichier. HappenBoard vérifie qu’il s’agit bien d’un export de réglages HappenBoard dans une version qu’il comprend, puis l’applique. Tout autre fichier est refusé, et rien ne change.
Le fichier contient l’interrupteur AI agents. Un import active ou désactive donc l’accès des agents IA comme sur le site d’origine : vérifiez ce réglage ensuite.
Pour aller plus loin
- Migrer depuis une autre extension : copier directement les événements d’une autre extension d’agenda.
- Catégories, étiquettes et couleurs : préparer vos catégories avant un gros import.
- RGPD, données personnelles et désinstallation : faire une sauvegarde avant de retirer HappenBoard.