Prérequis :
- Charitable Pro 1.8.16+
- Hommages caritatifs 1.0.0+
Cette page est la référence complète pour Hommages : chaque paramètre que vous pouvez modifier, comment il fonctionne avec les autres extensions Charitable, et la surface complète du développeur des hooks, actions AJAX, points de terminaison REST et modèles.
Si vous cherchez comment effectuer une tâche spécifique, les guides ciblés sont généralement un meilleur point de départ. Cette page est la carte de tout.
Paramètres des Hommages
Tous les paramètres se trouvent sous Charitable » Hommages » Paramètres, organisés en onglets.
Général
- Niveau de confidentialité par défaut – le niveau de confidentialité appliqué aux nouveaux hommagés (public, approbation familiale, membres ou lien privé).
- Libellé d’hommage par défaut – le libellé utilisé lorsqu’un type d’hommage n’en spécifie pas le sien.
- Modèle de formulaire – la disposition par défaut des champs d’hommage sur les formulaires de don.
- Ligne de contexte du donateur – le texte d’aide affiché au-dessus des champs d’hommage.
- Texte de consentement RGPD – le texte de consentement affiché lorsqu’un donateur choisit d’informer un proche.
Formulaire de don
- Modèle de formulaire – choisissez Blocs en ligne (champs d’hommage dans la section montant) ou Blocs par étape (champs d’hommage sur leur propre étape).
- Ligne de contexte du donateur – personnalisez le texte d’aide avec votre propre ton.
Intégrations
Une bascule pour chacune des cinq intégrations, vous pouvez donc en désactiver une. Voir la section Intégrations ci-dessous pour savoir ce que fait chacune d’elles.
E-mails des Hommages
- Activez et configurez la notification d’hommage, y compris le nom d’expéditeur, l’e-mail d’expéditeur, et les sujets et corps par type d’hommage.
- Configurez la planification du résumé familial (désactivé, hebdomadaire, bi-hebdomadaire ou mensuel), le jour d’envoi et son sujet.
Carte Électronique des Hommages
- Activez le format carte électronique plus riche et définissez son titre, sa ligne d’attribution et sa couleur d’accentuation.
- Définissez le sujet, le sourcil et le texte de clôture par type d’hommage.
- Envoyer une Carte Électronique Test pour prévisualiser le résultat.
Champs personnalisés
Un gestionnaire piloté par AJAX pour définir vos propres champs sur les hommagés et sur les campagnes d’hommage. Les champs personnalisés apparaissent sur les enregistrements et sont disponibles comme balises d’e-mail.
Les paramètres sont stockés dans l’option charitable_tributes_settings ; les définitions de champs personnalisés dans charitable_tributes_custom_fields.
Intégrations des Hommages avec d’autres extensions
Hommages détecte chaque extension associée et ajoute un comportement conscient des hommages. Si une extension n’est pas installée, cette intégration ne fait rien. Chacune peut être désactivée dans Paramètres > Intégrations.
| Module complémentaire | Ce que Hommages ajoute | Paramètre |
|---|---|---|
| Dons récurrents | L’option annuelle d’hommage qui transforme un don ponctuel en un don récurrent, avec les détails de l’hommage préservés à chaque renouvellement. | recurring_upsell |
| Mur des Donateurs(cœur) | Une étiquette « En mémoire de [Hommagé] » ajoutée au nom du donateur sur le mur des donateurs principal de votre site. | donor_wall_tribute_tag |
| DonorTrust | Supprime les badges DonorTrust sur les pages d'hommage, qui ont leur propre attribution de donateur. | donortrust_suppress |
| Reçus PDF | Une section d'hommage formatée dans le reçu PDF généré. Nécessite PDF Receipts 1.1.3+. | pdf_receipts_tribute_section |
| Connexion d'automatisation | Enregistre les événements d'hommage (don complété, campagne créée, personne honorée créée) pour les webhooks et les automatisations. | automation_connect_events |
Confidentialité et accessibilité
- RGPD – Tributes participe aux outils d'exportation et d'effacement des données personnelles de WordPress, de sorte qu'une demande de données inclut les informations d'hommage et de personne honorée liées à la personne.
- Consentement – les notifications familiales ne sont envoyées que lorsque le donateur confirme son consentement, et les résumés familiaux nécessitent une adhésion explicite.
- Accessibilité – les interfaces destinées aux donateurs sont construites selon les normes WCAG 2.1 AA.
Référence développeur pour Tributes
Actions
| Action | Se déclenche lorsque |
|---|---|
charitable_tributes_init | Le conteneur d'extensions est prêt. L'endroit le plus sûr pour enregistrer les extensions. |
charitable_tributes_campaign_created | Une campagne d'hommage est créée. |
charitable_tributes_donation_linked | Un don est lié à une personne honorée (événement de rétrocompatibilité). |
charitable_tributes_donation_completed | Un don d'hommage est complété (événement canonique, charge utile large). |
charitable_tributes_donation_refunded | Un don d'hommage est remboursé. |
charitable_tributes_honoree_created | Un enregistrement de personne honorée est créé. |
charitable_tributes_honoree_merged | Deux personnes honorées sont fusionnées. |
charitable_tributes_annual_reminder_sent | Un rappel annuel de don est envoyé. |
charitable_tributes_family_digest_sent | Un e-mail récapitulatif familial est envoyé. |
charitable_tributes_notification_send_failed | Une notification ou une e-carte envoyée lance (payload : ID du don + Throwable). |
Le payload charitable_tributes_donation_completed :
add_action( 'charitable_tributes_donation_completed', function ( $donation_id, $data ) {
// $data: donation_id, honoree_id, campaign_id, amount, currency,
// tribute_type, donor_id, donor_display
}, 10, 2 );Filtres
| Filtre | Défaut | Objectif |
|---|---|---|
charitable_tributes_admin_tabs | tableau | Modifier la liste des onglets de la page d'administration. |
charitable_tributes_admin_sub_tabs | tableau | Modifier les sous-onglets des paramètres. |
charitable_tributes_templates | tableau | Enregistrer les modèles d'hommage personnalisés. |
charitable_tributes_url_base | tribute | Modifier le slug de réécriture pour les URL d'hommage et de récipiendaire. |
charitable_tributes_type_options | tableau | Filtrer les types d'hommage disponibles, éventuellement par campagne. |
charitable_tributes_message_max_length | 500 | Limite de caractères du message du donateur. |
charitable_tributes_hide_donor_comment | faux | Masquer le champ du message du donateur. |
charitable_tributes_honoree_context_fallback | context | Fournir le contexte du récipiendaire pour les blocs sans récipiendaire explicite. |
charitable_tributes_unsubscribe_token_max_age | 30 jours | Durée de vie des jetons de désabonnement. |
charitable_tributes_receipt_email_enabled | vrai | Afficher la section hommage dans les e-mails de reçu. |
charitable_tributes_receipt_email_show_photo | vrai | Inclure la photo du récipiendaire sur le reçu. |
charitable_tributes_receipt_email_show_message | vrai | Inclure le message du donateur sur le reçu. |
charitable_tributes_receipt_email_show_ecard | vrai | Refléter le style de la carte électronique sur le reçu. |
charitable_tributes_receipt_email_show_tribute_link | vrai | Lien vers la page d'hommage depuis le reçu. |
charitable_send_tribute_notification | vrai | Contrôler la notification standard par don. |
charitable_send_tribute_ecard | vrai | Contrôler la carte électronique par don. |
Points de terminaison AJAX
Tous sont wp_ajax_ uniquement (pas d'accès public), nécessitent un nonce et vérifient la capacité manage_charitable_settings.
| Action | Objectif |
|---|---|
charitable_tributes_wizard_open | Initialiser la session de l'assistant. |
charitable_tributes_wizard_step | Afficher et gérer une étape de l'assistant. |
charitable_tributes_wizard_set_campaign_status | Publier ou brouillonner la nouvelle campagne. |
charitable_tributes_wizard_discard | Supprimer la session de l'assistant. |
charitable_tributes_save_honoree_notes | Enregistrer les notes de l'administrateur sur un hommage. |
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 hommages. |
charitable_tributes_honoree_search | Rechercher des hommages par nom. |
charitable_tributes_dismiss_banner | Rejeter la bannière de bienvenue. |
charitable_tributes_ecard_test_action | Envoyer une e-carte de test. |
API REST
Points d'accès en lecture seule pour synchroniser les données d'hommage dans un CRM externe ou une pile de rapports.
Campagnes d'hommage – GET /wp-json/wp/v2/tribute_campaigns
| Paramètre de requête | Exemple | Filtres par |
|---|---|---|
tribute_type | in-memory-of | Type d'hommage. |
template | in-loving-memory | Modèle utilisé. |
honoree | 123 | ID de l'hommage. |
date_from / date_to | 2026-01-01 | Plage de dates. |
Chaque réponse inclut un objet tribute_meta avec honoree_id, template_id, total_raised, et donor_count.
Hommages – GET /wp-json/wp/v2/charitable-honorees
| Paramètre de requête | Exemple | Filtres par |
|---|---|---|
template | in-loving-memory | Modèle d'hommage lié. |
has_donations | 1 ou 0 | Uniquement les hommages avec ou sans dons. |
Chaque réponse inclut un objet tribute_meta avec total_raised, donor_count, gift_count, last_donation_at, et linked_campaigns_count.
Schéma de base de données
| Table | Objectif |
|---|---|
wp_charitable_honoree_donations | Une ligne dénormalisée par don, liée à un hommage. |
wp_charitable_honoree_family_contacts | Enregistrements de contacts familiaux. |
wp_charitable_honoree_totals_cache | Totaux par récipiendaire mis en cache. |
Utilisez les dépôts plutôt que d'interroger directement :
use Charitable\Pro\Tributes\Repositories\Repositories;
Repositories::honorees();
Repositories::honoree_donations();
Repositories::honoree_family_contacts();
Repositories::honoree_totals_cache();Modèles
Remplacez l'un d'entre eux en le copiant dans votre thème, en suivant la convention de chargement des modèles de Charitable :
templates/single-tribute_campaign.phptemplates/emails/tribute-notification.php(et-plain.php)templates/emails/tribute-ecard.phptemplates/emails/family-digest.php(et-plain.php)blocks/<block>/render.phppour chacun des six blocs.
Événements Automation Connect
Lorsque Automation Connect est actif, Tributes enregistre ses événements via le filtre charitable_automation_connect_events, exposant les événements de don de tribut complété, de campagne de tribut créée et de nouveau récipiendaire pour les automatisations sans code.
Connexes
- Guide des hommages caritatifs
- Création de campagnes d'hommage
- Dossiers de personnes honorées et le CRM
- E-mails d'hommage, cartes électroniques et reçus
Liens utiles
🤝 Obtenez de l’aide quand vous en avez besoin
📑 Trouvez le guide dont vous avez besoin
Parcourez le Hub de documentation →
⬇️ Téléchargez des stratégies éprouvées, des idées de campagnes et des outils d'experts
Obtenez le kit de collecte de fonds →
💸 Obtenez des ressources gratuites pour la collecte de fonds
Rendez-vous sur le Hub de collecte de fonds Charitable →
🤔 Des questions sur Charitable ?
FAQ Charitable →
Besoin d'aide pour comprendre les termes et le jargon des organisations à but non lucratif ?
Consultez notre glossaire des organisations à but non lucratif→
