Prérequis :

• Plugin Charitable Pro 1.8.16+
• Plan Pro et supérieur

Voulez-vous que les donateurs donnent le montant qu'ils souhaitent et voient les récompenses se débloquer à mesure que leur don augmente ? C'est ce que fait le mode automatique dans Charitable Rewards.

Ce guide explique comment le configurer, choisir ce qu'un donateur reçoit réellement, permettre aux donateurs de refuser une récompense et les options d'affichage.

Personne ne choisit de niveau dans ce mode. Les donateurs décident combien donner, et le formulaire leur montre ce que ce don rapporte.

Charitable Rewards nécessite la version 1.8.16 ou supérieure du plugin Charitable Pro, sur le plan Pro et supérieur.

La partie la plus utile est ce qui se passe juste en dessous du montant d'une récompense. Un donateur qui entre 15 $ lorsqu'un sac fourre-tout se débloque à 75 $ voit « Ajouter 60,00 $ de plus pour débloquer », ainsi qu'un bouton qui remplit le montant pour lui.

Lorsque le donateur clique sur ce bouton, 3 choses se produisent simultanément. Le montant est mis à jour, la carte devient verte et indique Débloqué, et chaque autre carte calcule son propre écart par rapport au nouveau montant.

Ce que contient ce guide ?

Regarder la vidéo

Cette vidéo montre le mode automatique sur un formulaire de don réel, de la première carte verrouillée à une récompense débloquée.

Quand utiliser le mode automatique

Le mode automatique fonctionne bien dans ces situations.

• Une page de don générale où vous ne pouvez pas prédire ce que quelqu'un donnera, et vous ne voulez pas le diriger vers des niveaux fixes.
• Un appel de fin d'année où l'objectif est d'augmenter le don moyen plutôt que d'offrir des avantages spécifiques.
• Toute campagne avec des montants suggérés déjà configurés. Les cartes de récompense se trouvent en dessous et réagissent au montant choisi.
• Campagnes de pair à pair. Les récompenses héritées ne s'affichent sur le formulaire de don d'un collecteur de fonds que lorsque le parent est en mode automatique, c'est donc le mode à utiliser pour le pair à pair.

Si vous souhaitez que les paliers eux-mêmes constituent la demande, chacun fixant son propre prix, utilisez plutôt le Mode Niveaux.

Où le trouver

Automatique est le mode par défaut. Ainsi, une campagne avec des récompenses associées est déjà dans ce mode, sauf si vous l'avez modifié.

Pour vérifier ou modifier cela, modifiez la campagne et ouvrez le panneau Récompenses dans le générateur de campagne. Le paramètre est « Mode de récompense », et il propose 2 choix : Automatique et Niveaux.

Configuration

Voici comment configurer le mode automatique pour une campagne.

1. Pour commencer, créez vos récompenses dans le Catalogue, chacune avec le montant en dollars qui doit la débloquer.
2. Ensuite, associez-les à la campagne. Le montant de chaque récompense est le montant qui la débloque.
3. Ensuite, laissez le Mode de récompense sur Automatique.
4. Si vous le souhaitez, ajustez les options d'affichage et d'empilement ci-dessous.

Les cartes apparaissent dans l'ordre d'affichage que vous avez défini lors de leur association, pas par prix. Donc, mettez-les dans l'ordre du plus bas au plus élevé, sauf si vous avez une raison de ne pas le faire.

Choisir ce qu'un donateur reçoit réellement

C'est le paramètre qui surprend le plus souvent les gens, il est donc utile de le comprendre avant de lancer.

Disons qu'un donateur donne 100 $, et que vous avez des récompenses à 25 $, 40 $ et 75 $. Reçoit-il les 3, ou seulement la meilleure ?

Mode d'empilement	Ce que le donateur reçoit	Où vous l'utiliseriez
Le plus élevé (par défaut)	Uniquement la récompense la plus précieuse qu'ils ont obtenue	La plupart des campagnes. Un donateur de 100 $ reçoit l'article de 75 $, pas 3 articles séparés à emballer.
Cumulatif	Chaque récompense à ou en dessous de leur montant	Lorsque les avantages se construisent les uns sur les autres, comme un autocollant plus un sac fourre-tout plus une mention

