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 !

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.