Documentation Charitable

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

How to Add a Custom Donation Field

Adding custom fields to your Charitable donation forms allows you to collect additional information from donors beyond the standard fields. Whether you need to gather referral codes, dedication messages, or specific donor details, you can easily add these fields using code snippets.

This guide will show you how to add custom fields in your donation forms.

In This Guide

Quick Start Example

Here’s a practical example to get you started. Check out this code snippet » Collect National ID.

This code snippet demonstrates how to add a National ID Number field to your donation form:

You can use that code snippet and customize it to suit your needs:

  • Replace every instance of ‘national_id_number’ with ‘your_field’.
  • Replace every instance of ‘National ID Number’ with the label for your field.

Now that you have an idea of code snippets, let’s show you how to add and customize code snippets.

How To Add A Code Snippet

If you are new to PHP or WordPress development, we recommend using the WPCode plugin to insert snippets safely and easily into your website. Charitable currently has over 130 snippets in the WPCode plugin library you can use. Visit our library here:

Charitable Code Snippet Library »

For those a little more familiar with WordPress development, you can use the snippets to create simple standalone plugins. Read the WordPress documentation about creating a plugin.

Alternatively, you could add the snippets directly to your theme or child theme’s functions.php file.

Please be aware of our recommendations and suggestions for safe practices using code snippets to avoid fatal errors and issues: Customizing Donation Forms With Code Snippets Using WPCode »

There are many other snippets that go beyond creating a text box on a donation form and extend into customizing your campaigns and donation forms even further. Feel free to explore the library either on WPCode‘s website or in the screen in the Charitable plugin.

Have an idea for a code snippet that doesn’t exist yet? Contact us and we’ll add it!

You may also be interested in WPCode documentation to learn more about how their plugin works and the additional features that you can assign to code snippets, including Charitable code snippets.

Get Fundraising Tips & Non-Profit Advice

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.

FAQs: Adding Custom Fields to Charitable Donation Forms

What are custom fields and why would I need them? 

Custom fields allow you to collect additional information from donors beyond the standard name, email, and donation amount. Common uses include:

  • Collecting referral codes or promotional codes
  • Adding “In memory of” or dedication fields
  • Gathering feedback on how donors heard about your campaign
  • Including checkboxes for newsletter subscriptions
  • Adding company information for corporate donors

Do I need coding experience to add custom fields? 

No. While custom fields can be added through code, WPCode provides a user-friendly solution that doesn’t require any programming knowledge. You can install pre-built snippets with just a few clicks.

Will adding custom fields affect my donation conversion rates? 

This depends on implementation. Optional fields typically have minimal impact, while too many unnecessary required fields may possibly reduce conversions. We recommend:

  • Making additional fields optional when possible
  • Keeping forms concise and user-friendly
  • Testing different configurations to see what works for your audience

Is WPCode free to use? 

Yes! WPCode offers a free version that includes access to many code snippets. There’s also a premium version with additional features, but the free version is sufficient for most custom field needs.

Will custom fields work with my WordPress theme? 

Custom fields should work with any properly coded WordPress theme. However, you may need to add custom CSS to match your theme’s styling. If you experience display issues, contact our support team.

How do I install WPCode?

  1. Go to Charitable → Tools → Code Snippets
  2. If WPCode isn’t installed, you’ll see an installation prompt
  3. Click the install button to automatically install and activate WPCode
  4. Once activated, you’ll see available code snippets

I don’t see the Code Snippets tab. What’s wrong? 

This usually means:

  • Your Charitable version is outdated (update to 1.8.1.7+)
  • You don’t have admin permissions
  • There’s a plugin conflict (try deactivating other plugins temporarily)

How do I find the right code snippet for my needs? 

Use the search functionality in the Code Snippets tab. Search for terms like:

  • “text field” for additional text inputs
  • “checkbox” for opt-in options
  • “dropdown” for selection menus
  • “textarea” for longer text inputs

Can I modify the code snippets? 

