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 !

Nouveau modèles

🤩 Nouveaux modèles de campagne Beacon avec bloc « Héros » !

Avec les nouveaux modèles de campagne Beacon pour Charitable Pro, vous pouvez lancer une page de collecte de fonds époustouflante sur toute la largeur qui capte instantanément l’attention des visiteurs au-dessus de la ligne de flottaison.

En-tête de la page de collecte de fonds pour Sauver le parc Maple Grove avec un widget de don et une petite photo carrée d'une miniature d'arbre ensoleillé à gauche.

🔦 Impact au-dessus de la ligne de flottaison : commencez avec une image principale sur toute la largeur, votre logo et votre objectif avec un widget de don directement sur la bannière afin que votre demande et votre élan soient enregistrés instantanément sans faire défiler.

📐 Deux mises en page flexibles : choisissez entre une mise en page structurée à deux colonnes pour le récit côte à côte et les détails de support, ou une vue épurée à une colonne conçue pour des récits longs et ininterrompus.

⚡ Champ Héros tout-en-un : alimenté par le nouveau champ Héros de campagne, réunissant les médias d’arrière-plan, les barres de progression en direct, les montants de don personnalisés et les onglets de dons récurrents dans un seul bloc cohérent qui peut être intégré dans n’importe quelle mise en page.

🎨 Correspondance automatique des thèmes : la bannière principale et le widget de don héritent automatiquement des couleurs de bouton et d’accent de votre thème de campagne, garantissant que l’ensemble de votre présentation reste magnifiquement fidèle à la marque sans toucher une ligne de CSS.

En savoir plus ici.

formulaire de don Fonctionnalité Nouveau

📝 Bloc de formulaire de don : Intégrez un formulaire de don fonctionnel n'importe où

Avec le nouveau bloc de formulaire de don pour Charitable Pro, vous pouvez placer un formulaire de don entièrement fonctionnel directement sur n'importe quelle page ou publication dans l'éditeur de blocs WordPress. Pas de redirections, pas de rechargements de page, et zéro friction entre la lecture de votre histoire et la contribution.

📝 Placez des formulaires n'importe où : Placez un formulaire fonctionnel directement sur votre page d'accueil, à l'intérieur d'une publication de blog axée sur l'histoire, sur une page de destination dédiée, ou dans une annonce de campagne.

🎯 Liaison dynamique de campagne : Choisissez facilement une campagne spécifique dans la barre latérale du bloc ou définissez-la pour qu'elle se lie automatiquement à la campagne en cours de visualisation.

📐 Vues de formulaire complètes vs minimales : Basculez entre une mise en page complète ou une vue minimale compacte pour s'adapter parfaitement aux barres latérales, aux colonnes étroites ou aux larges pages de destination.

🎨 Styles sans code ciblés : Personnalisez la typographie, l'espacement des conteneurs, le rayon des bordures, les boutons de montant et les couleurs d'accent indépendamment pour chaque instance de formulaire sans toucher une ligne de CSS.

En savoir plus ici.

ambassadeurs Nouveau

👤 Profils des créateurs : Mettez un visage derrière chaque campagne pair-à-pair

Ambassadors 3.3.0 propose désormais des profils de créateurs, offrant à vos supporters un espace public permanent et partageable qui transforme les collecteurs de fonds ponctuels en relations durables.

👤 Pages publiques des créateurs : Donnez à chaque collecteur de fonds une page de destination instantanée et soignée sur /creator/leur-nom/ pour présenter leur avatar personnalisé, leur biographie et une grille consultable de leurs campagnes.

📊 Preuve d'impact : Renforcez la confiance des donateurs en affichant les jalons de l'ensemble du site sur le profil, tels que le montant total collecté et le nombre total de donateurs.

💳 Cartes interactives au survol : Lorsque les donateurs survolent le nom d'un créateur sur une page de campagne, une carte compacte s'affiche avec sa biographie et ses identifiants sociaux au moment de la décision.

📍 Partage responsable de la localisation : Permettez aux créateurs d'indiquer en toute sécurité où se trouvent leurs supporters locaux en utilisant uniquement les détails de la ville, de l'État et du pays.

🛠️ Personnalisation en libre-service : Les collecteurs de fonds peuvent mettre à jour leurs propres profils et lier jusqu'à six réseaux sociaux directement depuis le hub Mes campagnes, ce qui vous fait gagner du temps d'administration.

Prêt à responsabiliser vos défenseurs ? Mettez à jour vers Ambassadors 3.3.0 et activez "Activer la page publique du créateur" dès aujourd'hui !

Amélioration Paiements

📱 Transformez les utilisateurs mobiles en donateurs : Découvrez la mise à niveau Mollie de Charitable

Vous perdez des supporters mobiles parce qu'ils détestent taper de longs numéros de carte sur leur téléphone ? L'intégration Mollie mise à jour de Charitable propose :

⚡ Paiement instantané via portefeuille : Permettez aux donateurs d'effectuer leurs dons instantanément en utilisant Apple Pay ou Google Pay avec une simple analyse faciale, une empreinte digitale ou un toucher.

💰 Pas de charge PCI supplémentaire : Évitez la vérification complexe du domaine et la conformité de sécurité, car toutes les transactions de portefeuille s'effectuent en toute sécurité via le paiement hébergé de Mollie.

🛠️ Routage personnalisé de l'annulation : Gardez l'expérience prévisible en renvoyant automatiquement les donateurs qui se retirent vers votre page d'annulation, ou utilisez des filtres de développeur pour les rediriger vers une page personnalisée.

Visitez cette page pour en savoir plus.

ambassadeurs amélioré Nouveau

Écrans de modération et d'annuaire dans Ambassadors 3.0

Ambassadors 3.0 propose de nouvelles fonctionnalités : écrans de modération et d'annuaire... voyez facilement ceux qui gagnent des dons sur votre réseau pair-à-pair, y compris les créateurs de campagnes qui pourraient avoir besoin d'être vérifiés, le tout en un seul endroit. Générez des rapports, envoyez des e-mails directement aux ambassadeurs et aux créateurs de campagnes, et plus encore.

🚀 Voyez quand les créateurs de campagnes et les ambassadeurs ont mis à jour leurs campagnes, ce que les donateurs/dons qu'ils ont apportés et plus encore.

🎉 Ajoutez manuellement des ambassadeurs et des créateurs de campagnes, et approuvez-les en un clic !

Visitez cette page pour en savoir plus.