Sur le formulaire de don, les cartes que le donateur a dépassées mais ne recevra pas deviennent grises et indiquent « Débloqué (non accordé) ». Cette formulation prête à confusion si personne ne l'explique.

Cela signifie que le donateur a atteint ce montant, mais que l'empilement Le plus élevé n'accorde que la récompense supérieure.

Si vous souhaitez que les donateurs reçoivent tout ce qu'ils ont atteint, passez à Cumulatif.

Laisser les donateurs dire non merci

Certains donateurs préféreraient que l'intégralité du don aille à la cause plutôt que de recevoir un sac fourre-tout. Cela est plus important lorsque la juste valeur marchande d'une récompense abaisse la partie déductible des impôts du don.

Lorsque vous activez « Autoriser le refus », une case à cocher apparaît sous les cartes de récompense. Vous pouvez écrire vous-même l'étiquette, et vous pouvez utiliser une formulation différente selon que la réception fiscale est activée ou non.

• Avec la réception fiscale activée, vous pourriez utiliser quelque chose comme « Refuser les récompenses pour maximiser mon don déductible des impôts ».
• Avec elle désactivée, vous pourriez utiliser quelque chose comme « Sauter ma récompense et donner 100 % aux salles de classe ».

Lorsqu'un donateur coche la case, aucune réclamation n'est créée et l'intégralité du don reste déductible.

Options d'affichage

Option	Choix	Ce que cela change
Style d'affichage	Cartes, Lignes	Les cartes montrent une grille. Les lignes montrent une liste à colonne unique, ce qui est mieux pour les longues descriptions
Zoom d'image	Activé, Désactivé	Permet à un donateur de cliquer sur une image de récompense pour la voir en plus grand
Afficher les donateurs	Activé, Désactivé	Indique combien de donateurs ont réclamé chaque récompense
Terme pour les donateurs	Texte libre	Définit comment les appeler. « Soutien » sonne plus chaleureux que « donateur »

Note : Charitable n'a pas de promesses de don, donc les termes utilisés face au donateur sont « donateurs » et « donner », pas « bénéficiaires » et « promesse ». Le terme pour les donateurs existe car certaines campagnes préfèrent leur propre mot pour le décompte.

Ce que les donateurs voient lorsque le stock est faible

Si une récompense a un stock limité, la carte indique combien il en reste, par exemple « 147 sur 150 restants ». Lorsque la dernière est attribuée, la carte passe à un état épuisé et cesse de se débloquer.

Les récompenses bloquent également temporairement un article limité pendant qu'un don est encore en cours de paiement, afin que 2 donateurs ne puissent pas réclamer le dernier. Voir Créer des récompenses pour les limites de stock et le blocage de réservation.

Conseils à garder à l'esprit

Ces conseils aident vos cartes de récompense à encourager des dons plus importants sans confondre les donateurs.

• Échelonnez vos montants de récompense afin que chaque étape semble atteignable. Un saut de 25 $ à 250 $ est ignoré, tandis que 25 $ à 50 $ est accepté.
• Limitez les descriptions à 1 phrase. Les cartes sont disposées en grille et un texte long les rend inégales.
• Laissez le cumul sur Le plus élevé sauf si les avantages s'accumulent réellement les uns sur les autres. Cela simplifie la gestion et clarifie les attentes des donateurs.
• Si vous voyez « Débloqué (non accordé) » sur votre propre don de test, ce n'est pas un bug. Voir la section sur le cumul ci-dessus.

FAQ sur le mode automatique

Pourquoi une carte indique-t-elle « Débloqué (non accordé) » ?

Le donateur a atteint le montant de cette récompense, mais le cumul « Le plus élevé » n'accorde que la récompense supérieure. Passez à « Cumulatif » si vous souhaitez que les donateurs reçoivent toutes les récompenses qu'ils atteignent.

Pourquoi aucune récompense ne s'affiche sur ma campagne ?

Les récompenses doivent être activées sur la campagne, pas seulement attachées. Vérifiez le panneau Récompenses dans le constructeur de campagne et assurez-vous que les récompenses sont activées.

Référence développeur

Filtres

