Documentation Charitable

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

Personnaliser les formulaires de don avec des extraits de code à l'aide de WPCode

Souvent, les créateurs de campagnes caritatives souhaitent personnaliser leurs formulaires de don. La personnalisation la plus courante consiste à ajouter un champ supplémentaire au formulaire, tel qu'un champ de texte pour saisir un code spécifique ou une adresse e-mail alternative. D'autres fois, il s'agit d'une case à cocher pour confirmer si le donateur souhaite être informé des services supplémentaires.

Il est possible d'ajouter des champs personnalisés à un formulaire de don, et cela peut être fait via des extraits de code facilement modifiables qui peuvent être ajoutés au fichier functions.php ou à un plugin dédié. Mais pour ceux qui ne sont pas développeurs ou qui ne sont pas à l'aise avec le code, il existe une méthode plus simple et plus rapide pour ajouter et activer des extraits de code dans Charitable en utilisant WPCode.

Prérequis

Assurez-vous d'utiliser la version 1.8.1.7 ou supérieure de Charitable.

Dans ce guide

Installation de WPCode

La première étape consiste à installer WPCode lui-même. Vous pouvez installer et activer la version gratuite comme vous le feriez avec n'importe quel autre plugin WordPress. Cependant, Charitable dispose d'un processus intégré plus simple.

Allez dans « Outils », puis cliquez sur l'onglet « Extraits de code ».

Si vous n'avez pas encore installé WPCode, vous devriez voir une invite qui vous permettra d'installer et d'activer le plugin directement.

Activation des extraits de code

Une fois cela réussi, le même onglet sera rempli d'extraits de code. Chaque boîte sur la page contient le titre, une brève description, un lien vers l'emplacement de l'extrait sur WPCode et un bouton d'installation.

Par exemple, si vous cherchiez à ajouter une zone de texte personnalisée à un formulaire de don, recherchez « zone de texte » dans la barre de recherche et la page se mettra à jour avec les résultats correspondant à ce mot-clé. Vous pouvez trouver un exemple de script et cliquer sur installer, et ce script sera automatiquement copié et ajouté à votre bibliothèque d'extraits WPCode.

Personnalisation des extraits de code pour Charitable

Souvent, les extraits de code installés contiennent des commentaires et de la documentation, vous pouvez donc personnaliser l'extrait. Par exemple, si je voulais une zone de texte pour qu'un donateur partage comment il a entendu parler de la campagne, cet extrait « Ajouter une zone de texte au formulaire de don » extrait pourrait être modifié comme montré ici :

/**
 * Collect a textarea field in the donation form.
 *
 * This snippet only works in Charitable 1.5 or above.
 *
 */
function wpchar_charitable_register_new_textarea_field() {
    /**
     * Define a new textarea field.
     */
	
	if ( ! class_exists("Charitable_Donation_Field" ) ) {
		return;
	};
		
    $field_1 = new Charitable_Donation_Field( 'textarea_example', array(
        'label' => __( 'How did you learn about this campaign?', 'charitable' ),
        'data_type' => 'user',
        'donation_form' => array(
            'type' => 'textarea',
			'show_after' => 'phone', // adjust to where you want this to show up
                        'required'   => false,
             ),
        'admin_form' => false,
        'show_in_meta' => false,
        'show_in_export' => false,
        'email_tag' => array(
            'description' => __( 'How did you learn...' , 'charitable' ),
        ),
    ) );

    /**
     * Register the textarea fields.
     */
	charitable()->donation_fields()->register_field( $field_1 );

}

add_action( 'init', 'wpchar_charitable_register_new_textarea_field' );

Il existe de nombreux autres extraits qui vont au-delà de la création d'une zone de texte sur un formulaire de don et qui permettent de personnaliser davantage vos campagnes et vos formulaires de don. N'hésitez pas à explorer la bibliothèque sur le site web de WPCode ou dans l'écran du plugin Charitable.

Vous avez une idée d'extrait de code qui n'existe pas encore ? Contactez-nous et nous l'ajouterons !

Vous pourriez également être intéressé par la documentation de WPCode pour en savoir plus sur le fonctionnement de leur plugin et les fonctionnalités supplémentaires que vous pouvez attribuer aux extraits de code, y compris les extraits de code Charitable.

Recevez des conseils de collecte de fonds et des conseils pour les organisations à but non lucratif

Nous partageons régulièrement des guides pratiques, des stratégies éprouvées et des conseils d'initiés pour vous aider à collecter plus de fonds et à établir des relations plus solides avec vos donateurs. Rejoignez des milliers d'organisations à but non lucratif qui reçoivent notre meilleur contenu directement :

Pas de blabla, juste des conseils concrets de personnes qui comprennent les défis auxquels vous êtes confrontés chaque jour.

FAQ : Ajout de champs personnalisés aux formulaires de don Charitable

Que sont les champs personnalisés et pourquoi en aurais-je besoin ? 

Les champs personnalisés vous permettent de collecter des informations supplémentaires auprès des donateurs au-delà du nom, de l'e-mail et du montant du don standard. Les utilisations courantes incluent :

  • La collecte de codes de parrainage ou de codes promotionnels
  • L'ajout de champs « En mémoire de » ou de dédicaces
  • La collecte de commentaires sur la façon dont les donateurs ont entendu parler de votre campagne
  • L'inclusion de cases à cocher pour les abonnements à la newsletter
  • L'ajout d'informations sur l'entreprise pour les donateurs d'entreprise

