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_campagneentierLimiter 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 !

Amélioration Paiements

💰 Acceptez les dons récurrents avec Windcave et Charitable

Un donateur configure son don une seule fois sur la page de paiement sécurisée de Windcave, et Charitable facture chaque renouvellement par la suite selon le calendrier établi. Pourquoi c'est important :

🏦 Organisations basées en Nouvelle-Zélande ou en Australie : dons mensuels sur la passerelle avec laquelle votre banque vous a déjà configuré, sans second processeur à intégrer.
⛪ Églises acceptant les dîmes et offrandes régulières : les membres de la congrégation définissent leur propre calendrier une fois, ce qui est le moyen le plus simple de lancer des dons d'église récurrents sans plateforme distincte.
🌏 Groupes avec des donateurs dans plusieurs devises : Windcave en gère plus de 20, ainsi un sympathisant peut donner dans la devise qu'il détient réellement.
📅 Fonds de fonctionnement plutôt que des campagnes ponctuelles : activez le mode « Récurrent uniquement » et l'option ponctuelle disparaît, de sorte que chaque don à cette campagne est un abonnement.
🧾 Équipes sans développeur attitré : 3 jeux d'identifiants collés sur une page de paramètres, et aucun code nulle part.

Consultez notre annonce ici.

automatisation mettre à jour

⚡ Générateur d'automatisation visuelle : Glisser-déposer sans code !

Charitable Automation Connect 2.3.0 introduit le Générateur d'automatisation visuelle, une zone d'édition plein écran qui présente chaque automatisation sous forme de flux de cartes connectées : un déclencheur, des conditions facultatives et une liste d'actions exécutées dans l'ordre.

🧩 De nombreuses actions, un seul déclencheur : Taguez un donateur, envoyez un e-mail, ajoutez une note et déclenchez un webhook à partir d'un seul événement, disposés dans n'importe quel ordre.

✉️ Agissez à l'intérieur de Charitable : Les nouvelles actions Envoyer un e-mail, Taguez un donateur et Ajoutez une note de donateur s'exécutent sans service externe requis.

🔤 Étiquettes de fusion : Personnalisez les e-mails et les notes avec des champs dynamiques tels que {first_name}, {total} et {campaign_name}.

🔁 Appliquer aux donateurs existants : Exécutez Taguez un donateur et Ajoutez une note de donateur sur les donateurs que vous avez déjà.

🖥️ Zone d'édition ou Simple : Changez de vue à tout moment, et les automatisations créées avant la version 2.3.0 continueront de fonctionner sans modification.

En savoir plus ici.

Intégration mis à jour

📬 Présentation de Brevo pour Charitable : Transformez automatiquement les donateurs en abonnés

Le moment où un donateur fait un don est le moment où il est le plus engagé. Avec la nouvelle intégration Brevo pour Charitable, vous pouvez transformer automatiquement ces donateurs ponctuels en abonnés à long terme sans toucher à une seule feuille de calcul.

Collectez simplement le consentement du donateur directement sur votre formulaire de don et lancez votre série de bienvenue immédiatement.

Quoi de neuf :

🔄 Synchronisation automatisée des abonnés : Les nouveaux donateurs qui donnent leur accord sont ajoutés directement à votre liste de contacts Brevo dès que leur paiement est traité, sans aucune exportation manuelle ni importation de CSV.

🎯 Contrôle granulaire du consentement et de l'opt-in : Personnalisez le libellé de votre case à cocher, choisissez si elle est cochée par défaut ou non, ou activez le double opt-in de Brevo pour maintenir votre liste propre et conforme.

📋 Mappage de liste par campagne : Dirigez les sympathisants vers votre liste d'e-mails globale ou mappez des campagnes spécifiques à des listes Brevo ciblées pour adapter vos messages de suivi.

⚡ Configuration en 5 minutes : Connectez-vous instantanément en collant votre clé API Brevo dans les paramètres de Newsletter, mappez vos champs de contact et commencez à construire votre liste d'e-mails en mode pilote automatique.

Prêt à développer votre liste de diffusion ? Brevo est disponible dès maintenant à partir du plan Charitable Plus — connectez votre compte dès aujourd'hui !

dons récurrents mis à jour

💳 Mises à jour de carte : Corrigez les cartes expirées sans perdre vos abonnements !

Les cartes de crédit expirées ou mises à jour sont l’une des plus grandes fuites silencieuses dans les collectes de fonds récurrentes. Avec les mises à jour de carte dans l’extension Dons récurrents, les donateurs peuvent désormais actualiser leurs informations de paiement directement, en conservant leur abonnement, leur calendrier et leur historique de dons complètement intacts.

Aucun plan annulé, aucun historique perdu et zéro casse-tête administratif pour votre équipe.

Quoi de neuf :

⚡ Assistance en 30 secondes : les donateurs obtiennent un bouton « Mettre à jour la carte » dédié dans leur tableau de bord qui ouvre le portail client sécurisé et conforme PCI de Stripe pour mettre à jour instantanément les détails de la carte.

🔒 Accès sécurisé et limité : limité exclusivement aux mises à jour de carte par défaut, les donateurs ne peuvent pas annuler ou modifier accidentellement leurs plans depuis le portail, en gardant vos webhooks et vos données synchronisés.

🤝 Assistance administrative : vous aidez un donateur par téléphone ? Ouvrez son portail Stripe sécurisé en un clic depuis votre écran d’administration ou générez un lien de mise à jour à usage unique à lui envoyer par e-mail.

📋 Piste d’audit automatique : chaque mise à jour de méthode de paiement est enregistrée automatiquement avec un horodatage dans les journaux système et le profil du donateur individuel.

Prêt à protéger vos revenus récurrents ? Obtenez le forfait Plus ou Pro et mettez à jour Dons récurrents vers la version 2.3.0+ et activez « Mettre à jour la méthode de paiement » dans vos Paramètres dès aujourd’hui !

Intégration constructeur de pages

Les fans de Divi se réjouissent ! Module natif de barre de progression de campagne Divi 5 !

Avec notre nouveau module natif Divi 5, vous pouvez ancrer vos microsites avec des statistiques de collecte de fonds en temps réel directement sur la toile visuelle. Voici comment cela fonctionne et pourquoi il est intéressant de l'activer dès aujourd'hui.

Créez des mises à jour de campagne VISUELLES ET EN DIRECT. Vous pouvez également :

📊 Barre de progression de campagne : Insérez une barre de progression en direct dans n'importe quelle mise en page Divi 5 et affichez la progression de l'objectif en temps réel.

🎨 Contrôles de style approfondis : Personnalisez facilement la couleur de la barre et de la piste, la hauteur et le rayon pour qu'ils correspondent parfaitement à votre marque.

👁️ Prêt pour le Visual Builder : Configurez et prévisualisez tout directement sur la toile Divi en tant que module de première classe.

🔁 Rendu identique : Le même moteur exact alimente ce module, ce qui signifie une conception cohérente sans correctifs hérités.

✅ Lancements plus rapides : Ne quittez jamais l'interface Divi 5 pour configurer des shortcodes ou deviner à quoi ressembleront vos étiquettes d'objectif.

En savoir plus ici.