Documentation Charitable

Apprenez à tirer le meilleur parti de Charitable grâce à des instructions claires, étape par étape.

Dons récurrents 2.0+

Vous voulez faciliter la gestion des dons récurrents pour vous et vos donateurs ?

La nouvelle extension Dons récurrents 2.0 dans Charitable est exactement ce qu'il vous faut ! Cette fonctionnalité puissante vous permet d'accepter, de gérer et de rendre compte des dons par abonnement sans effort.

Avec Charitable Pro version 2.0.0 et l'extension Dons récurrents, vous pouvez améliorer vos efforts de collecte de fonds en intégrant les dons récurrents dans n'importe laquelle de vos campagnes. Ce guide vous présentera les fonctionnalités clés, la configuration et les meilleures pratiques pour vous aider à tirer le meilleur parti des dons récurrents.

Disponible dans Charitable Pro 2.0.0+ (extension Dons récurrents).


Fonctionnalités clés

  • Acceptez des dons récurrents sur n'importe quelle campagne, avec des périodes et des montants flexibles.
  • Le mode Dons récurrents uniquement garantit que tous les dons sont des abonnements.
  • Le libre-service du donateur permet aux sympathisants de gérer et d'annuler leurs propres abonnements.
  • Notifications automatisées pour les paiements échoués.
  • Outils de reporting avancés, y compris des cartes récapitulatives MRR (Revenu Mensuel Récurrent).
  • Exportez les données des dons récurrents au format CSV.
  • Compatible avec les principales passerelles comme Stripe et PayPal.

Pourquoi utiliser les dons récurrents ?

Les donateurs récurrents ont tendance à contribuer beaucoup plus au fil du temps que les donateurs ponctuels. En utilisant l'extension Dons récurrents, vous pouvez offrir aux sympathisants un moyen simple de faire des dons durables, prévoir les flux de revenus pour votre organisation et utiliser des outils de reporting complets pour suivre la croissance et la rétention.


Voyez-le en action


