Documentation Charitable

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

Sélecteur de campagne

La fonctionnalité Sélecteur de campagne permet aux donateurs de choisir directement depuis n'importe quel formulaire de don la campagne qui recevra leur don, créant ainsi une expérience de don multi-campagnes transparente sans nécessiter de navigation entre les pages.

Table des matières

Démarrage

Le Sélecteur de campagne transforme vos formulaires de don en ajoutant une liste déroulante intelligente qui permet aux donateurs de passer de manière transparente d'une campagne active à une autre. Lorsqu'un donateur sélectionne une campagne différente, le formulaire se met à jour dynamiquement via AJAX pour afficher les montants de don appropriés, les champs du formulaire et les messages spécifiques à la campagne.

Avantages clés

  • Expérience donateur améliorée : Pas besoin de naviguer entre les pages de campagne.
  • Taux de conversion plus élevés : Réduit les frictions dans le processus de don.
  • Gestion intelligente des campagnes : Exclut automatiquement les campagnes terminées ou entièrement financées.
  • Expérience personnalisée : Mémorise la dernière sélection de campagne du donateur.
  • Compatibilité universelle : Conçu pour fonctionner avec tous les types de formulaires et passerelles de paiement.

Exigences

  • Charitable Pro : Version 1.8.12 ou supérieure
  • WordPress : Version 6.2 ou supérieure
  • PHP : Version 7.4 ou supérieure
  • Campagnes actives multiples : Au moins 2 campagnes pour que le sélecteur apparaisse

Activation du sélecteur de campagne

  1. Dans Charitable Pro : Naviguez vers Paramètres Charitable → Général → Formulaire de don dans votre administration WordPress
  2. Faites défiler jusqu'à la section Sélecteur de campagne
  3. Cochez Activer le sélecteur de campagne pour activer la fonctionnalité
  4. Configurez vos préférences en utilisant les options ci-dessous
  5. Cliquez sur Enregistrer les modifications

Options de configuration

Paramètres de base

Libellé de la liste déroulante

  • Par défaut : « Choisir une campagne »
  • Objectif : Texte affiché au-dessus de la liste déroulante du sélecteur de campagne
  • Exemple : « Sélectionnez la cause que vous souhaitez soutenir »

Texte de l'infobulle

  • Objectif : Texte d'aide affiché lorsque les donateurs survolent l'icône d'information
  • Exemple : « Choisissez la campagne qui doit recevoir votre don »
  • Remarque : Laissez vide pour masquer l'icône de l'infobulle

Contrôle d'affichage

Afficher le sélecteur de campagne sur

Choisissez où le sélecteur de campagne doit apparaître :

  • Toutes les campagnes (Défaut) : Affiche le sélecteur sur le formulaire de don de chaque campagne
  • Campagnes sélectionnées uniquement : Limite l'affichage à des campagnes spécifiques

Campagnes sélectionnées pour l'affichage

Lorsque « Campagnes sélectionnées uniquement » est choisi : – Sélectionnez les campagnes qui doivent afficher le sélecteur de campagne – Utilisez Ctrl/Cmd+Clic pour sélectionner plusieurs campagnes – Seuls les donateurs consultant ces campagnes verront le sélecteur

Remarque : Campagnes d'ambassadeurs

Le sélecteur de campagne peut ne pas fonctionner comme prévu avec les campagnes d'ambassadeurs. La prise en charge native des campagnes d'ambassadeurs est prévue pour cette fonctionnalité.

Contenu du menu déroulant

Source du menu déroulant

Contrôlez quelles campagnes apparaissent dans le menu déroulant du sélecteur :

  • Toutes les campagnes actives (Défaut) : Inclut automatiquement toutes les campagnes éligibles
  • Campagnes sélectionnées uniquement : Choisissez manuellement les campagnes à inclure

Campagnes sélectionnées pour le menu déroulant

Lorsque « Campagnes sélectionnées uniquement » est choisi : – Sélectionnez manuellement les campagnes à inclure dans le menu déroulant – Permet une sélection de campagnes organisée – Utile pour mettre en avant des campagnes ou des causes spécifiques

Options de l'organisation

Grouper par catégorie

  • Objectif : Organise les campagnes par leurs catégories attribuées dans le menu déroulant
  • Avantage : Aide les donateurs à naviguer parmi un grand nombre de campagnes

Exclure les types de campagnes

Affinez les campagnes qui apparaissent en excluant :

  • Campagnes terminées : Campagnes dont la date de fin est dépassée
  • Campagnes entièrement financées : Campagnes qui ont atteint leur objectif

Mémoire et persistance

Mémoriser la sélection de la campagne

