Documentation Charitable

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

Modification des montants et des périodes de facturation des dons récurrents

Prérequis :

  • Charitable Pro 1.8.16+
  • Dons récurrents de bienfaisance 2.1.0+

La situation d'un donateur change. Peut-être que le mois prochain sera difficile et qu'il voudra réduire son don mensuel de 50 $ à 25 $, ou qu'une subvention de contrepartie est arrivée et qu'il aimerait augmenter son don annuel. Avant Charitable Recurring 2.1, la seule façon de gérer cela était d'annuler l'abonnement et de demander au donateur d'en commencer un nouveau, ce qui entraîne la perte de l'historique des paiements et le risque que le don ne revienne jamais.

Vous pouvez maintenant mettre à jour le montant et la période de facturation d'un don récurrent actif directement depuis votre administration WordPress, et le changement est synchronisé automatiquement avec Stripe. Le même abonnement reste en place, l'historique des paiements est donc préservé et le donateur conserve sa date de début d'origine.

Vous pouvez appliquer un changement immédiatement, ou envoyer d'abord au donateur un lien d'approbation sécurisé. Chaque changement est consigné dans votre journal d'audit, et les changements que vous effectuez dans le tableau de bord Stripe sont automatiquement synchronisés avec Charitable.

La boîte Actions de don sur un don récurrent avec Mettre à jour l'abonnement sélectionné dans le menu déroulant et le bouton Mettre à jour l'abonnement en dessous

Quand l'utiliser

  • Un donateur demande de modifier son montant – mettez-le à jour en quelques secondes au lieu d'annuler et de réabonner.
  • Un donateur souhaite passer du mensuel à l'annuel (ou à toute autre période) – changez la période de facturation en place.
  • Un changement nécessite l'approbation du donateur – envoyez un e-mail d'approbation et laissez le donateur confirmer avant que quoi que ce soit ne se produise sur Stripe.
  • Quelqu'un a modifié l'abonnement dans le tableau de bord Stripe – Charitable récupère automatiquement le nouveau montant et la nouvelle période.
  • Vous avez besoin d'un enregistrement de qui a changé quoi – chaque mise à jour est consignée dans les journaux de Charitable avec l'ancienne valeur, la nouvelle valeur et qui l'a effectuée.

Où le trouver

Ouvrez le don récurrent que vous souhaitez modifier :

Administration WordPress > Dons > Dons récurrents > (cliquez sur le don)

La liste des Dons récurrents dans le menu Charitable, montrant les dons récurrents avec leurs filtres de statut

Dans la boîte Actions sur le don à droite, choisissez Mettre à jour l'abonnement dans le menu déroulant, puis cliquez sur le bouton Mettre à jour l'abonnement.

Le don doit utiliser la passerelle Stripe et être dans le statut Actif. Les abonnements mis en pause, annulés, terminés et en attente ne peuvent pas être modifiés, ce qui évite au donateur d'être surpris par un prélèvement inattendu.

Mise à jour d'un abonnement

La fenêtre Mettre à jour l'abonnement affiche l'abonnement actuel en haut, puis les champs que vous pouvez modifier.

La fenêtre Mettre à jour l'abonnement montrant l'abonnement actuel, le champ Nouveau montant, le menu déroulant Nouvelle période de facturation, les options Durée de l'abonnement et Mode de mise à jour, et la case à cocher de notification du donateur

1. Définir le nouveau montant et/ou la nouvelle période

  • Nouveau montant – entrez n'importe quelle valeur de 1,00 à (en théorie) 999999,99. Laissez-le inchangé pour conserver le montant actuel.
  • Nouvelle période de facturation – choisissez parmi quotidien, hebdomadaire, mensuel, trimestriel, semestriel ou annuel. Laissez la période actuelle pour la conserver.

Vous pouvez changer l'un ou l'autre. Le changement prend effet à la prochaine date de facturation du donateur ; son cycle actuel se termine normalement, et aucun prorata n'est appliqué.

2. Choisir comment le changement est appliqué

  • Appliquer immédiatement – le changement est envoyé à Stripe immédiatement.
  • Demander l'approbation du donateur – un changement en attente est stocké et le donateur reçoit un e-mail avec des liens sécurisés pour approuver et refuser. Rien ne change sur Stripe tant qu'il n'a pas approuvé.
La fenêtre Mettre à jour l'abonnement avec un nouveau montant de 40,00, une période de facturation Trimestrielle et Demander l'approbation du donateur sélectionnée

3. Décider s'il faut notifier le donateur

La case à cocher Notifier le donateur de ce changement est cochée par défaut. Lorsqu'elle est cochée, le donateur reçoit un e-mail « Abonnement mis à jour » avec l'ancien et le nouveau montant ou période. Décochez-la pour les ajustements en back-office dont le donateur n'a pas besoin d'être informé.

