Prérequis : 

Charitable Pro 1.8.16+
Hommages Caritatifs 1.0.0+

C'est la fonctionnalité qui distingue Charitable Tributes d'une simple case à cocher d'hommage. Lorsqu'un donateur honore quelqu'un, Tributes crée un enregistrement permanent de la personne honorée dans votre tableau de bord. Chaque personne honorée a des totaux cumulés, la liste des donateurs qui ont donné en son nom, les messages laissés pour elle, et les contacts familiaux que vous choisissez de conserver.

Ainsi, lorsque 10 personnes donnent à la mémoire de la même personne, vous voyez une seule personne honorée avec le tableau complet, et non 10 dons déconnectés.

Le répertoire des personnes honorées

Ouvrez Charitable » Hommages » Personnes honorées pour voir toutes les personnes honorées sur votre site. Le répertoire est une liste consultable et filtrable avec les chiffres qui vous importent dans chaque ligne.

Chaque ligne affiche :

• Le nom et la photo de la personne honorée.
• Dons – le nombre de dons effectués en son nom.
• Total collecté – le total cumulé.
• Hommages liés – les campagnes d'hommage connectées à cette personne honorée.
• Statut – si l'enregistrement est publié, un brouillon ou dans la corbeille.

Vous pouvez rechercher par nom, filtrer par le modèle utilisé pour créer la personne honorée, et cliquer sur n'importe quel nom pour ouvrir l'enregistrement complet.

À l'intérieur d'un enregistrement de personne honorée

Cliquez sur une personne honorée pour ouvrir sa page de détails. Elle rassemble tout sur la personne et les dons faits en son nom.

Totaux en un coup d'œil

Le haut de l'enregistrement affiche les chiffres clés : total collecté, nombre de dons, nombre de donateurs uniques et le don le plus récent. Ceux-ci proviennent d'une table de totaux mis en cache, de sorte que la page reste rapide même pour une personne honorée avec des centaines de dons.

Les dons faits en son nom

Un tableau liste chaque don lié à cette personne honorée, avec le nom d'affichage du donateur (respectant les choix d'anonymat et de messages uniquement à la famille), le montant, la date et le message personnel. C'est l'historique des dons pour cette personne en un seul endroit.

Contacts familiaux

Les contacts familiaux sont conservés séparément des donateurs, vous pouvez donc contacter un proche directement sans le confondre avec les personnes qui ont donné.

Ajoutez un contact avec son nom, son e-mail, son adresse postale et sa relation avec la personne honorée. Vous choisissez si chaque contact est inscrit à la digest familial, le résumé périodique des dons faits au nom de son proche. Les contacts peuvent être modifiés ou supprimés à tout moment.

Notes d'administration

Chaque enregistrement dispose d'une zone de notes privées pour votre équipe, sauvegardée au fur et à mesure de la frappe. Utilisez-la pour le contexte qui ne doit pas être public, comme la manière dont la famille préfère être contactée.

Niveaux de confidentialité

Chaque personne honorée a un niveau de confidentialité qui contrôle qui peut voir l'hommage et ses messages de donateurs.

Niveau	Qui peut le voir
Public	Tout le monde. La page d'hommage et les messages des donateurs sont visibles par tous.
Approbation familiale	Les messages sont conservés jusqu'à ce qu'un contact familial les approuve.
Membres	Uniquement les utilisateurs connectés sur votre site.
Lien privé	Uniquement les personnes possédant le lien privé. L'hommage n'est pas répertorié publiquement.

Vous définissez le niveau de confidentialité par défaut dans Paramètres, et vous pouvez le remplacer par hommagé.

Fusionner les hommagés en double

Parfois, la même personne se retrouve avec deux enregistrements, généralement parce que les donateurs ont orthographié le nom différemment. L'outil de fusion les combine en un seul.

La fusion déplace tous les dons de l'hommagé source, les campagnes liées et les contacts familiaux vers l'enregistrement cible, puis recalcule les totaux. Choisissez l'enregistrement que vous souhaitez conserver comme cible, et l'autre y sera intégré.

Champs personnalisés