Absolutely! Most snippets include comments and documentation to guide customization. You can change:

  • Field labels and descriptions
  • Field positioning on the form
  • Whether fields are required or optional
  • Field types (text, textarea, dropdown, etc.)

Where do custom field submissions appear? 

Custom field data appears in:

  • Donation details in your WordPress admin
  • Email notifications (if configured)
  • Export reports (if enabled in the snippet settings)

Can I add multiple custom fields to one form? 

Yes! You can install and activate multiple code snippets to add several custom fields to your donation forms.

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.

Need support? Have a question? If you are a lite/free user of Charitable, you can reach out to our team on the WordPress.org support forums and our team will respond in a timely fashion. If you have an active license, feel free to reach out us directly for priority support.

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 !

GiveWP Migrations Nouveau

Service de migration "White Glove" pour GiveWP

Vous envisagez de passer de GiveWP à Charitable pour votre plateforme de collecte de fonds, mais vous ne voulez pas risquer de perdre vos données ni gérer vous-même une configuration technique complexe ? Le service de migration "White Glove" de Charitable comprend :

👥 Cartographie parfaite des donateurs : transférez en toute sécurité toute votre base de données de supporters sans aucune perte de données.

📊 Historique financier complet : préservez méticuleusement chaque transaction historique pour des rapports continus et précis.

🔄 Dons récurrents transparents : transférez en toute sécurité les abonnements récurrents actifs sans perturber vos revenus entrants ni obliger vos donateurs à mettre à jour leurs informations.

💳 Aucune interruption de passerelle : continuez à utiliser Stripe, PayPal ou tout autre processeur compatible avec GiveWP que vous utilisez déjà.

🚀 Configuration technique experte : détendez-vous pendant que notre équipe s'occupe du travail le plus difficile pour installer et configurer vos formulaires — de plus, les utilisateurs éligibles reçoivent une année complète de Charitable Pro gratuitement.

Visitez cette page pour en savoir plus.

automatisation Amélioration

📢 Alerte nouvelle fonctionnalité : Automation Connect 2.0 est là ! 🚀

Vous envisagez de connecter vos données de collecte de fonds à des outils comme Mailchimp, Slack ou Google Sheets, mais vous ne voulez pas engager un développeur ou écrire du code personnalisé ? Le nouvel add-on d'automatisation de Charitable propose :

⚡ 17 déclencheurs d'événements : déclenchez instantanément des webhooks pour le premier don d'un donateur, les paiements de renouvellement ou les étapes importantes de la campagne atteintes.

🎯 Logique conditionnelle intelligente : utilisez une logique ET/OU puissante sur 11 champs pour n'envoyer des données que lorsqu'elles répondent à vos critères exacts, comme les inscriptions à la newsletter.

📊 Contrôle personnalisé de la charge utile : choisissez parmi plus de 80 champs de données propres sur les métadonnées du donateur, du don et de la campagne afin que vos applications obtiennent exactement ce dont elles ont besoin.

🚀 Modèles de plateforme pré-intégrés : évitez la configuration à partir de zéro avec des modèles prêts à l'emploi pour Zapier, Make.com, n8n, HubSpot et Slack.

🛡️ Outils de développement fiables : alimentez vos flux de travail avec des charges utiles signées HMAC-SHA256, des filtres WordPress complets et des journaux de nouvelles tentatives automatiques.

automatisation Amélioration

🔌 Charitable rencontre Zapier : Connectez-vous à plus de 7 000 applications et automatisez votre collecte de fonds

Fatigué de copier manuellement les données de dons dans des feuilles comptables ou de rechercher les nouvelles inscriptions de donateurs ? Mettez vos tâches administratives en pilote automatique. Charitable est maintenant officiellement sur Zapier, vous offrant un moyen puissant et sans code de connecter directement votre collecte de fonds au reste de vos outils préférés.

Chaque don, inscription de donateur et jalon de campagne peut désormais déclencher un flux de travail automatisé en toute transparence.

Quoi de neuf :

♾️ Connectez-vous à plus de 7 000 applications : Reliez vos campagnes Charitable à des logiciels quotidiens comme Google Sheets, QuickBooks, Slack, Mailchimp, HubSpot, Notion, Airtable, et des milliers d'autres.

