Hooks notifications et e-mails

Ces hooks agissent sur les e-mails de HappenBoard. Ils concernent les participants inscrits à un événement, les clients qui prennent rendez-vous, ainsi que l’hôte et l’administrateur prévenus de chaque réservation. Ils permettent de réécrire ou d’annuler un message, de choisir sa langue, de changer le moment des rappels ou de décider qui est prévenu d’une réservation.

Côté réglages, voyez les e-mails automatiques et la langue du participant. Si les hooks sont nouveaux pour vous, commencez par Étendre HappenBoard avec les hooks.

Les e-mails envoyés par HappenBoard

Chaque e-mail a un identifiant de modèle. Cet identifiant termine le nom du filtre qui peut réécrire le message, et il est transmis à happenboard_email_locale.

Les e-mails d’inscription passent par happenboard_notifications_{$template_id} :

Les e-mails de réservation passent par happenboard_notifications_booking_{$template_id} :

Ces réglages se trouvent dans HappenBoard → Settings → Email. Le circuit des demandes est décrit dans Valider les demandes de rendez-vous.

Comment partent les rappels

Les rappels d’inscription viennent d’une seule tâche WP-Cron, happenboard_rsvp_reminder_sweep, lancée toutes les 15 minutes. Chaque passage cherche les dates qui commencent désormais dans le délai de rappel (Send reminder hours before start, 24 par défaut). Il déclenche ensuite happenboard_cron_reminder une fois pour chaque participant toujours inscrit.

L’e-mail de rappel de HappenBoard écoute cette action, tout comme les rappels WhatsApp et MailerPress de HappenBoard Pro. Avant la version 0.2.0, chaque inscription programmait sa propre tâche cron ; le premier balayage après la mise à jour les reprend.

Les rappels de rendez-vous fonctionnent autrement. Chaque réservation confirmée programme ses propres rappels, avec Action Scheduler quand il est installé et WP-Cron sinon, aux heures fixées par happenboard_booking_reminder_offsets.

La langue d’un e-mail

• E-mails d’inscription : la langue de la traduction de l’événement sur laquelle le participant s’est inscrit (WPML ou Polylang), sinon celle du site.
• E-mails de réservation au client : la langue de la page où il a réservé, sinon celle de son profil s’il a un compte, sinon celle du site.
• E-mails de réservation à l’hôte et à l’administrateur : la langue du profil de chaque destinataire. happenboard_email_locale ne s’exécute pas pour eux.

happenboard_email_locale peut modifier les deux premiers cas. HappenBoard Pro s’en sert pour lire un champ de langue du formulaire d’inscription.

Déclencheurs MailerPress (Pro)

Les actions happenboard_mp_* n’existent que dans HappenBoard Pro, et ne se déclenchent que si MailerPress est actif et l’intégration MailerPress activée. HappenBoard n’envoie rien sur ces actions : ce sont les déclencheurs sur lesquels vous construisez vos automatisations dans MailerPress. Voir Automatisations MailerPress.

apply_filters( 'happenboard_email_locale', string $locale, string $template_id, WP_Post|null $event, array<string,mixed> $row )

add_filter(
    'happenboard_email_locale',
    function ( $locale, $template_id, $event, $row ) {
        // Ligne participant : "email", ligne réservation : "customer_email".
        $email = (string) ( $row['email'] ?? $row['customer_email'] ?? '' );

        return str_ends_with( $email, '.fr' ) ? 'fr_FR' : $locale;
    },
    20,
    4
);

apply_filters( "happenboard_notifications_{$template_id}", array<string,mixed> $payload, WP_Post $event, array<string,mixed> $attendee )

add_filter(
    'happenboard_notifications_confirmation',
    function ( array $payload, $event = null, $attendee = array() ): array {
        $payload['subject'] = '[' . get_bloginfo( 'name' ) . '] ' . $payload['subject'];
        $payload['body']   .= '<p>' . esc_html__( 'See you there.', 'my-plugin' ) . '</p>';

        // Renvoyez array( 'send' => false ) + $payload pour annuler l'e-mail.
        return $payload;
    },
    40,
    3
);

do_action( 'happenboard_cron_reminder', int $attendee_id )

add_action(
    'happenboard_cron_reminder',
    function ( int $attendee_id ): void {
        // Un canal à vous, en plus de l'e-mail.
        my_send_sms_reminder( $attendee_id );
    },
    50
);

apply_filters( 'happenboard_booking_email_tokens', array<string,string> $tokens, int $booking_id, array<string,mixed> $row )

add_filter(
    'happenboard_booking_email_tokens',
    function ( $tokens, $booking_id, $row ) {
        // Le lien de réunion enregistré sur le type de rendez-vous.
        $link = (string) get_post_meta( (int) $row['booking_type_id'], 'acme_meeting_link', true );
        if ( '' !== $link && '' !== $tokens['start_local'] ) {
            $tokens['start_local'] .= ' · ' . $link;
        }

        return $tokens;
    },
    10,
    3
);