Si les détails intégrés de l'hommagé ne suffisent pas, vous pouvez définir les vôtres. Dans Paramètres > Champs personnalisés, ajoutez des champs pour les hommagés et pour les campagnes d'hommage, tels que « Section du cimetière » ou « Organisation caritative préférée ». Vos champs personnalisés apparaissent sur les enregistrements et sont disponibles en tant que balises d'e-mail.

Rapports et classement des hommagés

L'onglet Rapports transforme vos dons d'hommage en informations.

• Le rapport des dons d'hommage liste les dons d'hommage, filtrables par type d'hommage, modèle, statut et période.
• Le classement des hommagés classe les hommagés par montant collecté ou par nombre de dons, afin que vous puissiez voir quels hommages résonnent.
• L'export CSV vous permet de télécharger les donateurs et les détails de tout hommagé ou rapport pour vos dossiers ou une feuille de calcul.

Conseils

• Un hommagé est créé automatiquement la première fois qu'un don est effectué en son nom. Vous n'avez pas besoin de les configurer à l'avance.
• Si deux hommagés semblent être des doublons, vérifiez l'orthographe du nom sur les dons liés avant de fusionner, afin de conserver l'enregistrement le plus propre comme cible.
• Les contacts familiaux ne reçoivent jamais d'e-mail, sauf si vous les inscrivez à la lettre d'information familiale, donc ajouter un contact uniquement pour vos dossiers est sans danger.

---

Référence du développeur

Le modèle d'hommagé

Les hommagés sont le type de publication charitable_honoree, enrichi de ces propriétés (voir src/Models/Honoree.php) :

Propriété	Signification
name, nickname	Nom d'affichage et surnom facultatif.
dob, dod	Date de naissance et date de décès (ISO).
photo_attachment_id	Photo de l'hommagé.
relationship_to_org	Comment l'hommagé est lié à votre cause.
privacy_level	public, family-approval, members, ou tokenized.
display_preference	full ou first-name-only.
entity_type	person, pet, ou cause (extensible).
family_approval_status	not-required, pending, ou approved.
tokenized_slug	Le jeton de lien privé pour la confidentialité tokenized.
custom_fields	Valeurs des champs personnalisés définis par l'administrateur.

Tables personnalisées

Table	Objectif
wp_charitable_honoree_donations	Une ligne par don, liée à un récipiendaire (affichage du donateur, montant, message, statut).
wp_charitable_honoree_family_contacts	Coordonnées familiales (nom, e-mail, adresse postale, relation, indicateurs d'opt-in).
wp_charitable_honoree_totals_cache	Totaux mis en cache par récipiendaire (total collecté, nombre de donateurs, nombre de dons).

Accédez-y via les dépôts plutôt que par SQL brut :

use Charitable\Pro\Tributes\Repositories\Repositories;

$donations = Repositories::honoree_donations();
$contacts  = Repositories::honoree_family_contacts();
$totals    = Repositories::honoree_totals_cache();

Points de terminaison AJAX

Tous nécessitent un nonce et la capacité manage_charitable_settings.

Action	Objectif
charitable_tributes_save_honoree_notes	Enregistrer les notes privées de l'administrateur.
charitable_tributes_save_custom_fields	Enregistrer les définitions des champs personnalisés.
charitable_tributes_add_family_contact	Ajouter un contact familial.
charitable_tributes_update_family_contact	Mettre à jour un contact familial.
charitable_tributes_delete_family_contact	Supprimer un contact familial.
charitable_tributes_honoree_merge	Fusionner deux enregistrements d'hommage.
charitable_tributes_honoree_search	Rechercher des hommages par nom (utilisé par l'autocomplétion).

Événements

Le CRM émet des actions auxquelles vous pouvez vous connecter, notamment charitable_tributes_honoree_created, charitable_tributes_donation_linked, charitable_tributes_honoree_merged, et charitable_tributes_donation_refunded. Consultez les charges utiles complètes dans la Référence du développeur.

Connexes

• L'expérience de don d'hommage
• E-mails d'hommage, cartes électroniques et reçus
• Pages et blocs d'hommage
• Paramètres, intégrations et référence du développeur