Requis : plugin Charitable Pro 1.8.16+
Plan Pro et supérieur

Vous souhaitez créer un ensemble de récompenses que vous pouvez utiliser dans toutes vos campagnes ? Dans Charitable Rewards, vos récompenses résident dans un catalogue, qui est une bibliothèque partagée que vous créez une fois et utilisez pour n'importe quelle campagne.

Ce guide couvre les 4 types de récompenses, les champs que chaque récompense comporte, l'attachement des récompenses aux campagnes, l'inventaire et l'archivage.

Un sac fourre-tout que vous avez créé pour l'appel de printemps peut également servir pour l'appel d'automne, sans avoir à le recréer.

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

Ce que contient ce guide ?

Regarder la vidéo

Cette vidéo vous montre comment créer une récompense dans le catalogue et l'attacher à une campagne.

Où trouver le catalogue

Pour commencer, rendez-vous sur Charitable » Récompenses » Catalogue dans votre administration WordPress.

À partir de là, cliquez sur « Ajouter une récompense » pour créer une nouvelle récompense, ou cliquez sur le titre d'une récompense pour la modifier.

Les 4 types de récompenses

Le type d'une récompense détermine ce que Rewards fait lorsqu'un donateur l'obtient. Pour en choisir un, demandez-vous ce qui doit se passer ensuite.

Type	Utilisez-le lorsque	Ce qui se passe lors d'une réclamation
Reconnaissance	Il n'y a rien à livrer, comme un nom sur un mur de donateurs ou une mention dans le rapport annuel.	C'est enregistré et terminé, et cela ne rejoint jamais la liste de traitement
Numérique	Vous envoyez un fichier, un lien ou un code.	Il est livré par e-mail via un lien de téléchargement sécurisé et expirant.
Physique	Vous envoyez quelque chose par la poste.	Rewards collecte une adresse d'expédition et l'ajoute à la liste de traitement.
Adhésion	C'est un avantage continu plutôt qu'un objet.	Il est enregistré comme réclamé et peut être renouvelé si le don récurrent.

Important : Le type d'une récompense ne peut pas être modifié après sa création. C'est le seul choix dans Rewards que vous ne pouvez pas annuler, et tout le reste concernant une récompense reste modifiable.

La raison est que le type contrôle des éléments qui se sont déjà produits au moment où vous voudriez le changer. Une récompense numérique a envoyé des liens de téléchargement, et une récompense physique a collecté des adresses.

Changer le type laisserait ces enregistrements décrire quelque chose qui ne correspond plus. Si vous avez choisi le mauvais type, créez un remplacement et archivez l'original.

Ce que chaque récompense comporte

Champ	Remarques
Titre	Obligatoire. C'est ce que les donateurs voient sur la carte.
Description	Gardez-le à une phrase, car un texte long rend les cartes inégales.
Type	Obligatoire et permanent.
Montant	Le don qui la débloque, ou le prix si utilisé sur un niveau.
Valeur marchande.	Ce que coûterait l'article à l'achat. Cela détermine le reçu fiscal.
Image.	L'image de la carte.
Plafond d'inventaire.	Une limite facultative sur le nombre de réclamations possibles.
Afficher le reste.	Si les donateurs voient « 147 sur 150 restants ».
Livraison estimée.	Récompenses physiques uniquement. Texte libre, affiché aux donateurs.
Comportement récurrent.	Si un renouvellement crée une nouvelle réclamation.

La juste valeur marchande n'est pas la même que le montant

Le montant est ce qu'un donateur doit donner pour gagner la récompense. La valeur marchande est ce que l'article coûterait à l'achat. Un sac fourre-tout qui se débloque à 75 $ pourrait avoir une valeur marchande de 12 $.

Ils sont séparés car la partie déductible d'un don est le montant moins la valeur reçue. Voir Reçus fiscaux et valeur marchande pour plus d'informations.

Attacher une récompense à une campagne

Créer une récompense ne la place sur aucune campagne. La joindre le fait.