Contrôlez comment le sélecteur mémorise les préférences du donateur :

  • Mémoriser pendant 7 jours (Défaut) : Stocke la sélection dans le navigateur pendant une semaine
  • Mémoriser pour cette session : Stocke la sélection jusqu'à la fermeture du navigateur/onglet
  • Ne pas mémoriser : Affiche toujours la sélection par défaut

Fonctionnalités avancées

Chargement de formulaire AJAX

Le sélecteur de campagne utilise la technologie AJAX pour permettre un changement de formulaire transparent :

  • Mises à jour instantanées : Les formulaires se chargent sans actualisation de la page
  • Indicateurs de chargement : Retour visuel pendant les transitions de formulaire
  • Compatibilité des passerelles de paiement : Réinitialise automatiquement Stripe, PayPal et d'autres passerelles
  • Préservation de l'état du formulaire : Maintient les informations du donateur lorsque possible

Filtrage intelligent des campagnes

La fonctionnalité filtre automatiquement les campagnes en fonction de critères intelligents :

  • Exclut les campagnes P2P : Les campagnes d'ambassadeurs et de pair-à-pair sont masquées
  • Filtrage basé sur les dates : Respecte les dates de début et de fin des campagnes
  • Filtrage basé sur les objectifs : Peut exclure les campagnes entièrement financées
  • Vérifications de statut : Inclut uniquement les campagnes publiées et actives

Comportement contextuel

Le sélecteur adapte son comportement en fonction du contexte :

  • Pages spécifiques aux campagnes : Respecte le contexte de la campagne actuelle
  • Formulaires intégrés : Fonctionne de manière transparente avec les shortcodes et les widgets
  • Formulaires modaux : Compatible avec les formulaires de don pop-up et superposés
  • Formulaires multi-étapes : Maintient la sélection de la campagne tout au long du processus

Exemples d'implémentation

Implémentation de base

Le sélecteur de campagne apparaît automatiquement lorsque :

1. La fonctionnalité est activée dans les paramètres
2. Plusieurs campagnes éligibles existent
3. La page/le formulaire actuel répond aux critères d'affichage

Personnalisation du modèle

Vous pouvez remplacer le modèle par défaut en copiant /wp-content/plugins/charitable-pro/templates/donation-form/campaign-selector.php dans le répertoire /charitable/donation-form/ de votre thème actif.

Fonctions utiles

// Check if campaign selector should display
if ( charitable_get_option( 'campaign_selector_enabled' ) ) {
    // Custom logic here
}

// Get campaigns that appear in selector
$campaigns = charitable_get_campaign_selector_campaigns();

// Check if current campaign/page should show selector
$should_display = charitable_campaign_selector_should_display( $campaign_id );

Dépannage

Le sélecteur de campagne n'apparaît pas

Causes possibles : 

– La fonctionnalité n'est pas activée dans les paramètres

– Une seule campagne disponible

– La campagne actuelle est exclue des paramètres d'affichage –

Toutes les campagnes sont terminées ou entièrement financées

Solutions : 

1. Vérifiez que la fonctionnalité est activée dans les paramètres.

2. Assurez-vous qu'au moins 2 campagnes éligibles existent

3. Vérifiez les paramètres d'affichage pour la campagne actuelle

4. Examinez les paramètres d'exclusion des campagnes

Problèmes de chargement AJAX

Symptômes : 

– Les formulaires ne se mettent pas à jour lors de la sélection des campagnes

– Erreurs JavaScript dans la console du navigateur

– L'indicateur de chargement ne disparaît pas

Solutions : 

1. Videz les caches du navigateur et des plugins

2. Désactivez temporairement les plugins JavaScript conflictuels

3. Vérifiez les problèmes de compatibilité du thème

4. Vérifiez que les versions de WordPress et des plugins répondent aux exigences

Problèmes de passerelle de paiement

Symptômes : 

– Les boutons de paiement ne fonctionnent pas après le changement de campagne

– Erreurs Stripe/PayPal après la mise à jour du formulaire

Solutions : 

1. Assurez-vous que les passerelles de paiement sont correctement configurées

2. Vérifiez la compatibilité de la passerelle avec le chargement AJAX

3. Videz les caches des passerelles de paiement

4. Passez à un formulaire de don non modal avec l'option de sélection désactivée pour voir si le problème persiste.

5. Contactez le support pour les problèmes spécifiques à la passerelle

Considérations relatives aux performances

Pour les sites avec de nombreuses campagnes : 

– Envisagez d'utiliser « Campagnes sélectionnées uniquement » pour la source du menu déroulant

– Activez le regroupement par catégorie pour une meilleure organisation

– Surveillez les temps de chargement des pages avec de longues listes de campagnes

– Envisagez des solutions de mise en cache pour les sites à fort trafic

