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.