Depuis l'écran de modification d'une récompense, ou depuis le panneau Récompenses de la campagne elle-même, choisissez les campagnes sur lesquelles elle doit apparaître. Chaque pièce jointe peut avoir ses propres paramètres, de sorte que la même récompense peut se comporter un peu différemment dans 2 endroits.

• Un ordre d'affichage contrôle où elle se situe parmi les récompenses de cette campagne.
• Un seuil de substitution facultatif permet à 1 campagne de la débloquer à un montant différent.
• Un interrupteur activé le retire d’une campagne sans le détacher.

Inventaire partagé ou par campagne

Lorsqu’une récompense est attachée à plus d’un endroit, vous choisissez si le stock est partagé ou séparé.

Portée	Comportement
Par campagne	Chaque campagne reçoit sa propre allocation du plafond
Partagé	Toutes les campagnes attachées puisent dans 1 pool

La portée partagée est ce qui fait fonctionner le système de pair à pair. Les 50 affiches signées d’une campagne parente représentent 50 affiches au total pour toutes les pages de collecte de fonds, et non 50 par page. Voir Récompenses sur les campagnes de pair à pair.

Inventaire et épuisement des stocks

Lorsque vous définissez un plafond d’inventaire, Récompenses compte les réclamations par rapport à celui-ci. Activez « Afficher le reste » et les donateurs voient le compte sur la carte, ce qui les encourage à agir sur les articles qui sont vraiment limités.

Lorsque le plafond est atteint, la récompense passe à l’état de rupture de stock. Elle cesse d’être débloquée et la carte l’indique au lieu de disparaître silencieusement.

La réservation

Il y a un court laps de temps entre le moment où un donateur choisit une récompense et le traitement de son paiement. Sans protection, 2 personnes pourraient réclamer la dernière affiche pendant cet intervalle, et l’une d’elles serait déçue.

Récompenses place une courte pause sur un article limité pendant que le don est encore en cours de traitement, et l’article est considéré comme pris pendant ce temps.

Si le paiement aboutit, la pause devient une réclamation réelle. S’il échoue ou si le donateur part, la pause expire et l’article retourne en stock.

Vous définissez le temps de pause pour l’ensemble du site dans l’onglet Autre, comme « Pause de réservation » en minutes. Il commence à 30.

Réglez-le un peu plus longtemps que votre processus de paiement le plus lent. S’il est trop court, 2 donateurs peuvent réclamer le même article à nouveau, et s’il est trop long, les dons inachevés gardent le stock hors de portée.

Les pauses ne s’appliquent qu’aux récompenses avec un plafond d’inventaire. Une récompense illimitée n’a rien à réserver.

Archivage, car il n'y a pas de suppression

Il n’y a pas de bouton de suppression nulle part dans Récompenses, et c’est intentionnel.

Chaque enregistrement de réclamation renvoie à la récompense qui l’a produite. Supprimer une récompense laisserait les donateurs passés avec un avantage sans définition derrière lui, et cela briserait l’historique de vos propres rapports.

Archivez la récompense à la place. Une récompense archivée se comporte de 3 manières.

• Elle cesse d’être proposée pour les nouveaux dons.
• Elle disparaît de la vue par défaut du catalogue.
• Elle conserve chaque réclamation passée intacte et lisible.

L’archivage est également la bonne façon de retirer les récompenses d’Exemple : que l’assistant d’installation peut ajouter.

Conseils à garder à l'esprit

Ces habitudes gardent votre catalogue bien rangé et vos registres fiscaux faciles.

• Nommez les récompenses comme un donateur les décrirait. « Ensemble d’épingles en émail » vaut mieux que « Broche SKU 2 ».
• Attribuez une juste valeur marchande à tout objet physique, même s’il ne vaut que quelques dollars. Calculer les valeurs au moment de la déclaration de revenus est beaucoup plus difficile que de les enregistrer maintenant.
• Utilisez la Reconnaissance pour les avantages de remerciement. Cela permet de limiter la liste de préparation aux articles qui doivent réellement être expédiés.
• Si vous n’exécutez qu’une seule campagne, vous pouvez toujours considérer le catalogue comme la liste des récompenses de cette campagne. La bibliothèque ne vous coûte rien.
• Archivez les récompenses d’exemple de l’assistant avant de passer en direct.