Ai-je besoin d'une expérience en codage pour ajouter des champs personnalisés ? 

Non. Bien que les champs personnalisés puissent être ajoutés par le code, WPCode fournit une solution conviviale qui ne nécessite aucune connaissance en programmation. Vous pouvez installer des extraits pré-construits en quelques clics.

L'ajout de champs personnalisés affectera-t-il mes taux de conversion des dons ? 

Cela dépend de la mise en œuvre. Les champs facultatifs ont généralement un impact minimal, tandis que trop de champs obligatoires inutiles peuvent réduire les conversions. Nous recommandons :

  • Rendre les champs supplémentaires facultatifs lorsque c'est possible
  • Garder les formulaires concis et conviviaux
  • Tester différentes configurations pour voir ce qui fonctionne pour votre public

WPCode est-il gratuit à utiliser ? 

Oui ! WPCode offre une version gratuite qui inclut l'accès à de nombreux extraits de code. Il existe également une version premium avec des fonctionnalités supplémentaires, mais la version gratuite est suffisante pour la plupart des besoins en champs personnalisés.

Les champs personnalisés fonctionneront-ils avec mon thème WordPress ? 

Les champs personnalisés devraient fonctionner avec n'importe quel thème WordPress correctement codé. Cependant, vous devrez peut-être ajouter du CSS personnalisé pour correspondre au style de votre thème. Si vous rencontrez des problèmes d'affichage, contactez notre équipe de support.

Comment installer WPCode ?

  1. Allez dans Charitable → Outils → Extraits de code
  2. Si WPCode n'est pas installé, vous verrez une invite d'installation
  3. Cliquez sur le bouton d'installation pour installer et activer automatiquement WPCode
  4. Une fois activé, vous verrez les extraits de code disponibles

Je ne vois pas l'onglet Extraits de code. Qu'est-ce qui ne va pas ? 

Cela signifie généralement :

  • Votre version de Charitable est obsolète (mettez à jour vers 1.8.1.7+)
  • Vous n'avez pas les autorisations d'administrateur
  • Il y a un conflit de plugins (essayez de désactiver temporairement les autres plugins)

Comment trouver le bon extrait de code pour mes besoins ? 

Utilisez la fonctionnalité de recherche dans l'onglet Extraits de code. Recherchez des termes tels que :

  • « champ texte » pour les entrées de texte supplémentaires
  • « case à cocher » pour les options d’adhésion
  • « liste déroulante » pour les menus de sélection
  • « zone de texte » pour les saisies de texte plus longues

Puis-je modifier les extraits de code ? 

Absolument ! La plupart des extraits incluent des commentaires et une documentation pour guider la personnalisation. Vous pouvez modifier :

  • Les étiquettes et descriptions des champs
  • Le positionnement des champs sur le formulaire
  • Si les champs sont obligatoires ou facultatifs
  • Les types de champs (texte, zone de texte, liste déroulante, etc.)

Où les soumissions de champs personnalisés apparaissent-elles ? 

Les données des champs personnalisés apparaissent dans :

  • Les détails des dons dans votre administration WordPress
  • Les notifications par e-mail (si configurées)
  • Les rapports d’exportation (si activés dans les paramètres de l’extrait)

Puis-je ajouter plusieurs champs personnalisés à un seul formulaire ? 

Oui ! Vous pouvez installer et activer plusieurs extraits de code pour ajouter plusieurs champs personnalisés à vos formulaires de don.

Mon champ personnalisé ne s’affiche pas sur le formulaire de don. Qu’est-ce qui ne va pas ? 

Vérifiez ces problèmes courants :

  • Assurez-vous que l’extrait de code est activé dans WPCode
  • Vérifiez que votre version de Charitable répond aux exigences
  • Videz les caches des plugins
  • Vérifiez si le champ est configuré pour s’afficher au bon endroit

Le champ apparaît mais semble étrange ou ne correspond pas à mon thème. 

Il s’agit généralement d’un problème de style. Vous devrez peut-être ajouter du CSS personnalisé. Contactez notre équipe de support pour obtenir de l’aide concernant le style spécifique à votre thème.

Puis-je supprimer un champ personnalisé après l’avoir ajouté ? 

Oui ! Désactivez ou supprimez simplement l’extrait de code dans WPCode. Notez que les données des formulaires précédemment soumis resteront dans votre base de données.

J’ai activé un extrait de code mais il provoque des erreurs sur mon site. 

Désactivez immédiatement l’extrait de code dans WPCode. Cela résout généralement le problème. Si les problèmes persistent :

  • Vérifiez les conflits de plugins
  • Assurez-vous que vos versions de WordPress et de Charitable sont à jour
  • Contactez le support avec des messages d'erreur spécifiques

Où puis-je en savoir plus sur WPCode ? 

Consultez la documentation WPCode pour découvrir des fonctionnalités avancées telles que la planification des extraits, le ciblage par appareil et la logique conditionnelle.

Existe-t-il des tutoriels vidéo ? 

Oui ! Abonnez-vous à la chaîne YouTube Charitable pour des tutoriels étape par étape et des histoires de réussite.

Besoin d'aide ? Vous avez une question ? Si vous êtes un utilisateur lite/gratuit de Charitable, vous pouvez contacter notre équipe sur les forums de support de WordPress.org et notre équipe répondra rapidement. Si vous avez une licence active, n'hésitez pas à nous contacter directement pour un support prioritaire.

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.