Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Lorsqu'une personne clique sur le lien d'invitation d'un ambassadeur, la première chose qu'elle voit est la page de destination de l'invitation. Vous voulez que cette page soit fantastique et contienne toutes les informations nécessaires à un nouvel ambassadeur. C'est le moment de la première impression : qui les invite, quelle cause ils sont invités à soutenir, et ce qu'on leur demande de faire.

La page de destination est l'une des rares pages que vous pouvez entièrement concevoir pour qu'elle corresponde à votre marque.

Dans ce guide, nous vous montrerons comment configurer et personnaliser la page.

Les détails techniques : C'est la page que vous configurerez sur votre site pour que le shortcode [charitable_invite_landing] s'y affiche. Le shortcode est le moteur de rendu, mais la page environnante (bandeau, navigation, pied de page) est votre page WordPress normale. Le shortcode insère simplement la carte de l'invitant et de la cause là où vous le placez.

Quand l'utiliser

• Configuration des invitations pour la première fois – vous avez besoin de cette page avant que la fonctionnalité ne puisse faire quoi que ce soit.
• Affiner le message – le texte par défaut fonctionne, mais l'adapter à votre public permet à la page de mieux convertir.
• Intégration au thème – vous voulez contrôler la mise en page (image de bandeau, barre latérale, pied de page) sans perdre la logique du shortcode.

Où trouver les paramètres de la page de destination des invitations

La page de destination elle-même est une page WordPress ordinaire. Le shortcode qui l'alimente est :

[charitable_invite_landing]

Pour configurer quelle page les Ambassadeurs traitent comme page de destination, allez dans votre administration WordPress et accédez à Charitable » Ambassadeurs » Invitations » Page de destination.

Créer la page de destination des invitations

1. Administration WordPress » Pages » Ajouter.
2. Donnez-lui un titre invitant – « Rejoignez notre équipe », « Devenez un collecteur de fonds », « Aidez-nous à atteindre notre objectif ».
3. Paste the shortcode into the page content:

   [charitable_invite_landing]
   

4. Publier.
5. Allez dans Charitable » Ambassadeurs » Invitations » Page de destination et choisissez cette page.

La page est maintenant prête à recevoir des recrues.

Ce qui apparaît sur votre page de destination

Le shortcode affiche trois éléments dans l'ordre :

Section	Ce qu'il contient
Bandeau de l'invitant	Avatar (Gravatar réel ou initiales colorées), nom de l'invitant, une phrase comme « Sarah vous a invité à collecter des fonds ».
Texte d'introduction (facultatif)	Le texte d'introduction de la page de destination en format riche que vous avez défini dans Invitations. Sautez-le si vous n'en voulez pas.
Carte de la cause	La campagne parente que la recrue est invitée à soutenir – image de bandeau, titre, progression des fonds collectés/objectif, nombre de donateurs.
CTA	Un bouton « Devenir un collecteur de fonds » qui renvoie à votre page de soumission de campagne, pré-rempli avec la cause via cap_campaign=<id>.

Lorsque le recrue accède directement à la page (aucun jeton, par exemple en cliquant sur un lien « À propos de ce programme »), il voit une version générique avec un contenu d'espace réservé. Le shortcode ne s'affiche jamais vide – il y a toujours quelque chose à montrer.

Trois états spéciaux

