Documentation Charitable

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

Widget de mini-don

Le Mini Widget de Dons est un formulaire de don compact et intégrable qui permet aux visiteurs de donner à une campagne spécifique directement depuis n'importe quelle page ou publication. Aucune page de campagne complète requise.

Ajoutez-le à votre page d'accueil, une page de destination, une barre latérale ou un article de blog et transformez n'importe quel contenu en opportunité de collecte de fonds. Disponible dans Charitable Pro 1.8.13.1+.

Ce que contient ce guide


Fonctionnalités clés

Le Mini Widget de Dons est conçu pour rendre le don rapide, flexible et sans friction. Que vous l'intégriez sur votre page d'accueil, un article de blog ou une page de destination, chaque fonctionnalité est conçue pour réduire les obstacles et maintenir les donateurs concentrés sur le don. Voici ce qu'il apporte à vos pages de collecte de fonds :

  • Placez un widget de don n'importe où en utilisant un bloc Gutenberg ou un shortcode
  • Affichez des boutons de montant de don prédéfinis pour les dons ponctuels et mensuels
  • Affichez des déclarations d'impact qui se mettent à jour lorsque les donateurs sélectionnent différents montants
  • Onglets optionnels Mensuel / Don unique lors de l'utilisation avec Charitable Recurring
  • Le bouton CTA ouvre une modale ou redirige vers la page de don de la campagne
  • Champ de saisie "Autre" pour les dons personnalisés
  • Définissez une couleur d'accentuation personnalisée, une largeur, un alignement et un titre de widget
  • Support de remplacement de modèle pour un contrôle HTML complet

Ensemble, ces fonctionnalités vous offrent une expérience de don entièrement fonctionnelle dans un package compact et intégrable. Aucune page de campagne dédiée requise, aucune navigation supplémentaire, et aucune friction inutile – juste une expérience de don propre et ciblée qui fonctionne partout où votre public se trouve déjà.


Pourquoi utiliser le Mini Widget de Dons ?

La plupart des plugins de don exigent que les donateurs accèdent à une page de campagne dédiée avant de pouvoir donner. Le Mini Widget de Dons supprime cette barrière en intégrant une expérience de don complète exactement là où votre public est déjà engagé : sur votre page d'accueil, dans un article de blog, ou aux côtés d'un contenu convaincant. Il maintient le processus de don rapide, ciblé et sans friction.


Voyez-le en action


Exigences

  • Charitable Pro 1.8.13.1 ou version ultérieure
  • Pour l'onglet récurrent Mensuel/Don unique : le module complémentaire Charitable Recurring doit être actif

Démarrage

Ajout du bloc

Bloc de mini-widget de don
  1. Ouvrez n'importe quelle page ou publication dans l'éditeur de blocs WordPress.
  2. Cliquez sur + pour ajouter un nouveau bloc et recherchez Mini Widget de Dons.
  3. Sélectionnez une campagne dans le menu déroulant Campagne dans le panneau des paramètres du bloc.
  4. Configurez vos montants préférés, le mode CTA et les options de style dans la barre latérale.
Mini don sélectionner la campagne

Utilisation du Shortcode

Ajoutez [charitable_mini_widget campaign_id="123"] à n'importe quelle page, publication, zone de widget ou modèle prenant en charge les shortcodes. Remplacez 123 par l'ID de publication de votre campagne.


Options de configuration / Référence des paramètres

Paramètres principaux

ParamètreTypeDéfautDescription
id_campagneentier(obligatoire)L'ID de publication de la campagne à laquelle faire un don.
mode_appel_actionchaîne de caractèresredirectionComportement du bouton de don. redirect envoie le donateur vers la page de don de la campagne ; modal ouvre le formulaire dans une fenêtre pop-up.
libellé_appel_actionchaîne de caractèresFaire un don maintenantLe texte de l'étiquette sur le bouton de don.

Paramètres récurrents / onglets

ParamètreTypeDéfautDescription
récurrentbooléenfauxDéfinissez sur true pour afficher les onglets Mensuel et Faire un don une fois. Nécessite Charitable Recurring.
mensuelchaîne de caractèresMensuelÉtiquette personnalisée pour l'onglet mensuel.
donner_une_foischaîne de caractèresFaire un don une foisÉtiquette personnalisée pour l'onglet unique.