Filtre	Défaut	Objectif
charitable_rewards_stacking_mode	Charitable_Rewards_Matcher::MODE_HIGHEST	Remplace le cumul par campagne. Reçoit l'ID de la campagne comme deuxième argument
charitable_rewards_tier_image_size	miniature	Taille d'image enregistrée pour l'image de la carte
charitable_rewards_unlock_color	#1a7f37	Couleur d'accentuation pour l'état débloqué, imprimée en tant que propriété personnalisée CSS sur l'enveloppe

Clés des paramètres de campagne

Ceux-ci sont stockés sous campaign_settings_v2 dans le tableau settings.rewards de la campagne.

Clé	Valeurs	Objectif
activé	activé, vide	Si les récompenses sont rendues sur cette campagne ou non
reward_mode	automatique, niveaux	Quel mode utilise la campagne
stacking_mode	le plus élevé, cumulatif	Ce que le donateur reçoit réellement
display_style	cartes, lignes	Grille ou liste à colonne unique
image_zoom	activé, 0	Cliquer pour agrandir les images des récompenses
show_backers	activé, 0	Afficher les nombres de réclamations sur les cartes
backers_term	texte libre	Libellé utilisé pour les nombres de réclamations
allow_decline	activé, 0	Afficher la case à cocher de refus
decline_label_tax	texte libre	Texte de la case à cocher lorsque la facturation fiscale est activée
decline_label_notax	texte libre	Texte de la case à cocher lorsque la facturation fiscale est désactivée

Si activé n'est pas défini, rien ne s'affiche même lorsque des récompenses sont attachées. C'est la raison la plus courante pour laquelle une campagne n'affiche aucune récompense après que vous en ayez attaché.

Hooks de balisage

Les cartes de récompense sont rendues sur le hook charitable_donation_form_after_donation_amounts. Chaque carte porte data-reward-id et data-base-amount, et l'enveloppe porte data-stacking-mode.

Chaque carte porte 1 de ces classes d'état.

Classe	Signification
is-locked	En dessous du seuil. Affiche le bouton Ajouter visible
is-unlocked	Accordé. Affiche le badge Déverrouillé
is-superseded	Seuil franchi mais non accordé sous le cumul le plus élevé
charitable-reward-sold-out	Inventaire épuisé

Le bouton Ajouter est présent dans tous les états, mais il porte l'attribut hidden dans les états déverrouillé et remplacé. Si vous le retravaillez, respectez [hidden] ou il s'affichera comme un bloc vide.

Exemples de personnalisation

Donnez aux donateurs chaque récompense qu'ils franchissent, pas seulement la principale.

add_filter( 'charitable_rewards_stacking_mode', function () {
    return Charitable_Rewards_Matcher::MODE_CUMULATIVE;
} );

Utilisez le cumul sur 1 campagne uniquement.

add_filter( 'charitable_rewards_stacking_mode', function ( $mode, $campaign_id ) {
    return 1234 === (int) $campaign_id ? 'cumulative' : $mode;
}, 10, 2 );

Faites correspondre l'état déverrouillé à la couleur de votre marque.

add_filter( 'charitable_rewards_unlock_color', function () {
    return '#31714c';
} );

En résumé

Vous savez maintenant comment configurer le mode automatique, choisir ce que les donateurs reçoivent, leur permettre de refuser une récompense et ajuster l'apparence des cartes.

Ensuite, essayez un don test pour voir les cartes se déverrouiller. Si vous êtes bloqué à une étape, notre équipe d'assistance est là pour vous aider.

Vous pourriez aussi vouloir lire

Ces guides couvrent les autres parties des Récompenses Caritatives qui fonctionnent avec le mode automatique.

• Mode Niveaux. Utilisez des cartes de niveau de don qui définissent le montant du don à la place.
• Création de récompenses. Découvrez ce que fait chaque type de récompense, ainsi que les plafonds d'inventaire et la mise en attente des articles limités.
• Reçus fiscaux et juste valeur marchande. Voyez pourquoi un donateur pourrait refuser une récompense.
• Récompenses sur les campagnes de pair-à-pair. Découvrez pourquoi le pair-à-pair a besoin du mode automatique.