Lorsque vous cliquez sur Mettre à jour l'abonnement, vous verrez un message de succès et le total des dons sera mis à jour sur la page.

Le flux d'approbation du donateur

Lorsque vous choisissez Demander l'approbation du donateur, le donateur reçoit un e-mail avec deux liens : un pour approuver le changement et un pour le refuser.

L'e-mail de demande de modification d'abonnement qu'un donateur reçoit, avec un lien Approuver cette modification et un lien pour refuser la modification

Quelques points à connaître sur le fonctionnement des liens d'approbation :

  • Sécurisés et spécifiques au don. Chaque lien contient un jeton signé, lié à ce don exact. Un lien pour un don ne peut pas être utilisé pour un autre.
  • Ils expirent. Les liens d'approbation sont valides pendant 7 jours. Après cela, le lien cesse de fonctionner et vous devrez réémettre la demande.
  • Utilisation unique. Une fois que le donateur approuve ou refuse, le lien est utilisé. Cliquer à nouveau dessus n'a aucun effet.
  • Une nouvelle demande remplace une ancienne. Si vous émettez un deuxième changement alors qu'un est encore en attente, la nouvelle demande remplace l'ancienne et l'ancien lien cesse de fonctionner.

Si le donateur clique sur Approuver, le changement est envoyé à Stripe et le don est mis à jour. S'il clique sur Refuser, l'abonnement reste exactement le même et le changement en attente est annulé.

Modifications apportées dans le tableau de bord Stripe

Si vous (ou un membre de votre équipe) modifiez le montant ou la période de facturation d'un abonnement directement dans le tableau de bord Stripe, Charitable en est informé et met à jour le don local pour qu'il corresponde. Cela se fait via le webhook Stripe que vous avez déjà configuré, il n'y a donc rien de plus à mettre en place. Cela signifie que l'enregistrement du don dans WordPress reste précis, quelle que soit la provenance de la modification.

Lecture du journal d'audit

Chaque changement d'abonnement est enregistré dans vos journaux Charitable, qu'il provienne d'une mise à jour d'administrateur, d'une approbation de donateur ou du tableau de bord Stripe.

Administration WordPress » Charitable » Outils » Journaux

Chaque entrée enregistre l'ancienne valeur, la nouvelle valeur, qui a effectué le changement et quand. Vous pouvez filtrer par ID de don pour voir l'historique complet d'un seul abonnement.

L'e-mail de notification au donateur

Par défaut, les donateurs reçoivent un e-mail « Abonnement mis à jour » après un changement réussi, détaillant ce qui a changé. Vous pouvez le personnaliser ou le désactiver depuis :

Administration WordPress » Charitable » Paramètres » E-mails

La liste des paramètres des e-mails Charitable listant les e-mails du donateur Abonnement mis à jour et Demande de modification d'abonnement

Deux e-mails sont liés à cette fonctionnalité :

  • Abonnement mis à jour – envoyé au donateur après l'application d'un changement. Activé par défaut.
  • Demande de changement d'abonnement – l'e-mail de demande d'approbation, envoyé lorsque vous choisissez « Demander l'approbation du donateur ».

Cliquez sur l'un ou l'autre e-mail pour modifier son sujet, son titre et son corps, ou pour le désactiver.

Conseils

  • Utilisez Demander l'approbation du donateur pour tout changement que le donateur n'a pas explicitement demandé, afin qu'il ait toujours le dernier mot.
  • Le statut Actif du don est requis. Si l'option Mettre à jour l'abonnement est manquante ou désactivée, vérifiez d'abord le statut de l'abonnement.
  • Les modifications prennent effet au prochain cycle de facturation, pas immédiatement, de sorte que le donateur n'est jamais facturé deux fois pour la période en cours.

Référence du développeur

Le chemin de mise à jour complet est basé sur des hooks, vous pouvez donc intercepter, étendre ou réagir aux changements d'abonnement.

Filtres

FiltreDéfautObjectif
charitable_process_subscription_update_stripearray( 'success' => false, 'message' => ... )Implémenté par Charitable Pro 1.8.16+. Reçoit le don récurrent et les modifications proposées, les envoie à Stripe et renvoie un tableau de résultats. L'endpoint de mise à jour de l'administrateur et le gestionnaire d'approbation du donateur l'appellent tous deux.
charitable_recurring_confirmation_page_colorscouleurs de la marqueCouleurs pour la page de confirmation d'approbation/refus visible par le donateur.
charitable_recurring_confirmation_page_headingtitre par actionLe titre affiché sur la page de confirmation.
charitable_recurring_confirmation_page_messagemessage par actionLe message principal sur la page de confirmation.
charitable_recurring_confirmation_page_buttonbouton retour-accueilLe bouton affiché sur la page de confirmation.
charitable_recurring_confirmation_page_htmlvideRetourner du HTML personnalisé pour remplacer toute la page de confirmation.