Exigences

  • Charitable Pro (tout plan incluant l'extension Dons récurrents)
  • WordPress 5.9 ou version ultérieure
  • PHP 7.4 ou version ultérieure
  • Une passerelle de paiement prise en charge (Stripe ou PayPal) pour les renouvellements automatiques

Démarrage

Activation

  1. Connectez-vous à votre administration WordPress.
  2. Accédez à Charitable » Extensions.
  3. Trouvez Dons récurrents et cliquez sur Installer et activer.
  4. Une fois activées, de nouvelles options pour les dons récurrents seront disponibles dans le Constructeur de campagnes.

Comment utiliser les nouvelles fonctionnalités de dons récurrents

Activer les dons récurrents sur une campagne

Cliquez sur dons récurrents dans les paramètres
  1. Ouvrez le Constructeur de campagnes pour n'importe quelle campagne
  2. Accédez au panneau Paramètres
  3. Développez la section Dons récurrents
  4. Sélectionnez un mode dans le menu déroulant (voir Options de mode ci-dessous)
  5. Configurez les paramètres de période, de montant et de durée selon vos besoins
  6. Enregistrez ou publiez la campagne

Options de mode

ModeComportement
DésactivéAucune option récurrente n'est présentée aux donateurs
SimpleLes donateurs voient une case à cocher pour rendre leur don récurrent
AvancéLes donateurs choisissent entre un don unique et un don récurrent avec un sélecteur de période
Uniquement récurrentTous les dons doivent être récurrents ; l'option de don unique est masquée

Mode uniquement récurrent (nouveau dans la version 2.0.0) : La sélection de ce mode supprime entièrement l'option de don unique. Un avis apparaît sur le formulaire de don : « Tous les dons à cette campagne sont récurrents. » Utilisez ceci pour les clubs de dons mensuels, les fonds de fonctionnement ou toute campagne axée sur les dons durables.

Configuration de la période

Lorsque le mode récurrent est activé, vous pouvez définir :

  • Mode de période : Fixe (défini par l'administrateur) ou Variable (choisi par le donateur)
  • Période de don : Quotidienne, Hebdomadaire, Mensuelle, Trimestrielle, Semestrielle, Annuelle
  • Durée du don : Nombre de paiements récurrents (0 = illimité)

Tableau de bord du donateur

Les donateurs peuvent consulter et gérer leurs dons récurrents depuis le tableau de bord du donateur ou le shortcode [my_recurring_donations].

Annuler l'abonnement (nouveau dans la version 2.0.0)

Nouveaux dons récurrents dans le tableau de bord du donateur

Un lien Annuler apparaît dans le tableau des dons récurrents pour tout abonnement dont le statut est annulable (actif, en attente, en attente). Cliquer dessus affiche une invite de confirmation avant que l'annulation ne soit traitée.

Après l'annulation : – Le statut de l'abonnement est mis à jour à Annulé – Un avis de succès confirme l'action – Le donateur est redirigé vers le tableau de bord du donateur

Les abonnements dont le statut n'est pas annulable (terminé, expiré, déjà annulé) affichent un tiret dans la colonne Annuler.


E-mails

E-mail de paiement échoué (nouveau dans la version 2.0.0)

Un e-mail automatisé envoyé aux donateurs lorsqu'un paiement récurrent échoue. Il est déclenché lorsque le statut d'un abonnement passe à charitable-failed.

E-mail d'échec de paiement récurrent

Pour configurer :

  1. Allez dans Charitable » Paramètres » E-mails
  2. Localisez Paiement échoué et cliquez pour modifier
  3. Activez l'e-mail, personnalisez l'objet et le corps, puis enregistrez

Balises de fusion disponibles :

Balise de fusionDescription
{donor_first_name}Prénom du donateur
{donor_full_name}Nom complet du donateur
{campaign_name}Titre de la campagne
[charitable_email show=recurring_summary]Bloc récapitulatif de l'abonnement
{site_name}Le nom de votre site

L'e-mail est envoyé uniquement au donateur, pas à l'administrateur. Pour recevoir des copies d'administration, configurez un e-mail de notification distinct.

E-mail d'annulation de don récurrent

Envoyé au donateur lorsqu'un abonnement est annulé, que ce soit par le donateur ou par un administrateur. Configurable sur le même écran de paramètres E-mails.


Rapports

rapport de dons récurrents nouveau

Cartes récapitulatives MRR (nouveau dans la version 2.0.0)

Situé dans Charitable » Rapports » Avancé, sélectionnez Dons récurrents dans le menu déroulant du type de rapport.

Quatre cartes récapitulatives apparaissent en haut du rapport :

CarteDescription
Abonnements actifsNombre de tous les dons récurrents actuellement actifs
Revenu mensuel estimé (MRR)Tous les abonnements actifs normalisés en un chiffre mensuel
Nouveaux cette périodeAbonnements créés au cours de la période sélectionnée
Annulés cette périodeAbonnements annulés au cours de la période sélectionnée

Comment le MRR est calculé :

Le montant de chaque abonnement actif est multiplié par un facteur de période pour produire son équivalent mensuel :

PériodeFacteur mensuel
Journalier×30
Hebdomadaire×4,333
Mensuel×1
Trimestriel×0,333
Semestriel×0.167
Annuel×0.083

Les abonnements actifs et le MRR sont des chiffres globaux qui ne changent pas lorsque vous ajustez le filtre de date. Les nouveaux de la période et les annulés de la période reflètent la plage de dates sélectionnée.

Exportation des dons récurrents

Utilisez le bouton Exporter sur la page de liste d’administration des dons récurrents (Charitable » Dons récurrents) pour télécharger un CSV des résultats filtrés.


Raccourcis

[mes_dons_recurrents]

Affiche les dons récurrents du donateur actuel dans un tableau. Destiné à être utilisé sur une page de tableau de bord du donateur connecté.

ParamètreTypeDéfautDescription
id_campagneentier—Limiter aux dons pour une campagne spécifique
statutchaîne de caractèrestousFiltrer par statut du don

Personnalisation

Couleurs des badges de statut

Les badges de statut sont affichés sous forme de petites pastilles colorées dans le tableau de liste d’administration et dans les tableaux destinés aux donateurs.

StatutCouleur par défaut
ActifVert (#008000)
En attenteGris (#999)
TerminéBleu (#3fb8f5)
ÉchouéOrange (#f7a129)
AnnuléRouge (#ff0000)
En attenteBleu clair (#8bb0e7)
ExpiréJaune (#ffe14a)

Remplacement de modèles

Pour remplacer un modèle de dons récurrents, copiez le fichier du dossier templates/ du plugin dans votre thème sous charitable/ et modifiez-le selon vos besoins.


Dépannage

Le bouton Annuler n'apparaît pas dans le tableau de bord du donateur

Le bouton Annuler s'affiche uniquement pour les abonnements dont le statut est annulable (actif, en attente, suspendu). Si l'abonnement est déjà annulé, terminé ou expiré, aucun bouton ne s'affiche.

De plus, certaines passerelles de paiement ne prennent pas en charge l'annulation par programme. Pour les passerelles qui ne le prennent pas en charge, le bouton Annuler peut ne pas apparaître même pour les abonnements actifs.

L'e-mail « Paiement échoué » n'est pas envoyé

Vérifiez que l'e-mail est activé dans Charitable » Paramètres » E-mails. Vérifiez également que le statut de l'abonnement est mis à jour à charitable-failed lorsqu'un paiement échoue, car l'e-mail se déclenche lors de cette transition de statut.

Le MRR semble inférieur aux attentes

Le MRR n'inclut que les abonnements actifs. Les abonnements mis en pause, suspendus ou échoués ne sont pas inclus. Le chiffre est également une estimation basée sur les périodes de facturation indiquées, et non sur l'historique réel des paiements.

Le mode « Uniquement récurrent » affiche l'option « Paiement unique »

Videz le cache de votre navigateur et tous les plugins de mise en cache de pages. L'option de paiement unique est masquée via CSS et JavaScript dans le constructeur de campagne et le formulaire de don. Une couche de mise en cache servant une page obsolète peut afficher un balisage périmé.


Ressources pour les développeurs

Accroches et filtres

  • charitable_recurring_donation_modes – Filtre les options de mode de don récurrent disponibles
  • charitable_send_recurring_payment_failed – Contrôle si l'e-mail « Paiement échoué » est envoyé pour un don spécifique
  • charitable_process_cancellation_{gateway} – Logique d'annulation spécifique à la passerelle ; renvoie true pour confirmer le succès
  • charitable_recurring_cancel_redirect – Filtre l'URL de redirection après qu'un donateur annule un abonnement
  • charitable_recurring_my_recurring_donations_table_after_receipt – Action pour ajouter des colonnes au tableau des dons récurrents côté donateur

Fonctions utiles

  • charitable_recurring_get_recurring_donation( $donation_id ) – Renvoie un objet Charitable_Recurring_Donation
  • charitable_recurring_get_valid_donation_statuses() – Renvoie un tableau des clés et libellés de statut valides

Calcul du MRR

// Access MRR data programmatically
$report = Charitable_Report_Advanced_Recurring::get_instance();
$mrr_data = $report->get_mrr_data( $start_date, $end_date );
// Returns: active_count, mrr, new_count, cancelled_count

Ressources supplémentaires

/pattern cta

Vous avez encore des questions ? Nous sommes là pour vous aider !

Dernière modification :

Quoi de neuf dans Charitable

Voir les dernières mises à jour
🔔 Abonnez-vous pour recevoir nos dernières mises à jour
📧 Abonnez-vous aux e-mails

Abonnement par e-mail

Rejoignez notre newsletter

Nous ne vous enverrons pas de spam. Nous envoyons un e-mail uniquement lorsque nous pensons qu'il vous sera réellement utile. Désabonnez-vous à tout moment !

ambassadeurs Nouveau

🖨️ Présentation des prospectus et affiches : collectez des fonds loin de l'écran !

Une grande partie de la collecte de fonds de pair à pair se fait loin d'un écran : à la ligne d'arrivée d'un 5 km, sur un panneau d'affichage d'école, dans une cuisine de bureau. Charitable Ambassadors 3.4.7 ajoute 2 imprimables, un prospectus de collecte de fonds portant la propre histoire et le code QR de chaque collecteur de fonds, et une affiche de recrutement qui inscrit de nouveaux collecteurs de fonds. Les deux s'ouvrent comme une page Web normale et s'impriment directement depuis le navigateur. Pourquoi c'est important :

  • 🏁 Un prospectus pour chaque collecteur de fonds : Chacun porte la propre photo, histoire et objectif de ce collecteur de fonds, avec un code QR qui ouvre sa page plutôt que votre campagne principale.
  • 📌 Une affiche qui recrute : Elle affiche « Recrutement en cours » au-dessus du nom de votre campagne avec un grand code QR qui ouvre votre formulaire d'inscription, afin que quelqu'un puisse commencer à collecter des fonds sans attendre un lien de votre part.
  • 🪄 Aucun outil de conception nécessaire : Les deux imprimables s'affichent comme une page Web normale et s'impriment depuis le navigateur, sans plugin PDF et sans designer.
  • 📄 2 mises en page de prospectus : « À distribuer » contient l'histoire complète pour donner à vos amis et à votre famille, et « À afficher » contient un court message accrocheur avec 5 languettes détachables pour un panneau d'affichage.
  • 🛡️ Désactivé jusqu'à ce que vous l'activiez : Les prospectus restent désactivés après la mise à jour jusqu'à ce que vous les activiez sous Charitable » Ambassadeurs » Autre » Prospectus, et seul le propriétaire ou un administrateur peut en ouvrir un.

Consultez notre annonce ici.

Amélioration Paiements

💸 Introduction des tarifs échelonnés pour l'allègement des frais : Adaptez la demande au don !

L'allègement des frais pose une courte question à vos donateurs lors du paiement : souhaitez-vous couvrir les frais de traitement de ce don ? Jusqu'à présent, cette question utilisait un taux unique pour chaque don sur une passerelle, de sorte qu'un don de 10 $ et un don de 500 $ se voyaient demander le même pourcentage. L'allègement des frais 1.3.0 vous permet de définir autant de tranches de dons que vous le souhaitez, chacune portant son propre taux. Pourquoi c'est important :

  • 🪙 Plus doux pour les petits dons : Un coût de transaction fixe représente une part beaucoup plus importante d'un don de 10 $ que d'un don de 500 $, les tranches vous permettent donc de demander moins en bas.
  • 🎚️ Autant de tranches que nécessaire : Chaque tranche porte son propre pourcentage et son propre montant fixe, et la tranche supérieure s'exécute sans limite supérieure.
  • 🛑 Un plafond facultatif : Un champ de frais maximum empêche qu'un donateur ne se voie demander plus qu'un nombre que vous choisissez, quel que soit le montant du don.
  • 🔌 Défini par passerelle de paiement : Stripe peut fonctionner avec quatre tranches tandis que Windcave et Payfast restent sur un taux unique, car les tranches appartiennent à une passerelle et non à l'ensemble de votre site.
  • 🛡️ Rien ne change tant que vous ne le décidez pas : Vos taux actuels restent exactement les mêmes jusqu'à ce que vous activiez « Utiliser les tarifs échelonnés » sous Charitable » Paramètres » Avancé » Allègement des frais.

Consultez notre annonce ici.

Dons Amélioration

📊 Votre tableau de bord Pro peut désormais comparer, exporter et évaluer !

La plupart des tableaux de bord de collecte de fonds vous indiquent seulement combien vous avez collecté. Charitable Pro 1.8.19 reconstruit le tableau de bord et la Vue d'ensemble des rapports autour des questions les plus difficiles : si quelque chose ne fonctionne pas, si cette période a été meilleure que la précédente, et quel changement unique ferait la plus grande différence aujourd'hui. Pourquoi c'est important :

  • 📈 Chaque chiffre a une tendance : Choisissez une période et les vignettes ainsi que le graphique bougent ensemble, chaque total étant affiché par rapport à la période précédente.
  • 🗓️ Des graphiques lisibles : Les courtes périodes regroupent les dons jour par jour, tandis que les longues périodes regroupent par semaine ou par mois, de sorte qu'une année complète se lit comme une courbe au lieu d'une ligne plate.
  • 🔀 Comparez n'importe quelles 2 périodes : Pas seulement consécutives, vous pouvez donc demander comment ce mois de décembre s'est comparé au mois de décembre dernier. C'est important car la collecte de fonds est saisonnière.
  • 📤 Exportez le résumé complet : Envoyez la vue d'ensemble complète en CSV ou PDF, prête pour un dossier de conseil d'administration ou un rapport de bailleur de fonds.
  • 🎯 Évaluez votre configuration gratuitement : Faites évaluer votre configuration de collecte de fonds, de sorte que le seul changement à faire ensuite soit celui que vous pouvez voir.

Consultez notre annonce ici.

Fonctionnalité Nouveau

🎟️ Présentation des Événements Caritatifs : Vendez des Billets dans Vos Campagnes !

La plupart des organisations à but non lucratif vendent des billets d'événement dans un outil et collectent des dons dans un autre, ce qui laisse deux ensembles de rapports et une correspondance manuelle à la fin de l'année. Événements Caritatifs réunit les deux, en vendant des billets via les mêmes formulaires de don et passerelles de paiement que vous utilisez déjà dans Charitable. Pourquoi c'est important :

  • 🎟️ Chaque billet est un don : Les ventes de billets passent par la passerelle que vous utilisez déjà et comptent pour l'objectif de la campagne, le tout géré sous Charitable » Événements.
  • 📱 Enregistrement par QR code depuis n'importe quel téléphone : Chaque participant reçoit son propre code QR sur le reçu, et les bénévoles scannent à l'entrée via un lien d'enregistrement qui ne nécessite aucun compte WordPress.
  • 🧾 Reçus prêts pour la déclaration de revenus : Attribuez à chaque type de billet une juste valeur marchande, et Charitable indiquera le montant déductible d'impôt correct sur chaque reçu de donateur.
  • 📋 Détails des participants au moment du paiement : Demandez à chaque invité son choix de repas, sa taille de chemise ou ses besoins d'accès, avec un enregistrement distinct du participant créé pour chaque billet.
  • 🗓️ Blocs et calendriers inclus : Trois blocs d'éditeur ainsi que la prise en charge de Sugar Calendar et The Events Calendar placent vos événements là où les supporters les recherchent déjà.

Consultez notre annonce ici.

ia Nouveau

🚀 Libérez la puissance de l'IA dans Charitable !

Votre assistant IA peut désormais créer, modifier et gérer vos campagnes de collecte de fonds Charitable directement — il suffit de demander. Avec Charitable Pro ajoutant la prise en charge de l'écriture pour l'API WordPress Abilities, des outils comme ChatGPT, Claude et Cursor peuvent gérer des actions administratives complètes en toute sécurité via MCP. Pourquoi c'est important :

  • 🤖 Création de campagnes en langage clair : Demandez à votre assistant un objectif comme « Mettre en place une collecte de fonds pour le refuge avec un objectif de 5 000 $ », et il crée une ébauche de campagne complète avec des paliers de dons suggérés.
  • 🎨 Modifications instantanées du formulaire de don : Ajoutez des champs personnalisés, changez les couleurs des boutons ou réorganisez les éléments sans avoir à modifier les paramètres du formulaire.
  • 📝 Enregistrement des dons hors ligne : Informez votre assistant des dons en espèces ou par chèque, et il associera les e-mails des donateurs et enregistrera les transactions dans votre historique.
  • 🛡️ Sécurité et contrôle par défaut : L'accès en écriture reste désactivé jusqu'à ce qu'il soit activé dans Charitable » Outils » AI MCP, maintenant la sécurité des rapports en lecture seule par défaut.
  • 📜 Journalisation complète des audits : Chaque modification apportée par un assistant IA est suivie dans Charitable » Outils » Journaux, vous savez donc toujours qui (ou quoi) a mis à jour votre site.

Consultez notre annonce ici.