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

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

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.