Actions

ActionArgumentsQuand cela se déclenche
charitable_recurring_subscription_updated$donation, $changes, $old_valuesAprès une mise à jour réussie. Déclenche l'e-mail donateur « Abonnement mis à jour » lorsque cet e-mail est activé.
charitable_recurring_subscription_change_requested$donation, $pending_data, $raw_tokenLorsqu'un administrateur demande l'approbation du donateur. Déclenche l'e-mail de demande d'approbation.
charitable_stripe_subscription_details_changed$subscription, $stripe_objectDéclenché par le processeur de webhook de Pro lors d'un événement Stripe customer.subscription.updated. L'écouteur de synchronisation inverse lit le nouveau montant et la nouvelle période à partir de l'objet Stripe.

Fonctions et classes utilitaires

  • charitable_recurring_update_local_subscription( $donation, $changes ) – met à jour uniquement les métadonnées locales. Gère la distribution proportionnelle d'un nouveau montant pour une seule campagne et pour plusieurs campagnes.
  • Charitable_Recurring_Subscription_Change_Handler::process_approval() – gère le clic d'approbation du donateur (?donation_id=X&token=Y&action=approve).
  • Charitable_Recurring_Subscription_Change_Handler::process_denial() – gère le chemin de refus.
  • Charitable_Recurring_Subscription_Change_Handler::cleanup_expired_pending_changes() – supprime les enregistrements de changements en attente expirés (s'exécute lors d'un événement planifié).
  • Charitable_Gateway_Stripe_AM::$period_map – tableau statique mappant chaque période Charitable à un interval et interval_count Stripe.
  • Charitable_Gateway_Stripe_AM::update_subscription( $result, $donation, $changes ) – la méthode derrière le filtre ; crée un Plan Stripe pour les nouveaux arguments et échange l'élément de l'abonnement avec celui-ci, sans proratisation.

Mappage des périodes

Le montant et la période que vous définissez correspondent au modèle de facturation de Stripe comme suit :

Période CharitableIntervalle Stripenombre d'intervalles
jourjour1
semainesemaine1
moismois1
trimestremois3
semestremois6
annéeannée1

Jeton d'approbation

Le lien d'approbation utilise un jeton HMAC-SHA256 lié à l'ID du don, au moment où le changement a été proposé, et à un secret unique de 32 caractères. Les jetons expirent après 7 jours. Un compteur de tentatives répétées est stocké dans le transient charitable_sub_token_attempts_{donation_id}, et l'enregistrement du changement en attente est supprimé lors de l'approbation ou du refus afin qu'un lien ne puisse pas être réutilisé.

Exemples de personnalisation

Ajoutez une ligne de journal personnalisée chaque fois qu'un abonnement est mis à jour :

add_action( 'charitable_recurring_subscription_updated', function ( $donation, $changes, $old_values ) {
    error_log( sprintf(
        'Subscription #%d updated: %s',
        $donation->ID,
        wp_json_encode( $changes )
    ) );
}, 10, 3 );

Informez votre équipe sur Slack lorsqu'une approbation de donateur est demandée :

add_action( 'charitable_recurring_subscription_change_requested', function ( $donation, $pending_data, $raw_token ) {
    my_slack_notify( sprintf(
        'Approval requested for recurring donation #%d',
        $donation->ID
    ) );
}, 10, 3 );

Personnalisez la page de confirmation du donateur :

add_filter( 'charitable_recurring_confirmation_page_colors', function ( $colors ) {
    $colors['primary'] = '#16a34a';
    return $colors;
} );

Connexes

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 !

Dons Nouveau

👥 Présentation de la fusion des donateurs : deux fiches, un seul donateur !

