Prérequis : 

• Charitable Pro 1.8.16+
• Hommages caritatifs 1.0.0+

Certains des dons les plus significatifs que votre organisation à but non lucratif recevra jamais sont faits au nom de quelqu'un. Un donateur donne en mémoire d'un parent, en l'honneur de la guérison d'un ami, ou au nom d'un couple qui célèbre une étape importante.  Hommages caritatifs  capture cette intention directement sur le formulaire de don, puis fait quelque chose que la plupart des plugins de don ne peuvent pas faire : il se souvient de la personne honorée.

Chaque personne honorée devient un enregistrement réel dans votre tableau de bord, avec les totaux cumulés, les donateurs qui ont donné, et la famille que vous pouvez tenir informée. Tout fonctionne dans WordPress, aux côtés des formulaires et des rapports que vous utilisez déjà, sans abonnement séparé et sans frais par don.

Ce guide est le point de départ. Il explique l'idée principale, vous aide à l'installer et vous fait visiter le tableau de bord des Hommages afin que vous sachiez où tout se trouve. À partir de là, vous pouvez suivre les liens vers les pages d'aide plus approfondies.

L'idée à comprendre d'abord : hommages vs. personnes honorées

Presque tout dans ce module complémentaire a du sens une fois que vous comprenez la différence entre un hommage et une personne honorée.

• Un hommage est la dédicace qu'un donateur ajoute à un don, comme « En mémoire de ». Il appartient à un don unique.
• Une personne honorée est la personne qui est honorée. Hommages stocke chaque personne honorée comme son propre enregistrement.

Ainsi, lorsque dix personnes donnent en mémoire de la même personne, vous n'obtenez pas dix dons déconnectés. Vous obtenez une personne honorée avec une vue d'ensemble complète : le total collecté en son nom, chaque donateur qui a donné, les messages laissés pour elle, et les contacts familiaux que vous choisissez de tenir informés. C'est ce qui distingue Charitable Tributes d'une simple case à cocher « est-ce un hommage ? oui/non ».

Ce que vous pouvez faire avec Hommages

• Ajoutez une option d'hommage à n'importe quel formulaire de don, avec « En mémoire de », « En l'honneur de », « Au nom de », et vos propres types d'hommages personnalisés.
• Conservez les enregistrements des personnes honorées avec photos, dates, totaux, historique des donateurs et contacts familiaux.
• Lancez une campagne d'hommage dédiée en moins de deux minutes avec l'assistant de configuration guidé.
• Notifiez automatiquement un proche avec une carte électronique d'hommage lorsqu'un don est effectué.
• Créez de belles pages commémoratives et d'hommage avec six blocs dédiés.
• Transformez un hommage ponctuel en un don annuel à une date choisie par le donateur.
• Incluez une section d'hommage sur les reçus de don et les reçus PDF.
• Suivez tout avec un rapport des dons d'hommage et un classement des personnes honorées.

Exigences

• WordPress 6.2 ou ultérieure
• PHP 8.0 ou supérieur
• Charitable avec une licence Charitable Pro active (dernière version recommandée)
• Dons récurrents de Charitable, pour les dons d'hommage annuels (facultatif)
• Reçus PDF de Charitable, pour la section d'hommage sur les reçus PDF (facultatif)

Installation et activation des Hommages

Les Hommages s'installent comme tous les autres modules complémentaires de Charitable.

1. Dans votre administration WordPress, allez à Charitable » Modules complémentaires.
2. Trouvez Tributes et cliquez sur Install, puis Activate. Si vous avez téléchargé le module complémentaire au format ZIP, vous pouvez également l'installer depuis Plugins » Add New » Upload Plugin.
3. Une fois actif, un nouveau menu Tributes apparaît sous Charitable dans la barre latérale de votre administration.

C'est tout le paramétrage requis pour commencer. Le module complémentaire est livré avec des paramètres par défaut raisonnables, vous pouvez donc créer votre première campagne de témoignages immédiatement et ajuster les paramètres plus tard.

Une visite du tableau de bord Tributes

Ouvrez WordPress Admin » Charitable » Tributes et vous arriverez sur un tableau de bord à onglets. Voici à quoi sert chaque onglet.