FAQ sur la création de récompenses

J'ai choisi le mauvais type de récompense. Que dois-je faire ?

Le type ne peut pas être modifié, alors créez une récompense de remplacement avec le bon type et archivez l’original.

Pourquoi ma nouvelle récompense ne s'affiche-t-elle pas sur le formulaire de don ?

La création d'une récompense ne la place pas sur une campagne. Attachez-la à la campagne depuis l'écran de modification de la récompense ou le panneau Récompenses de la campagne.

Référence développeur

Filtres

Filtre	Défaut	Objectif
charitable_rewards_tier_image_size	miniature	Taille d'image enregistrée pour les images de carte de récompense
charitable_rewards_reservation_ttl	la valeur du paramètre	Annuler la fenêtre de réservation par programmation
charitable_rewards_catalog_search_limit	défaut du plugin	Combien de résultats la recherche du catalogue renvoie
charitable_rewards_allowed_file_types	défaut du plugin	Téléchargements autorisés pour les récompenses numériques
charitable_rewards_max_file_size	défaut du plugin	Plafond de téléchargement pour les récompenses numériques

Objet de valeur de récompense

Charitable_Rewards_Reward expose les constantes de type, de portée, de modèle d'attachement, de statut et de charge utile.

Groupe de constantes	Valeurs
Type	recognition, digital, physical, membership
Portée	library, campaign
Modèle d'attachement	threshold, tier
Statut	active, scheduled, retired, disabled

Les paramètres facultatifs se trouvent dans le tableau payload de la récompense plutôt que sous forme de colonnes. Ils sont indexés comme inventory_cap, show_remaining_inventory, estimated_delivery, recurring_claim_behavior, image_id, digital_code, digital_link, digital_file et download_limit.

Portées d'attachement

Charitable_Rewards_Attachment_Repository expose SCOPE_SHARED et SCOPE_PER_CAMPAIGN, plus un threshold_override facultatif par attachement.

Stockage

Les récompenses, les pièces jointes, les réclamations, l'activité de réclamation, les réservations et les niveaux de campagne ont chacun leur propre table. Les noms et le cycle de vie sont couverts sur la page de stockage, et les schémas ne sont pas reproduits ici car ils changent entre les versions.

Exemples de personnalisation

Réserver les récompenses limitées pendant une heure au lieu de 30 minutes.

add_filter( 'charitable_rewards_reservation_ttl', function () {
    return HOUR_IN_SECONDS;
} );

Autoriser les téléchargements ePub pour les récompenses numériques.

add_filter( 'charitable_rewards_allowed_file_types', function ( $types ) {
    $types['epub'] = 'application/epub+zip';
    return $types;
} );

En résumé

Vous savez maintenant comment créer une récompense, choisir son type, l'attacher à des campagnes, gérer son stock et l'archiver lorsque vous avez terminé.

Ensuite, choisissez un mode pour votre campagne afin que les donateurs puissent commencer à gagner des récompenses. Si vous êtes bloqué à une étape, notre équipe d'assistance est là pour vous aider.

Vous pourriez aussi vouloir lire

Ces guides prennent le relais là où votre catalogue s'arrête.

• Assistant de configuration. Suivez le parcours guidé jusqu'à votre première récompense.
• Mode automatique. Définissez des montants qui débloquent des récompenses à mesure que le don augmente.
• Mode Niveaux. Proposez des paliers tarifés qui peuvent inclure une récompense.
• Distribution des récompenses. Découvrez comment les récompenses numériques et physiques parviennent aux donateurs.
• Reçus fiscaux et juste valeur marchande. Apprenez pourquoi la juste valeur marchande est importante.