Paramètres du montant

ParamètreTypeDéfautDescription
montants_mensuelschaîne de caractères10,25,50,100Montants prédéfinis séparés par des virgules pour l'onglet mensuel.
défaut_mensuelchaîne de caractères25Le montant mensuel présélectionné. Doit être dans monthly_amounts.
afficher_autre_mensuelbooléenfauxAfficher un bouton « Autre » permettant un montant mensuel personnalisé.
montants_une_foischaîne de caractères25,50,100,250Montants prédéfinis séparés par des virgules pour l'onglet unique.
défaut_une_foischaîne de caractères50Le montant unique présélectionné. Doit être dans onetime_amounts.
afficher_autre_une_foisbooléenfauxAfficher un bouton « Autre » permettant un montant unique personnalisé.

Paramètres de l'énoncé d'impact

Les énoncés d'impact par montant sont mis à jour dynamiquement lorsque les donateurs cliquent sur différents boutons de montant.

ParamètreTypeDéfautDescription
impact_mensuel_{amount}chaîne de caractères(vide)Texte d'impact affiché lorsque le montant mensuel donné est sélectionné. Exemple : monthly_impact_25="nourrit une famille pendant un mois"
impact_une_fois_{amount}chaîne de caractères(vide)Texte d'impact affiché lorsque le montant unique donné est sélectionné. Exemple : onetime_impact_100="couvre les fournitures scolaires pour 10 enfants"

Paramètres de validation

ParamètreTypeDéfautDescription
montant_minnombre(aucun)Montant personnalisé minimum autorisé lorsque « Autre » est activé.
montant_maxnombre(aucun)Montant personnalisé maximum autorisé lorsque « Autre » est activé.

Paramètres d'affichage

ParamètreTypeDéfautDescription
afficher_devisebooléenfauxAffiche le code ISO de la devise (par ex.  USD) à côté des montants prédéfinis.
couleur_accentchaîne de caractères(défaut du thème)Couleur hexadécimale pour le style des boutons et des accents, par ex.  #e63946.
alignement_widgetchaîne de caractèrescentreAlignement du widget :  gauche,  centre, ou  droite.
largeur_widgetchaîne de caractères(auto)Valeur CSS de largeur maximale pour le conteneur du widget, par ex.  400px ou 100%.
titre_widgetchaîne de caractères(aucun)Titre facultatif au-dessus du widget. Utilisez {{campaign_title}} pour insérer le nom de la campagne dynamiquement.
alignement_impactchaîne de caractères(aucun)Alignement du texte pour les déclarations d'impact :  gauche,  centre, ou  droite.
classechaîne de caractères(aucun)Classe(s) CSS supplémentaire(s) ajoutée(s) à l'élément wrapper du widget.

Exemple de shortcode

[charitable_mini_widget
  campaign_id="42"
  cta_mode="modal"
  recurring="true"
  monthly_amounts="10,25,50,100"
  monthly_default="25"
  monthly_impact_10="provides clean water for a week"
  monthly_impact_25="feeds a family for a month"
  monthly_impact_50="sponsors a child's education"
  monthly_impact_100="funds a medical checkup"
  monthly_show_other="true"
  onetime_amounts="25,50,100,250"
  onetime_default="50"
  widget_title="Support {{campaign_title}}"
  accent_color="#e63946"
  widget_width="420px"
  widget_align="center"
]

Personnalisation

Variable CSS

Remplacez la couleur d'accent globalement ou par instance en utilisant la propriété personnalisée CSS :

.charitable-mini-widget {
    --charitable-mini-widget-accent: #e63946;
}

Remplacement de modèle

Pour personnaliser le HTML du widget, copiez le modèle dans votre thème :

yourtheme/charitable-pro/shortcodes/mini-widget.php

Dépannage

Le widget n'apparaît pas sur le site public

Vérifiez que le campaign_id est défini et correspond à une campagne publiée. Les éditeurs verront un message d'erreur si l'ID est manquant ou invalide ; les visiteurs ne verront rien. Vérifiez que Charitable Pro 1.8.13.1 ou une version ultérieure est actif.

L'onglet Mensuel n'apparaît pas