Quelque part dans votre liste de donateurs se trouve un donateur qui apparaît deux fois, car il a donné depuis une adresse professionnelle une année et une adresse personnelle l'année suivante. Chaque don est toujours enregistré et chaque reçu a toujours été envoyé, mais un donateur fidèle qui donne depuis des années peut ressembler à deux personnes qui ont donné la moitié moins. À partir du plugin Charitable Pro 1.8.19.1, vous pouvez trouver ces fiches et les fusionner depuis l'écran Donateurs. Pourquoi c'est important :

  • 🔍 Un lien Trouver les doublons là où vous travaillez déjà : Allez dans Charitable » Donateurs et il se trouve à côté de Filtrer et Exporter, puis vous indique combien de groupes de doublons possibles il a trouvés.
  • 🧩 Groupé par nom, pas par e-mail : Charitable compare le prénom et le nom de famille ensemble et ignore les majuscules, les espaces et la ponctuation, ce qui permet de trouver la même personne sous deux adresses différentes.
  • 📊 Un aperçu avant que quoi que ce soit ne change : Chaque groupe affiche chaque fiche avec son adresse e-mail, son nombre de dons et son total à vie, et l'aperçu vous montre les totaux combinés et l'e-mail qui sera ajouté.
  • ↩️ Chaque fusion peut être annulée : Rien n'est fusionné tant que vous n'avez pas choisi de le faire, et vous pouvez annuler toute fusion par la suite, donc une mauvaise supposition ne vous coûte rien.
  • 📥 Conçu pour la semaine après une importation : Le transfert de donateurs depuis un autre plugin est la principale source de doublons, et c'est aussi le moment où ils sont les plus difficiles à repérer, car chaque fiche est nouvelle pour vous.

Consultez notre annonce ici.

ambassadeurs Nouveau

🔑 Présentation des collectes sans mot de passe : inscrivez-vous avec juste une adresse e-mail !

Les donateurs arrivent en voulant aider, et ensuite le formulaire leur demande d'inventer un mot de passe pour un site web qu'ils ne visiteront peut-être que deux fois. Beaucoup d'entre eux s'arrêtent là. Les comptes de collecte sans mot de passe, nouveauté de Charitable Ambassadors 3.5.0, permettent à un donateur de lancer une collecte de pair à pair avec rien d'autre qu'une adresse e-mail. Pourquoi c'est important :

  • 🔑 Aucune étape de mot de passe pour les perdre : Activez-la dans Charitable » Ambassadeurs » Modèles » Formulaire de soumission et le formulaire de création de collecte ne demande qu'un nom, une adresse e-mail et un titre de page.
  • 👤 Toujours un vrai compte WordPress : Un clic dans un e-mail confirme l'adresse, les connecte et crée le compte, afin qu'ils puissent revenir plus tard pour modifier leur histoire, changer leur photo et voir qui a fait un don.
  • 🎚️ Votre choix pour chaque campagne : Chaque campagne de pair à pair peut suivre la valeur par défaut du site ou la remplacer, ce qui est important lorsqu'une campagne paie les collecteurs via Stripe Connect et que ces personnes ont besoin d'un mot de passe.
  • 📋 Voir qui n'a pas encore cliqué : L'onglet Charitable » Ambassadeurs » Répertoire » En attente de connexion liste tous ceux qui attendent encore, avec la campagne qu'ils ont rejointe et un bouton Réenvoyer, afin qu'une faute de frappe ou un dossier de spam puisse être repéré et corrigé.
  • 🛡️ Liens que les scanners ne peuvent pas épuiser : L'ouverture du lien n'affiche qu'une page, et votre collecteur est connecté lorsqu'il appuie sur le bouton, de sorte que les scanners d'e-mails d'entreprise n'épuisent jamais le lien. Chacun fonctionne une fois, expire de lui-même et n'est stocké que sous forme de hachage.

Consultez notre annonce ici.

ambassadeurs Nouveau

🏃 Présentation de l'activité : Montrez les progrès au-delà de l'argent !

La plupart des collectes de fonds peer-to-peer ne se résument pas à l'argent. Un marathon de lecture porte sur les minutes lues, un marathon de marche sur les kilomètres parcourus et une collecte de nourriture sur les repas préparés. L'activité pour les Ambassadeurs Caritatifs permet à vos collecteurs de fonds de montrer cet effort juste à côté des dollars qu'ils collectent. Pourquoi c'est important :

  • 🎯 Progrès sur ce que vous comptez réellement : Une barre de progression montre chaque élément que vous comptez par rapport à sa propre cible, juste à côté de l'argent collecté.
  • 🏅 Jalons pour les choses oui ou non : Un badge de jalon marque les efforts qui sont simplement faits ou non faits, sans chiffre à atteindre.
  • ✍️ Les collecteurs de fonds enregistrent leurs propres chiffres : Vos supporters saisissent leurs totaux depuis leurs propres pages, de sorte que l'effort cesse de vivre dans une feuille de calcul, un commentaire ou nulle part ailleurs.
  • 🤖 Certains chiffres se comptent eux-mêmes : Une étiquette AUTOMATIQUE apparaît partout où le site a calculé le chiffre à partir des dons complétés, afin que vous puissiez voir en un coup d'œil ce que personne n'a tapé.
  • 🧩 Configurez une fois, utilisez partout : Vous décidez ce qui est compté une fois, puis vous choisissez quelles campagnes le comptent. Disponible dès maintenant dans Charitable Ambassadors 3.4.7, sans nouveau plugin et sans développeur.

Consultez notre annonce ici.

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.