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 !

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.