État	Ce qui s'affiche
Normal (jeton valide d'une autre personne)	Héro de l'invitant + carte de la cause + CTA Devenir un collecteur de fonds.
Auto-recrutement (l'utilisateur a cliqué sur son propre lien d'invitation pendant qu'il était connecté)	Une variante conviviale « vous ne pouvez pas vous recruter vous-même » – le héros reçoit un message d'auto-recrutement, le CTA est supprimé.
Aucun jeton (quelqu'un a visité l'URL de la page directement)	Héro générique (« Devenir un collecteur de fonds ») + une carte de cause affichant votre campagne parente la plus importante, ou une image de secours si aucune n'est configurée.

Surcharges de thème

Le shortcode est rendu à partir de templates/invite/landing.php. Pour personnaliser le balisage ou la mise en page, copiez-le dans votre thème :

your-theme/charitable-pro/charitable-ambassadors/invite/landing.php

À l'intérieur de la surcharge, vous avez accès à :

Variable	Type	Remarques
$inviter	WP_User	L'invitant (faux dans le chemin sans jeton).
$inviter_name	chaîne de caractères	Nom d'affichage (ou « Votre association » si vide).
$avatar_html	chaîne de caractères	L'avatar de l'invitant – Gravatar réel ou initiales colorées.
$cause	WP_Post	La campagne parente (faux dans le chemin sans jeton).
$cause_data	tableau	Statistiques de la cause : raised, goal, donor_count, percent.
$intro_copy	chaîne de caractères	La copie d'introduction de la page de destination (texte enrichi).
$cta_url	chaîne de caractères	L'URL Devenir un collecteur de fonds (avec cap_campaign=NNN).
$cta_label	chaîne de caractères	L'étiquette du bouton CTA (par défaut « Devenir un collecteur de fonds », filtrable).
$is_preview	bool	Vrai lorsqu'un administrateur prévisualise sans jeton.
$is_self_recruit	bool	Vrai lorsque l'utilisateur connecté est l'invitant lui-même.

Personnalisation de la copie

Les éléments les plus remplacés sur la page de destination sont les étiquettes :

Filtre	Défaut	Objectif
charitable_ambassadors_invite_landing_cta_label	« Devenir un collecteur de fonds »	Le texte du bouton sur l'appel à l'action.
charitable_ambassadors_invite_landing_inviter_verb	« vous a invité à collecter des fonds »	Utilisé dans la phrase d'accroche (« Sarah vous a invité à collecter des fonds »).
charitable_ambassadors_invite_landing_self_recruit_copy	« Vous ne pouvez pas vous recruter vous-même… »	Le corps complet affiché lorsque le recrutement personnel est déclenché.
charitable_ambassadors_invite_landing_preview_notice	notice de prévisualisation administrateur	La notice affichée aux administrateurs lorsqu'ils prévisualisent la page sans jeton.

Pour les modifications de plus longue forme (disposition différente, sections différentes), effectuez un remplacement de thème.

Classes de corps

La page reçoit deux classes de corps que vous pouvez utiliser pour du CSS ciblé :

charitable-ambassadors-invite-landing
charitable-ambassadors-invite-landing--{state}    /* normal | self-recruit | preview */

Combinez-les avec le système de conception de votre thème pour que la page ressemble au reste de votre site sans forker le modèle.

Mise en cache

La page de destination est dynamique – personnalisée par jeton d'invitation via les cookies. Ambassadors la marque comme dynamique via le filtre charitable_is_dynamic_page de Pro 1.8.15.2 afin que les plugins de cache l'ignorent. Si vous utilisez une version Pro plus ancienne qui n'a pas ce filtre, le gestionnaire d'URL émet des en-têtes no-cache lors de l'étape de redirection – mais un plugin de cache pourrait toujours mettre en cache la page de destination elle-même, ce qui romprait l'attribution. L'administrateur des invitations affiche un avertissement d'auto-vérification lorsque cet état est détecté.

Conseils

• Gardez la page ciblée. Supprimez la navigation non pertinente, les widgets de la barre latérale, les appels à l'action du pied de page. Le travail de cette page est de convertir un recrue, pas de parcourir votre site.
• Ajoutez un témoignage d'une ligne. « Sarah a collecté 4 200 $ l'année dernière – rejoignez son équipe et battons ce record » fonctionne mieux qu'une demande générique.
• Utilisez l'image de secours de la page de destination. Lorsqu'un parent n'a pas d'image mise en avant (rare mais cela arrive), l'image de secours évite que la carte de la cause n'ait l'air cassée.
• Prévisualisez sans jeton. En tant qu'administrateur, visitez l'URL de la page directement. Vous verrez la version générique – utile pour confirmer la disposition sans configurer une vraie recrue.

---

Référence du développeur

Le reste de cette page est destiné aux développeurs qui personnalisent la page de destination.

Raccourci

[charitable_invite_landing]

Le shortcode est enregistré inconditionnellement, même lorsque les Invitations sont désactivées – ainsi, une page utilisant le shortcode affiche un avis de prévisualisation réservé aux administrateurs au lieu de divulguer le texte littéral [charitable_invite_landing].

Chemin du modèle

templates/invite/landing.php     # default

Chemin de remplacement du thème : your-theme/charitable-pro/charitable-ambassadors/invite/landing.php. Le sélecteur de modèle utilise le filtre standard charitable_locate_template de Charitable.

Filtres

Filtre	Défaut	Objectif
charitable_ambassadors_invite_landing_cta_label	« Devenir un collecteur de fonds »	Libellé du bouton.
charitable_ambassadors_invite_landing_cta_url	URL de soumission de campagne	L'URL complète vers laquelle le CTA renvoie. Reçoit ($url, $cause_id).
charitable_ambassadors_invite_landing_inviter_verb	« vous a invité à collecter des fonds »	Phrase d'action dans le héros.
charitable_ambassadors_invite_landing_self_recruit_copy	chaîne calculée	Corps de l'auto-recrutement.
charitable_ambassadors_invite_landing_preview_notice	calculé	Contenu de la notification d'aperçu administrateur.
charitable_ambassadors_invite_landing_intro_copy	valeur du paramètre	Filtre le texte d'introduction rendu (après wp_kses_post).
charitable_ambassadors_invite_landing_cause_id	calculé	Remplace la campagne parente affichée sur la carte de la cause (par exemple, lorsque le jeton n'a pas de campagne, choisissez une cause spécifique mise en avant).
charitable_ambassadors_invite_landing_fallback_image_id	valeur du paramètre	L'ID de la pièce jointe de l'image de secours.
charitable_ambassadors_invite_landing_body_class	tableau	Modifie le tableau body_class appliqué aux pages de destination.

Actions

Action	Args	Se déclenche lorsque
charitable_ambassadors_invite_landing_before	$inviter, $cause, $contexte	Juste avant que le balisage du shortcode ne soit rendu.
charitable_ambassadors_invite_landing_after	$inviter, $cause, $contexte	Juste après.
charitable_ambassadors_invite_landing_rendered	$inviter, $cause, $contexte	Le shortcode a terminé son rendu.

Classe du corps

charitable-ambassadors-invite-landing est ajouté à body_class sur toute page contenant le shortcode. La variante de suffixe d'état (--normal, --self-recruit, --preview) est ajoutée à l'exécution. Ajoutez au tableau via le filtre charitable_ambassadors_invite_landing_body_class.

Aide à la détection

charitable_ambassadors_is_invite_landing_page( $post_id = null ); // bool

Utile pour activer un comportement conditionnel du thème (par exemple, masquer la barre de recherche du site sur la page de destination).

Capacités

Lecture publique. Pas de contrôle d'autorisation.

Exemples de personnalisation

Changer l'étiquette du CTA :

add_filter( 'charitable_ambassadors_invite_landing_cta_label', function () {
    return 'Sign up to fundraise';
} );

Personnaliser le message d'auto-recrutement :

add_filter( 'charitable_ambassadors_invite_landing_self_recruit_copy', function () {
    return "Looks like you're already a fundraiser! Share your invite link with friends instead.";
} );

Injecter un témoignage sous la carte de la cause :

add_action( 'charitable_ambassadors_invite_landing_after', function ( $inviter, $cause, $context ) {
    if ( ! $cause ) {
        return;
    }
    echo '<blockquote class="invite-testimonial"><p>"Joining as a fundraiser was the best decision I made this year." - Past Ambassador</p></blockquote>';
}, 10, 3 );

Masquer la navigation du site sur la page de destination :

add_filter( 'body_class', function ( $classes ) {
    if ( charitable_ambassadors_is_invite_landing_page() ) {
        $classes[] = 'no-nav';
    }
    return $classes;
} );
// ...then in your theme's CSS: body.no-nav .site-header { display: none; }

Remplace l'URL du CTA pour créer un lien profond vers une page de soumission spécifique :

add_filter( 'charitable_ambassadors_invite_landing_cta_url', function ( $url, $cause_id ) {
    return add_query_arg( 'cap_campaign', $cause_id, home_url( '/sign-up-to-fundraise/' ) );
}, 10, 2 );

Connexes

• Invitations – le document de la fonctionnalité parente.
• Comment fonctionne l’attribution – le flux de clic à crédit dont cette page fait partie.
• Comment les données d’invitation sont stockées – la table personnalisée en coulisses.
• Soumettre la campagne – la page vers laquelle le CTA renvoie.
• Hooks & filtres dans Ambassadors – référence complète.