⚡ 12 déclencheurs puissants : Créez des flux de travail approfondis à l'aide de déclencheurs d'automatisation intelligents couvrant l'ensemble du cycle de vie des dons, y compris Nouveau don, Nouveau donateur, Abonnement annulé et Objectif de campagne atteint.

📋 Modèles d'actions pré-intégrés : Commencez en trois minutes ou moins avec nos combinaisons de modèles prédéfinis, comme l'enregistrement automatique des nouveaux dons directement dans une feuille Google ou l'envoi d'e-mails de bienvenue personnalisés aux donateurs via Gmail.

🚫 Zéro code requis : Pas de webhooks complexes ni de scripts PHP personnalisés nécessaires. Choisissez simplement votre déclencheur, sélectionnez votre application, mappez vos champs, et laissez Zapier s'occuper du travail acharné.

Prêt à économiser des heures d'administration ? Obtenez Charitable Pro avec le module complémentaire Automation Connect dès aujourd'hui et lancez votre premier Zap !

Amélioration Paiements

🚀 Présentation de PayPal Commerce : Une connexion, six façons de faire un don

Les donateurs s'attendent à des options de paiement modernes et flexibles lorsqu'ils soutiennent une cause. S'ils ne voient pas leur méthode préférée sur votre formulaire de don, ils disparaissent souvent sans un mot. Avec PayPal Commerce, nous apportons une expérience de paiement entièrement modernisée directement à vos campagnes.

Profitez d'une seule intégration qui améliore vos formulaires, rend le don transparent et vous aide à capturer chaque don.

Quoi de neuf :

🔌 Connexion en un clic : Oubliez les clés API compliquées et la documentation pour développeurs. Cliquez simplement sur « Se connecter avec PayPal », connectez-vous à votre compte professionnel, et votre formulaire moderne sera en ligne en moins de cinq minutes.

💳 Six façons de donner : Offrez à vos supporters un accès instantané à leur solde PayPal, Venmo (US), le financement « Pay Later », les principales cartes de crédit/débit, Apple Pay (Safari) et Google Pay (Chrome), le tout à partir du même formulaire.

🔄 Dons récurrents flexibles : Prend entièrement en charge les dons mensuels. Choisissez entre l'API PayPal Subscriptions (gérée automatiquement par PayPal) ou Vault + Cron (gérée en toute sécurité sur votre site).

💬 Récupération d'erreurs conviviale : Fini les alertes navigateur confuses. Si un paiement est refusé, les donateurs voient des messages clairs et intégrés qui les guident sur la façon de résoudre le problème et de finaliser leur don.

Prêt pour PayPal, modernisé ? Mettez à jour vers Charitable Pro 1.8.15+ (ou Charitable Lite 1.8.11+) et connectez votre compte dès aujourd'hui !

Campagnes Nouveau

⏳ Compte à rebours de campagne : Créez de l'urgence et augmentez les dons

L'urgence est l'un des outils les plus puissants en collecte de fonds ! Découvrez le compte à rebours de campagne, un minuteur en direct et en temps réel conçu pour transformer la procrastination en générosité immédiate.

animation_compte_a_rebours_campagne

Quoi de neuf :

⏱️ Urgence en temps réel : Suivez magnifiquement les jours, heures, minutes et secondes jusqu'à la date limite de votre campagne avec des comptes à rebours visuels mis à jour en direct.

🎨 Adapté à votre style : Choisissez entre des tuiles bordées "Boxed" ou un affichage épuré "Inline" sur une seule ligne. Adaptez instantanément votre thème avec des contrôles de police et de couleur profonde.

🛠️ Placez-le n'importe où : Insérez le compte à rebours où vous le souhaitez en utilisant le champ "Campaign Builder", un bloc Gutenberg dédié, ou un simple shortcode.

🚨 Actions intelligentes à l'expiration : Contrôle total de l'état final : choisissez de remplacer automatiquement le minuteur par un message personnalisé, de le figer à zéro, et plus encore.