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

Vous organisez des collectes de fonds de pair à pair et souhaitez que chaque page de collecte de fonds propose les mêmes récompenses ? Avec Charitable Ambassadors, les récompenses attachées à la campagne mère apparaissent sur chaque page de collecte de fonds en dessous.

Ce guide explique comment fonctionne l'héritage, comment le configurer, les 2 vérifications qui expliquent la plupart des problèmes, le stock partagé et la disposition des récompenses des Ambassadeurs.

Vous définissez les niveaux une fois, et 200 ambassadeurs proposent tous les mêmes.

Charitable Rewards nécessite la version 1.8.16 ou supérieure du plugin Charitable Pro, sur le plan Pro et supérieur. Les récompenses sur les campagnes de pair à pair nécessitent également Charitable Ambassadors 3.0.0 ou supérieur.

Ce que contient ce guide ?

Regarder la vidéo

Si vous préférez regarder plutôt que lire, cette courte vidéo montre les récompenses sur une page de collecte de fonds.

Pourquoi ça fonctionne ainsi

Les récompenses sont détenues par votre organisation. Un ambassadeur individuel ne peut pas inventer ses propres avantages, modifier les prix ou supprimer ceux que vous avez définis.

C'est intentionnel. Si chaque ambassadeur pouvait définir des récompenses, vous rempliriez 200 promesses différentes à 200 prix différents, sans aucun moyen de savoir ce que vous avez promis.

Pour cette raison, le formulaire de soumission du collecteur de fonds remplace son éditeur de montants suggérés par une courte note. La note explique que les niveaux appartiennent à l'organisateur, de sorte que les ambassadeurs ne voient pas un paramètre qu'ils ne peuvent pas utiliser.

Configuration

1. Pour commencer, attachez les récompenses à la campagne mère, et non aux pages de collecte de fonds individuelles.
2. Sur toute récompense avec une limite de stock, définissez la portée de l'inventaire sur partagée, afin que tous les collecteurs de fonds puisent dans un seul pool.
3. Ensuite, mettez la campagne mère en mode automatique. C'est plus important qu'il n'y paraît, comme l'explique la section suivante.
4. Si vous souhaitez une page de style crowdfunding, vous pouvez également définir la disposition de la page de collecte de fonds des Ambassadeurs sur la variante récompenses.

La campagne mère doit être en mode automatique

C'est le paramètre le plus susceptible de vous faire penser que les récompenses sont cassées sur le pair à pair.

Les récompenses héritées apparaissent sur le formulaire de don d’un collecteur de fonds uniquement lorsque la campagne parente est en mode automatique. Si la campagne parente est en mode niveaux, le formulaire de don du collecteur de fonds n’affiche aucune récompense.

La raison est qu’un niveau de don définit le montant du don. Sur une page de collecteur de fonds, le montant doit rester le choix du donateur pour que les totaux soient correctement répercutés sur la campagne parente. Par conséquent, Récompenses n’affiche rien plutôt que des niveaux qui ne peuvent pas fonctionner.

Ainsi, en mode niveaux, une page de collecteur de fonds affiche des cartes de récompenses sur la page, mais rien sur le formulaire de don. La page a l’air correcte et le formulaire semble vide, ce qui ressemble exactement à un bug.

Si le formulaire de don d’un collecteur de fonds n’affiche aucune récompense, vérifiez d’abord le mode de la campagne parente.

L'autre moitié de la même vérification

Il y a une deuxième condition à connaître. Les récompenses de la campagne parente doivent être activées, pas seulement attachées.

Attacher des récompenses à une campagne ne l’active pas pour celle-ci. Si le paramètre de récompenses de la campagne parente est désactivé, les collecteurs de fonds n’héritent de rien, même si le catalogue montre les récompenses comme étant attachées.

À elles deux, ces 2 conditions expliquent près de tous les rapports du type « l’héritage ne fonctionne pas ».

L'inventaire partagé est le but

Une récompense avec une limite de stock de 50 et une portée partagée signifie 50 au total pour l’ensemble du programme. Une portée par campagne signifierait 50 pour chaque collecteur de fonds, ce qui, pour 200 collecteurs de fonds, fait 10 000 affiches.

Partagée est presque toujours ce que vous voulez pour le pair-à-pair, alors définissez-la lorsque vous attachez la récompense. Voir Créer des récompenses.

Ce que les niveaux font sur les pages de collecte de fonds

Les niveaux sont en affichage seul sur les pages de collecteurs de fonds. Une page de collecteur de fonds affiche les récompenses de la campagne parente sous forme de cartes à seuil, quel que soit le mode de récompense de la campagne parente.

