Prérequis : 

• Charitable Pro 1.8.16+
• Hommages caritatifs 1.0.0+

Un don commémoratif a plus de sens lorsque la famille en est informée et lorsque le reçu du donateur reflète la personne honorée par son don. Tributes gère les deux : il peut informer automatiquement un proche, envoyer un résumé périodique aux contacts de la famille et ajouter une section commémorative aux reçus.

Toute la formulation est à votre contrôle, définie une fois dans Dons > Hommages > Paramètres.

La carte électronique de notification de don commémoratif

Lorsqu'un donateur choisit d'informer un proche et confirme son consentement, Tributes envoie une notification une fois le don effectué. Elle indique qu'un don a été fait, de qui il provient et le message personnel.

Il existe deux formats :

• La notification standard, un e-mail épuré avec texte et image de marque.
• La carte électronique, un format plus riche avec la photo de la personne honorée, une bordure stylisée, une couleur d'accentuation et votre ligne d'attribution. Le donateur opte pour la carte électronique sur le formulaire ; sinon, la notification standard est envoyée. Un seul des deux est envoyé par don.

Texte que vous contrôlez, par type de don commémoratif

Les dons commémoratifs doivent être traités avec soin, et les dons de célébration doivent être joyeux. Ainsi, l'objet, le titre, le sous-titre et la formule de politesse finale peuvent tous être définis par type de don commémoratif, dans Paramètres > Carte électronique.

• Définissez un objet différent pour « À la mémoire de », « En l'honneur de » et « Au nom de ».
• Choisissez une couleur d'accentuation pour correspondre au ton.
• Utilisez le bouton Envoyer une carte électronique test pour prévisualiser exactement ce que reçoit un destinataire avant qu'un donateur n'en déclenche une.

Le nom d'expéditeur, l'e-mail d'expéditeur, l'objet et le corps de la notification standard se trouvent dans Paramètres > E-mails, avec également un texte par type de don commémoratif.

Renvoi et consentement

La notification est toujours soumise au consentement. Si le donateur n'a pas confirmé avoir l'autorisation de contacter le destinataire, rien n'est envoyé, même si une adresse e-mail a été saisie. Vous pouvez renvoyer une notification à tout moment depuis le rapport des dons commémoratifs et utiliser l'envoi test pour vérifier votre texte.

Le résumé familial

Pour les personnes honorées ayant des contacts familiaux qui ont choisi de recevoir des informations, Tributes peut envoyer un résumé familial périodique, un aperçu des dons faits au nom de leur proche sur une période donnée.

Dans Paramètres > E-mails, choisissez la planification :

• Désactivé (par défaut), Hebdomadaire, Bi-hebdomadaire, ou Mensuel.
• Le jour de la semaine où le résumé est envoyé.
• L'objet.

Le contenu du résumé respecte les choix de confidentialité, ainsi les dons anonymes et réservés à la famille sont résumés de manière appropriée. Chaque résumé inclut un lien de désinscription en un clic, et un contact ne le reçoit que si vous l'avez ajouté sur le dossier de la personne honorée.

Sections commémoratives sur les reçus

Les détails commémoratifs sont directement intégrés au reçu du donateur, de sorte que son dossier reflète exactement la personne honorée par son don.

• L'e-mail de reçu de don inclut une section commémorative avec le nom de la personne honorée, le type de don commémoratif et le message personnel.
• Si vous utilisez le module complémentaire Reçus PDF, le PDF généré inclut une section hommage formatée correspondante.

La confidentialité est respectée. Les choix anonymes et familiaux sont honorés sur le reçu, tout comme partout ailleurs.

Balises d'e-mail

Vos e-mails d'hommage et sections de reçu peuvent utiliser des balises de fusion aux côtés des balises standard de Charitable :

• {honoree_name} – la personne honorée.
• {tribute_type} et {tribute_label} – la dédicace, sous forme de slug et d'étiquette lisible.
• Balises Charitable standard telles que {donor_name}, {donation_amount}, et {campaign_name}.
• Balises de champs personnalisés pour tous les champs personnalisés d'hommage ou d'honoree que vous avez définis.

Conseils

• Utilisez Envoyer une e-carte test après avoir modifié votre texte. C'est le moyen le plus rapide de repérer une faute de frappe avant qu'une vraie famille ne la voie.
• Si les notifications n'arrivent pas, vérifiez trois choses : l'e-mail du destinataire est valide, le donateur a confirmé son consentement, et votre site peut envoyer des e-mails. Tributes utilise le système d'e-mail de Charitable, donc un plugin SMTP est fortement recommandé pour une livraison fiable.
• Le résumé familial est désactivé par défaut. Activez-le uniquement lorsque vous avez des contacts familiaux qui ont choisi de le recevoir.

---

Référence du développeur

Classes et ID d'e-mail

Tributes enregistre ses e-mails dans le système d'e-mail de Charitable, ils héritent donc du pipeline d'envoi avec ID de don et de l'interface utilisateur des paramètres d'administration.

E-mail	ID	Déclencheur
Notification d'hommage	notification_hommage	Achèvement du don, lorsqu'un destinataire et un consentement sont présents et que l'e-carte n'est pas choisie.
E-carte d'hommage	ecarte_hommage	Achèvement du don, lorsque le donateur a choisi l'e-carte. Remplace la notification.
Résumé familial	(programmé)	Un balayage Action Scheduler à l'horaire configuré.

Filtres de déclenchement d'envoi

Les deux envois passent par des filtres et la liste globale de désinscription, vous pouvez donc supprimer un envoi par programmation :

// Block the standard tribute notification for a specific donation.
add_filter( 'charitable_send_tribute_notification', function ( $send, $donation_id ) {
    return $send;
}, 10, 2 );

// Block the e-card.
add_filter( 'charitable_send_tribute_ecard', function ( $send, $donation_id ) {
    return $send;
}, 10, 2 );

Filtres de bande de reçu

La section hommage dans l'e-mail de reçu est contrôlée par ces filtres :

Filtre	Défaut	Objectif
email_reçu_activé_hommages_caritatifs	vrai	Afficher la section hommage dans l'e-mail de reçu.
afficher_photo_email_reçu_hommages_caritatifs	vrai	Inclure la photo de la personne honorée.
afficher_message_email_reçu_hommages_caritatifs	vrai	Inclure le message du donateur.
afficher_ecarte_email_reçu_hommages_caritatifs	vrai	Refléter le style de l'e-carte.
charitable_tributes_receipt_email_show_tribute_link	vrai	Lien vers la page d'hommage.

Modèles

Remplacez ceux de votre thème en utilisant le chargeur de modèles de Charitable :

• templates/emails/tribute-notification.php (et -plain.php)
• templates/emails/tribute-ecard.php
• templates/emails/family-digest.php (et -plain.php)

La durée de vie du jeton de désabonnement est filtrable via charitable_tributes_unsubscribe_token_max_age (30 jours par défaut). Consultez la Référence du développeur pour le hook d'intégration des reçus PDF.

Connexes

• L'expérience du don commémoratif : ce que voient les donateurs
• Comment créer une campagne hommage dans Charitable
• Pages et blocs de dons
• Dossiers de personnes honorées et le CRM
• Paramètres, intégrations et référence du développeur
• Guide des hommages caritatifs