WP-CLI est l’outil en ligne de commande de WordPress. Si votre hébergeur vous donne un accès SSH avec WP-CLI, HappenBoard ajoute des commandes pour créer des événements et lancer des imports. Elles servent à automatiser une installation, à remplir un site de préproduction ou à importer un fichier trop lourd pour le navigateur.
Lancez les commandes depuis le dossier de votre WordPress. Pour voir toutes les commandes HappenBoard de votre site :
wp help happenboardCréer un événement
wp happenboard event create --title="Soirée de lancement" --start="2026-06-15 18:00"Une série hebdomadaire de dix dates, de 30 minutes chacune :
wp happenboard event create --title="Point d'équipe" --start="2026-06-15 09:00" --end="2026-06-15 09:30" --rrule="FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=10"| Option | Rôle | Par défaut |
|---|---|---|
--title=<titre> | Le titre de l’événement. Obligatoire. | Aucun |
--start=<date> | Le début, par exemple "2026-06-15 18:00". Obligatoire. | Aucun |
--end=<date> | La fin. | Une heure après le début |
--all-day | En fait un événement sur la journée entière. | Désactivé |
--rrule=<règle> | Une règle de répétition, par exemple "FREQ=WEEKLY;BYDAY=MO;COUNT=8". | Aucune |
--venue=<id> | Relie un lieu existant par son identifiant. | Aucun |
--organizer=<id> | Relie un organisateur existant par son identifiant. | Aucun |
--capacity=<n> | Le nombre de places. 0 signifie illimité. | Illimité |
--format=<format> | in_person (présentiel), virtual (en ligne) ou hybrid (hybride). | in_person |
--status=<statut> | publish, draft, future (planifié), pending ou private. | publish |
--description=<texte> | La description de l’événement. | Vide |
--timezone=<fuseau> | Le fuseau dans lequel sont écrits le début et la fin, par exemple Europe/Paris. | Le fuseau de votre site |
--porcelain | N’affiche que l’identifiant du nouvel événement, pour les scripts. | Désactivé |
Les dates de l’événement sont calculées tout de suite : il apparaît dans les blocs de calendrier et de liste sans nouvel enregistrement.
La commande s’arrête sur une erreur, sans rien créer, si la fin précède le début ou si la règle de répétition est inutilisable. De même si le format ou le statut ne fait pas partie des valeurs ci-dessus. Un identifiant de lieu ou d’organisateur qui n’existe pas est ignoré avec un avertissement. Même chose pour un fuseau inconnu : celui du site est utilisé à la place.
Migrer depuis une autre extension
Trois des extensions prises en charge ont une commande. Ajoutez --dry-run pour voir ce qui se passerait sans rien écrire.
wp happenboard migrate tec --dry-run
wp happenboard migrate tec
wp happenboard migrate em
wp happenboard migrate sugartec correspond à The Events Calendar, em à Events Manager et sugar à Sugar Calendar. Chaque commande vérifie que les données sources sont là, annonce le nombre d’événements trouvés, puis les traite par lots de 100. Elle se termine par le nombre d’éléments créés, ignorés et en échec pour chaque type de contenu. Les problèmes s’affichent sous forme d’avertissements.
EventKoi et Amelia n’ont pas de commande. Migrez-les depuis HappenBoard → Settings → Migration.
Importer un fichier .ics
wp happenboard migrate ics --file=/chemin/vers/agenda.ics --dry-run
wp happenboard migrate ics --file=/chemin/vers/agenda.ics--file=<chemin>: le fichier sur le serveur. Obligatoire.--limit=<n>: s’arrêter après ce nombre d’événements. Pratique pour tester un gros fichier.--dry-run: faire le bilan sans rien écrire.
La commande affiche chaque remarque sous forme d’avertissement, puis le nombre d’événements créés, mis à jour, ignorés et en erreur. Un fichier introuvable, ou sans aucun événement, l’arrête sur une erreur. L’import se comporte exactement comme dans le navigateur, voir importer un fichier .ics.
Reconstruire l’historique des participants
Cette commande demande HappenBoard Pro. Voir ce que Pro ajoute.
Cette commande remplit l’historique d’activité des participants à partir des inscriptions et des check-ins existants. Utilisez-la sur un site qui prenait des inscriptions avant l’arrivée de l’historique. Les participants qui ont déjà un historique sont ignorés.
wp happenboard pro attendee-events rebuild --dry-run
wp happenboard pro attendee-events rebuild --per-event=123--dry-run: indiquer ce qui serait écrit.--per-event=<id>: seulement les participants de cet événement. Tout ce qui n’est pas l’identifiant d’un événement existant est refusé.--force: supprimer l’historique de chaque participant puis le reconstruire.
Envoyer les rappels à l’heure
Celle-ci est une commande WordPress. Les e-mails de rappel dépendent des tâches programmées de WordPress, qui ne tournent que lorsque quelqu’un visite votre site. Sur un site peu fréquenté, demandez à votre hébergeur de lancer cette commande toutes les minutes :
wp cron event run --due-nowHappenBoard → Settings → Health vous signale les tâches programmées en retard. Voir santé et maintenance.
Pour aller plus loin
- Migrer depuis une autre extension : ce que chaque extension permet de reprendre.
- Importer un fichier .ics : ce que devient chaque entrée de calendrier.
- Santé et maintenance : contrôler les tâches programmées et lancer les actions d’entretien.