L'onglet récurrent n'apparaît que lorsque le paramètre recurring est défini sur true et que le module complémentaire Charitable Recurring est installé et actif. Si Recurring n'est pas actif, le widget revient silencieusement au mode unique.

Les déclarations d'impact ne se mettent pas à jour lorsque je clique sur un montant

Vérifiez que le montant dans vos clés monthly_impact_{amount} ou onetime_impact_{amount} correspond exactement à la valeur dans monthly_amounts ou onetime_amounts (y compris la précision décimale). impact_50 et impact_50.00 sont traités comme des clés différentes.

Le widget affiche une boîte de substitution dans Divi ou WPBakery

C'est le comportement attendu en mode aperçu du constructeur de pages visuelles. Le widget s'affiche correctement sur le front-end publié.

Le bouton CTA n'ouvre pas de fenêtre modale

Assurez-vous que cta_mode est défini sur modal. Le mode modal nécessite la fonctionnalité de fenêtre modale/bouton de don de Charitable incluse dans Charitable Pro.


Ressources pour les développeurs

Hooks et filtres

  • charitable_mini_widget_shortcode_output: Filtre la sortie HTML finale du widget. Reçoit la chaîne HTML et le tableau $args analysé.

Classes CSS

ClasseÉlément
.mini-widget-charitableConteneur racine
.mini-widget-charitable__titreTitre de widget optionnel
.mini-widget-charitable__ongletsBarre d'onglets Mensuel/Don unique
.mini-widget-charitable__onglet--actifOnglet actuellement actif
.mini-widget-charitable__montantsGroupe de boutons de montant
.mini-widget-charitable__montant--selectionnéBouton de montant actuellement sélectionné
.mini-widget-charitable__montant--autreBouton de montant « Autre »
.mini-widget-charitable__impactZone de déclaration d'impact
.mini-widget-charitable__appel_actionBouton de don

Remplacement de modèle

Copiez charitable-pro/shortcodes/mini-widget.php dans yourtheme/charitable-pro/shortcodes/mini-widget.php pour personnaliser entièrement le balisage du widget.


Ressources supplémentaires

Pas encore un utilisateur Charitable Pro ? Inscrivez-vous dès aujourd'hui et bénéficiez de jusqu'à 50 % de réduction sur votre forfait. Nous sommes convaincus que vous aimerez collecter des fonds avec Charitable. Si, pour une raison quelconque, Charitable ne vous convient pas, nous vous rembourserons votre achat grâce à notre garantie de remboursement de 14 jours.

Restez connecté pour plus de ressources pour les organisations à but non lucratif

Pour plus de tutoriels et de vidéos adaptés aux organisations à but non lucratif, abonnez-vous à notre chaîne YouTube. Nous publions régulièrement des conseils d'experts, des guides étape par étape sur les dons en ligne, des stratégies de collecte de fonds et des ressources pratiques pour aider votre organisation à réussir.

🗞️ Recevez des conseils hebdomadaires et des guides exclusifs dans votre boîte de réception
Rejoignez notre newsletter →  

🎥 Regardez des tutoriels étape par étape et des histoires de réussite
Abonnez-vous à notre chaîne YouTube →  

👩🏽‍💻 Connectez-vous avec notre communauté et obtenez des informations quotidiennes sur les organisations à but non lucratif
Suivez-nous sur LinkedIn →

🥳 Reels amusants et informations sur les organisations à but non lucratif
Suivez-nous sur Instagram → 

👀 Vidéos perspicaces et amusantes pour vous aider à développer votre cause
Suivez-nous sur TikTok→  

🌎 Abonnez-vous et suivez pour des conseils généraux sur la collecte de fonds
Obtenez des conseils sur la collecte de fonds sur TikTok → 

Ressources puissantes pour la collecte de fonds

🤖 Utilisez Charitable avec votre assistant IA

Voir Charitable + IA →

⬇️ 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 →

🏎️ Essayez Charitable
Créez votre démo Charitable →

Comprendre les termes et le jargon des organisations à but non lucratif
Glossaire des organisations à but non lucratif→

% Vous recherchez des offres et des réductions pour les organisations à but non lucratif ?
Meilleures offres et réductions pour les organisations à but non lucratif →

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.