Onglet	À quoi ça sert
Aperçu	Votre écran d'accueil. Chiffres clés pour le montant collecté, les dons, les donateurs et les personnes honorées, plus l'activité récente.
Annuaire	Chaque campagne de témoignages sur votre site, consultable et filtrable par type de témoignage, modèle, statut et période.
Personnes honorées	Le répertoire des personnes honorées. Parcourez toutes les personnes honorées, voyez les totaux en un coup d'œil et explorez chaque enregistrement.
Rapports	Analyses spécifiques aux témoignages, y compris le classement des personnes honorées par montant collecté ou nombre de dons.
Modèles	Les points de départ prêts à l'emploi que l'assistant de configuration utilise, tels que "En mémoire affectueuse" et "En remplacement de fleurs".
Paramètres	Tout ce que vous pouvez configurer : le formulaire de don, les intégrations, les e-mails, les cartes électroniques et les champs personnalisés.

Pour démarrer une nouvelle campagne d'hommage depuis n'importe quel endroit de cette zone, cliquez sur le bouton Nouvelle campagne d'hommage en haut de la page. Cela ouvrira l'assistant de configuration décrit dans Création de campagnes d'hommage.

Où aller ensuite

Tributes est un module complémentaire volumineux, la documentation est donc divisée en guides ciblés. Choisissez celui qui correspond à ce que vous voulez faire :

• Création de campagnes de témoignages – exécutez l'assistant de configuration, choisissez un modèle et publiez une page de témoignages dédiée, ou ajoutez l'option de témoignages à une campagne que vous avez déjà.
• L'expérience de don de témoignages – ce que les donateurs voient et choisissent exactement lorsqu'ils font un don de témoignage.
• Enregistrements de personnes honorées et CRM – le répertoire des personnes honorées, les pages de détails, les contacts familiaux, les niveaux de confidentialité, la fusion et les rapports.
• E-mails, cartes électroniques et reçus de témoignages – cartes électroniques de notification, résumé familial et sections de témoignages sur les reçus.
• Pages et blocs de témoignages – les six blocs et le shortcode pour la création de pages commémoratives et de témoignages.
• Paramètres, intégrations et référence développeur – chaque paramètre, les intégrations du module complémentaire et la référence complète des hooks, REST et modèles.

Une première utilisation typique

Si vous préférez vous lancer directement, voici le parcours que la plupart des organisations empruntent :

1. Activez Tributes aux côtés de Charitable Pro.
2. Cliquez sur New Tribute Campaign et suivez l'assistant pour créer votre première page de témoignages dédiée, ou activez l'option de témoignages pour une campagne existante.
3. Partagez la page, ou laissez les donateurs trouver votre formulaire existant. Les donateurs choisissent un type d'hommage, nomment la personne honorée et ajoutent un message personnel.
4. Les hommages créent le dossier de la personne honorée et, si un destinataire a été nommé, notifient automatiquement la famille.
5. Suivez les totaux, les donateurs et les messages depuis le tableau de bord des hommages.

---

Référence du développeur

Le reste de cette page est une brève présentation pour les développeurs. La référence complète des hooks, REST et modèles se trouve sur la page Paramètres, intégrations et référence du développeur .

Démarrage et version

• Domaine de texte : charitable-tributes (les traductions sont chargées depuis i18n/languages/).
• Constante de version : CHARITABLE_TRIBUTES_VERSION.
• Le module complémentaire démarre sur l'action charitable_start de Charitable et déclenche charitable_tributes_init une fois son conteneur prêt, en passant l'objet conteneur. C'est le hook le plus sûr pour attacher vos propres services.

add_action( 'charitable_tributes_init', function ( $container ) {
    // The addon is fully loaded. Register your extensions here.
} );

Types de publication

Tributes enregistre deux types de publication personnalisés publics :

Type de publication	Objectif	Base d'URL
campagne_hommage	Une page dédiée à l'hommage ou au mémorial.	/hommage/{slug}/
personne_honoree_par_dons	Un dossier de personne honorée (une personne, un animal de compagnie ou une cause honorée).	/tribute/{slug}/ (filtrable)

La base d'URL de la personne honorée est filtrable :

add_filter( 'charitable_tributes_url_base', function () {
    return 'in-memory-of';
} );

Tables personnalisées

Trois tables personnalisées prennent en charge les fonctionnalités du CRM. Vous interrogez rarement ces tables directement, mais elles sont documentées dans la Référence du développeur :

• wp_charitable_honoree_donations – une ligne dénormalisée par don, liée à une personne honorée.
• wp_charitable_honoree_family_contacts – dossiers de contacts des membres de la famille.
• wp_charitable_honoree_totals_cache – totaux mis en cache par personne honorée.