C’est parce qu’un niveau sélectionnable nécessite que le niveau définisse le montant, et le formulaire d’un collecteur de fonds ne le fait pas. Les donateurs sur une page de collecteur de fonds donnent un montant et débloquent automatiquement des récompenses, plutôt que de choisir un niveau.

La disposition des récompenses des ambassadeurs

Ambassadors est livré avec une mise en page de page de collecteur de fonds conçue autour des récompenses. C’est une page de style crowdfunding avec les cartes de récompenses dans une barre latérale fixe, des onglets pour l’histoire, les mises à jour et les donateurs, et la ligne du nom du collecteur de fonds.

Vous pouvez le définir dans l’onglet Modèles d’Ambassadors. La mise en page n’est sélectionnable que lorsque Récompenses est actif.

Si Récompenses est installé mais désactivé, la carte propose de l’activer. S’il n’est pas installé, la carte renvoie vers l’endroit où vous pouvez l’obtenir.

Conseils à garder à l'esprit

Ces habitudes permettent aux récompenses de fonctionner sur chaque page de collecteur de fonds.

• Mettez la campagne parente en mode automatique et laissez-la ainsi. Les récompenses pair-à-pair sont conçues autour de cette configuration.
• Utilisez la portée d’inventaire partagée sur chaque récompense avec une limite de stock, à chaque fois.
• Lorsque l’héritage semble défectueux, vérifiez d’abord le paramètre de récompenses de la campagne parente et son mode avant toute autre chose.
• La gestion des commandes reste la vôtre. Les réclamations de 200 collecteurs de fonds atterrissent toutes dans une seule liste dans votre administration.

FAQ sur les récompenses pour les campagnes de collecte de fonds de pair à pair

Pourquoi le formulaire de don d’un collecteur de fonds n’affiche-t-il aucune récompense ?

Vérifiez que la campagne parente est en mode automatique et que son paramètre de récompenses est activé. Ces 2 conditions expliquent presque tous les cas.

Un ambassadeur peut-il ajouter ses propres récompenses ?

Non. Les récompenses appartiennent à votre organisation, donc les collecteurs de fonds ne peuvent pas les ajouter, les modifier ou les supprimer.

Chaque collecteur de fonds reçoit-il son propre stock ?

Uniquement si vous choisissez une portée par campagne. Avec une portée partagée, chaque collecte de fonds provient d'un seul pool.

Référence développeur

Résolution

Charitable_Rewards_P2P_Source::resolve_source_campaign_id() associe une campagne enfant à la campagne parente qui possède ses récompenses.

La page de collecte de fonds lit directement les récompenses du parent résolu. C'est pourquoi la page peut afficher des cartes même dans les cas où le formulaire de don ne le peut pas.

La porte d'héritage

Charitable_Rewards_Public::should_render_inherited_rewards( $campaign_id, $source_id, $source_enabled, $source_mode ) décide si le formulaire de don d'un enfant affiche les récompenses héritées. Il renvoie false dans l'un ou l'autre de ces cas.

1. La campagne source n'a pas les récompenses activées.
2. La requête concerne un enfant et la campagne source est en mode levels.

Les deux sont intentionnels. Le second est la condition décrite ci-dessus.

Détection

Filtre	Objectif
charitable_rewards_ambassadors_active	Remplacer si Rewards pense que Ambassadors est présent

Portée de la pièce jointe

Charitable_Rewards_Attachment_Repository::SCOPE_SHARED est la portée qui fait qu'un seul pool d'inventaire dessert chaque collecte de fonds. SCOPE_PER_CAMPAIGN donne à chacune sa propre allocation.

Exemples de personnalisation

Afficher les récompenses héritées sur les enfants même lorsque le parent est en mode niveaux.

// Not recommended. Levels cannot set the amount on a child form, so the cards
// will appear without their pickable behavior.
add_filter( 'charitable_rewards_ambassadors_active', '__return_true' );

Le portail lui-même n'est pas filtrable, et c'est délibéré. La restriction de niveaux existe parce que le comportement ne fonctionne pas sur un formulaire enfant, et non comme un choix politique.

En résumé

Vous savez maintenant comment les pages de collecte de fonds héritent des récompenses, les 2 paramètres à vérifier lorsqu'elles n'apparaissent pas, et comment partager le stock sur l'ensemble de votre programme.

Si vous êtes bloqué à une étape, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ces guides couvrent les paramètres dont dépendent les récompenses de pair à pair.

• Créer des récompenses. Choisissez entre la portée d'inventaire partagée et par campagne.
• Mode automatique. Configurez le mode dont les récompenses de pair à pair ont besoin.
• Mode niveaux. Découvrez pourquoi les niveaux ne se reportent pas sur les formulaires de collecte de fonds.
• Ambassadeurs caritatifs. Configurez la collecte de fonds de pair à pair elle-même.