apply_filters( "happenboard_notifications_booking_{$template_id}", array<string,mixed> $payload, int $booking_id, array<string,mixed> $row )

add_filter(
    'happenboard_notifications_booking_confirmation',
    function ( array $payload, int $booking_id, array $row ): array {
        // Mettre l'accueil en copie de chaque confirmation.
        $payload['headers'][] = 'Bcc: [email protected]';

        return $payload;
    },
    10,
    3
);

apply_filters( 'happenboard_booking_operator_recipients', array<int,string> $recipients, string $event, int $booking_id, array<string,mixed> $row )

add_filter(
    'happenboard_booking_operator_recipients',
    function ( array $recipients, string $event, int $booking_id, array $row ): array {
        // L'accueil est prévenu de chaque demande en attente de validation.
        if ( 'request' === $event ) {
            $recipients[] = '[email protected]';
        }

        return $recipients;
    },
    10,
    4
);

apply_filters( 'happenboard_booking_reminder_offsets', array<int,int> $offsets, int $booking_id, array<string,mixed> $row )

add_filter(
    'happenboard_booking_reminder_offsets',
    function ( array $offsets, int $booking_id, array $row ): array {
        // Deux jours avant, la veille et deux heures avant.
        return array( 48, 24, 2 );
    },
    10,
    3
);

do_action( 'happenboard_mp_rsvp_created', array<string,mixed> $ctx )

add_action(
    'happenboard_mp_rsvp_created',
    function ( array $ctx ): void {
        // Journaliser chaque inscription transmise à MailerPress.
        error_log(
            sprintf(
                '%s registered for %s (%d seats).',
                (string) ( $ctx['email'] ?? '' ),
                (string) ( $ctx['event_title'] ?? '' ),
                (int) ( $ctx['quantity'] ?? 1 )
            )
        );
    }
);

do_action( 'happenboard_mp_rsvp_cancelled', array<string,mixed> $ctx )

add_action(
    'happenboard_mp_rsvp_cancelled',
    function ( array $ctx ): void {
        // Étiqueter le contact dans votre propre système.
        my_plugin_tag_contact(
            (string) ( $ctx['email'] ?? '' ),
            'cancelled-' . (int) ( $ctx['event_id'] ?? 0 )
        );
    }
);

do_action( 'happenboard_mp_checked_in', array<string,mixed> $ctx )

add_action(
    'happenboard_mp_checked_in',
    function ( array $ctx ): void {
        // Journaliser chaque check-in transmis à MailerPress.
        error_log(
            sprintf(
                '%s checked in at %s.',
                (string) ( $ctx['email'] ?? '' ),
                (string) ( $ctx['event_title'] ?? '' )
            )
        );
    }
);

do_action( 'happenboard_mp_reminder', array<string,mixed> $ctx )

add_action(
    'happenboard_mp_reminder',
    function ( array $ctx ): void {
        // Journaliser chaque rappel transmis à MailerPress.
        error_log(
            sprintf(
                'Reminder due for %s (event %d).',
                (string) ( $ctx['email'] ?? '' ),
                (int) ( $ctx['event_id'] ?? 0 )
            )
        );
    }
);

do_action( 'happenboard_mp_post_event_tick', int $attendee_id, int $event_id )

add_action(
    'happenboard_mp_post_event_tick',
    function ( int $attendee_id, int $event_id ): void {
        // Journaliser chaque relance trouvée par le balayage.
        error_log(
            sprintf(
                'Follow-up due for attendee %d of event %d.',
                $attendee_id,
                $event_id
            )
        );
    },
    10,
    2
);

do_action( 'happenboard_mp_post_event', array<string,mixed> $ctx )

add_action(
    'happenboard_mp_post_event',
    function ( array $ctx ): void {
        // Programmer un questionnaire de satisfaction.
        my_plugin_queue_survey(
            (string) ( $ctx['email'] ?? '' ),
            (int) ( $ctx['event_id'] ?? 0 )
        );
    }
);

apply_filters( 'happenboard_pro_mailerpress_contact', array<string,mixed> $payload, array<string,mixed> $ctx )

add_filter(
    'happenboard_pro_mailerpress_contact',
    function ( array $payload, array $ctx ): array {
        // Enregistrer le nombre de places sur le contact.
        $payload['custom_fields']['hp_seats'] = (string) ( $ctx['quantity'] ?? 1 );

        return $payload;
    },
    10,
    2
);

Pour aller plus loin

• Hooks prise de rendez-vous : les actions de réservation qui envoient ces e-mails.
• Hooks participants et inscriptions : les actions d’inscription et d’annulation derrière les e-mails aux participants.
• Personnaliser l’apparence des e-mails : couleurs, logo et pied de page de chaque e-mail.