Ressources pour les développeurs

Accroches et filtres

// Filter available campaigns for selector
add_filter( 'charitable_campaign_selector_campaigns', 'custom_filter_campaigns' );

// Modify selector display conditions
add_filter( 'charitable_campaign_selector_should_display', 'custom_display_logic', 10, 2 );

// Customize AJAX response data
add_filter( 'charitable_campaign_selector_ajax_response', 'custom_ajax_data' );

Personnalisation CSS

Ciblez ces classes pour un style personnalisé :

/* Main container */
.charitable-campaign-selector {}

/* Dropdown styling */
.charitable-campaign-selector select {}

/* Loading state */
.charitable-campaign-selector.loading {}

/* Tooltip styling */
.charitable-campaign-selector-tooltip {}

Pour une assistance supplémentaire avec la fonctionnalité de sélection de campagnes, veuillez consulter notre documentation d'assistance ou contacter notre équipe.

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 collectes sans mot de passe : inscrivez-vous avec juste une adresse e-mail !

Les donateurs arrivent en voulant aider, et ensuite le formulaire leur demande d'inventer un mot de passe pour un site web qu'ils ne visiteront peut-être que deux fois. Beaucoup d'entre eux s'arrêtent là. Les comptes de collecte sans mot de passe, nouveauté de Charitable Ambassadors 3.5.0, permettent à un donateur de lancer une collecte de pair à pair avec rien d'autre qu'une adresse e-mail. Pourquoi c'est important :

  • 🔑 Aucune étape de mot de passe pour les perdre : Activez-la dans Charitable » Ambassadeurs » Modèles » Formulaire de soumission et le formulaire de création de collecte ne demande qu'un nom, une adresse e-mail et un titre de page.
  • 👤 Toujours un vrai compte WordPress : Un clic dans un e-mail confirme l'adresse, les connecte et crée le compte, afin qu'ils puissent revenir plus tard pour modifier leur histoire, changer leur photo et voir qui a fait un don.
  • 🎚️ Votre choix pour chaque campagne : Chaque campagne de pair à pair peut suivre la valeur par défaut du site ou la remplacer, ce qui est important lorsqu'une campagne paie les collecteurs via Stripe Connect et que ces personnes ont besoin d'un mot de passe.
  • 📋 Voir qui n'a pas encore cliqué : L'onglet Charitable » Ambassadeurs » Répertoire » En attente de connexion liste tous ceux qui attendent encore, avec la campagne qu'ils ont rejointe et un bouton Réenvoyer, afin qu'une faute de frappe ou un dossier de spam puisse être repéré et corrigé.
  • 🛡️ Liens que les scanners ne peuvent pas épuiser : L'ouverture du lien n'affiche qu'une page, et votre collecteur est connecté lorsqu'il appuie sur le bouton, de sorte que les scanners d'e-mails d'entreprise n'épuisent jamais le lien. Chacun fonctionne une fois, expire de lui-même et n'est stocké que sous forme de hachage.

Consultez notre annonce ici.

ambassadeurs Nouveau

🏃 Présentation de l'activité : Montrez les progrès au-delà de l'argent !

La plupart des collectes de fonds peer-to-peer ne se résument pas à l'argent. Un marathon de lecture porte sur les minutes lues, un marathon de marche sur les kilomètres parcourus et une collecte de nourriture sur les repas préparés. L'activité pour les Ambassadeurs Caritatifs permet à vos collecteurs de fonds de montrer cet effort juste à côté des dollars qu'ils collectent. Pourquoi c'est important :

  • 🎯 Progrès sur ce que vous comptez réellement : Une barre de progression montre chaque élément que vous comptez par rapport à sa propre cible, juste à côté de l'argent collecté.
  • 🏅 Jalons pour les choses oui ou non : Un badge de jalon marque les efforts qui sont simplement faits ou non faits, sans chiffre à atteindre.
  • ✍️ Les collecteurs de fonds enregistrent leurs propres chiffres : Vos supporters saisissent leurs totaux depuis leurs propres pages, de sorte que l'effort cesse de vivre dans une feuille de calcul, un commentaire ou nulle part ailleurs.
  • 🤖 Certains chiffres se comptent eux-mêmes : Une étiquette AUTOMATIQUE apparaît partout où le site a calculé le chiffre à partir des dons complétés, afin que vous puissiez voir en un coup d'œil ce que personne n'a tapé.
  • 🧩 Configurez une fois, utilisez partout : Vous décidez ce qui est compté une fois, puis vous choisissez quelles campagnes le comptent. Disponible dès maintenant dans Charitable Ambassadors 3.4.7, sans nouveau plugin et sans développeur.

Consultez notre annonce ici.

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.