Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Chaque collecte de fonds d'ambassadeur sur votre site a sa propre page publique – celle sur laquelle atterrissent leurs donateurs lorsqu'ils cliquent sur le lien de partage. Le sous-onglet Page de collecte de fonds est l'endroit où vous décidez comment cette page est construite : quelle variante de mise en page elle utilise, si la fenêtre contextuelle de partage est activée, où se trouve le mur des donateurs, si les commentaires sont activés, ce qui se passe lorsque l'ambassadeur oublie de télécharger une image de héros.

Les paramètres sont organisés dans une vue à deux colonnes : les contrôles à gauche, un aperçu SVG en direct de la page résultante à droite. L'aperçu se met à jour lorsque vous basculez les paramètres – ainsi, avant même de regarder une vraie collecte de fonds, vous pouvez voir la forme de la page que vous configurez.

Quand l'utiliser

• Choisir votre style visuel – passez de la mise en page classique par défaut à "Story-Forward", "Magazine" ou l'une des huit variantes.
• Resserrer la présentation – masquez la navigation des articles injectée par le thème, les commentaires et les signatures d'auteur afin que la page de collecte de fonds ressemble à ce que vous avez conçu, et non à la façon dont votre thème l'habille.
• Image de marque – votre couleur d'accentuation principale (définie sous Charitable > Paramètres > Avancé > Couleur primaire du thème) se reflète sur le bouton d'appel à l'action, la barre de progression et l'état de survol de chaque page de collecte de fonds.
• Ajuster le placement – déplacez le mur des donateurs en haut, masquez-le entièrement ou laissez-le en bas de la page.

Où trouver les paramètres de la page de collecte de fonds

Dans votre administration WordPress, allez à Charitable » Ambassadeurs » Modèles » Page de collecte de fonds.

Personnalisation de la page de collecte de fonds

Dans les paramètres de la page de collecte de fonds, vous pouvez faire ce qui suit :

• Afficher le fil d'Ariane parent : Ceci montre à quelle campagne parente cette page appartient. Elle ne s'affichera que si la page a une campagne parente.
• Afficher la fenêtre contextuelle de partage : Ceci affiche la fenêtre contextuelle sur la page de collecte de fonds pour que les donateurs puissent la partager facilement. Vous pouvez choisir les plateformes sociales qui y sont affichées sous l'onglet Divers.
• Afficher la section des commentaires : Affiche une section de commentaires sous l'histoire de la collecte de fonds.
• Afficher le code QR sur la page de collecte de fonds : Affiche un code QR qui renvoie à cette collecte de fonds.
• Position du mur des donateurs : Choisissez où apparaît le mur des donateurs qui affiche les donateurs récents.
• Image de héros de secours : Si un ambassadeur n'a pas téléchargé d'image mise en avant, vous pouvez choisir de masquer la section héros ou d'utiliser l'image mise en avant de la campagne parente.
• Nettoyer la présentation du thème : Ceci remplace le style de votre thème actif uniquement sur les pages de collecte de fonds d'ambassadeurs. Ainsi, ces pages ressembleront à ce que vous avez conçu.

Assurez-vous de sauvegarder vos modifications avant de quitter cette page.

Choisir une variante de mise en page

Huit variantes de mise en page sont livrées avec Ambassadors 3.0. Chacune réorganise les mêmes blocs de construction (héros, histoire, carte de don, mur des donateurs, fenêtre contextuelle de partage) dans une forme différente.

Sous l'onglet Charitable » Modèles, vous pouvez choisir parmi ces 8 mises en page. Celles-ci dictent l'apparence/le style de la page de collecte de fonds sur le frontend.

Variante	Ce que ça donne
Classique	Héro, histoire à gauche, carte de don à droite. Le choix sûr par défaut.
Histoire d'abord	Héro, puis histoire, puis une bande de conversion. Idéal pour les causes émotionnelles.
Statistiques d'abord	Mettez en avant les progrès et les statistiques. Idéal pour les collectes de fonds de course et d'événements.
Don d'abord	Carte de don en haut, histoire réduite en dessous. Idéal pour les collectes de fonds ponctuelles à faible friction.
Magazine	Éditorial – grand titre au-dessus d'un héro cinématique. Idéal pour les organisations de marque.
Vitrine	Axé sur l'image avec navigation par ancrage fixe. Idéal lorsque vous avez de superbes photos de héro.
Affiche de vitrine	Titre centré avec badges superposés et don intégré. Idéal pour les collectes de fonds d'événements à haute énergie.
Rassemblement	Deux colonnes avec mini widget de don, carte QR et héro avec logo superposé. Idéal pour les événements sponsorisés ou de marque. (Nécessite Charitable Pro 1.8.13.1+ pour le mini widget de don.)

Chaque carte a une petite illustration qui prévisualise la forme de la variante. Cliquez sur une carte pour la sélectionner ; le volet de prévisualisation à droite se met à jour immédiatement pour montrer à quoi ressemblerait votre page de collecte de fonds avec cette variante + votre couleur d'accent choisie.

Pour une analyse approfondie de chaque variante – quand la choisir, à quoi s'attendre sur mobile, considérations thématiques – consultez Variantes de mise en page.

L'emplacement personnalisé

Si un thème surcharge le modèle de collecte de fonds amélioré via le chemin de surcharge standard (votre-thème/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php), une neuvième carte intitulée Personnalisé apparaît dans le sélecteur, étiquetée « Rendu actuellement » :

La carte personnalisée est informative – votre surcharge de thème l'emporte, quelle que soit la variante intégrée sélectionnée. La variante intégrée sélectionnée reste sélectionnée afin qu'elle reprenne si/quand vous supprimez la surcharge. Supprimez le fichier de surcharge et le prochain chargement de page reviendra à la variante choisie.

Les autres réglages

Sous le sélecteur de mise en page, l'onglet des paramètres contient une pile d'interrupteurs et de boutons radio :

Paramètre	Défaut	Effet
Afficher le fil d'Ariane du parent	Activé	Affiche le lien « partie de [campagne parente] » en haut des pages de collecte de fonds. Se masque automatiquement lorsqu'il n'y a pas de parent.
Afficher la fenêtre contextuelle de partage	Activé	La fenêtre contextuelle de partage (les réseaux proviennent de Réseaux de partage).
Afficher la section des commentaires	Désactivé	Commentaires natifs de WP. Connectez wpDiscuz, Disqus, etc. via charitable_ambassadors_fundraiser_show_comments.
Afficher le code QR sur la page de collecte de fonds	Activé (nouvelles installations)	Interrupteur principal pour le QR sur la page de collecte de fonds.
Afficher la vignette QR dans la fenêtre contextuelle de partage	Activé	Ajoute une vignette QR à la fenêtre contextuelle de partage, à côté de Facebook / X / LinkedIn / Email. Nécessite le maître QR ci-dessus.
Position du mur des donateurs	Bas	Haut, Bas ou Masquer.
Image de secours pour le héros	Parent en vedette	Que faire lorsque l'ambassadeur n'a pas téléchargé d'image : utiliser la mise en avant du parent, utiliser la valeur par défaut configurée du parent, ou masquer le héros.
Thème épuré Chrome	Activé	Supprime l'enveloppe de publication unique du thème actif : doublon du titre de la page, bande auteur/date, navigation précédent/suivant, formulaire de commentaires par défaut. Modes amélioré et visuel uniquement.

L'aperçu en direct

La colonne de droite montre une maquette SVG de ce à quoi ressemblera une collecte de fonds avec vos paramètres actuels :

L'aperçu est sensible aux variantes : choisissez "Story-Forward" et l'aperçu se ré-affiche pour montrer le flux de l'histoire. La couleur d'accentuation est extraite de Charitable » Paramètres » Avancé » Couleur primaire du thème afin que l'aperçu corresponde à ce que votre site affiche réellement.

Une phrase d'état au-dessus de l'aperçu décrit l'état actif ("Disposition magazine, accentuation #1db954, héros visible, fenêtre contextuelle de partage activée"). La phrase est accessible aux lecteurs d'écran.

Ce qui se passe sur une vraie page de collecte de fonds

Une fois que vous avez configuré l'onglet, chaque collecte de fonds sur votre site s'affiche avec ces choix. Deux couches peuvent remplacer par collecte de fonds :

1. Modèle de mode visuel – lorsqu'une campagne de modèle pair-à-pair est configurée, le campaign_settings_v2 du modèle est cloné pour la collecte de fonds au moment de la lecture. Voir Mode Modèle Visuel pour le flux complet.
2. Remplacements de thème – votre thème peut remplacer le modèle entier via votre-thème/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php. L'emplacement personnalisé dans le sélecteur indique que cela est en vigueur.

Si aucun remplacement n'est actif, la variante + les bascules que vous avez choisies ici sont ce qui s'affiche.

Conseils

• Faites correspondre la variante à la cause. Les causes émotionnelles (mémoriaux, fonds de détresse) conviennent à "Story-Forward". Les événements (marathons, galas) conviennent à "Stats-Forward" ou "Showcase Poster".
• Essayez "Donate-First" sur les campagnes axées sur le mobile. Lorsque la majorité de votre trafic provient d'un message texte partagé, la carte de don doit être la première chose à l'écran.
• Utilisez "Clean Theme Chrome" avec libéralité. Les thèmes varient considérablement dans la façon dont ils encapsulent les publications singulières ; la suppression nettoie automatiquement 95 % des collisions de mise en page.
• N'activez pas les commentaires à moins que vous n'ayez géré la modération. Les pages de collecte de fonds sont liées publiquement ; les commentaires de spam les trouvent.

---

Référence du développeur

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

Stockage des paramètres

charitable_settings > ambassadors > ambassadors_enhanced_layout_variant   # 'classic' (default) | 'story-forward' | 'stats-forward' | 'donate-first' | 'magazine' | 'showcase' | 'showcase-poster' | 'rally'
charitable_settings > ambassadors > fundraiser_show_breadcrumb            # bool
charitable_settings > ambassadors > fundraiser_show_share                 # bool
charitable_settings > ambassadors > fundraiser_show_comments              # bool
charitable_settings > ambassadors > qr_codes_show_on_fundraiser_page      # bool
charitable_settings > ambassadors > qr_codes_show_on_share_popover        # bool
charitable_settings > ambassadors > fundraiser_donor_wall_position        # 'top' | 'bottom' | 'off'
charitable_settings > ambassadors > fundraiser_hero_image_fallback        # 'parent_featured' | 'ambassadors_default' | 'hide'
charitable_settings > ambassadors > fundraiser_clean_chrome               # bool

Slug de variante -> classe body

Chaque variante ajoute une classe body à la page de collecte de fonds côté client :

charitable-ambassadors-layout-classic
charitable-ambassadors-layout-story-forward
charitable-ambassadors-layout-stats-forward
charitable-ambassadors-layout-donate-first
charitable-ambassadors-layout-magazine
charitable-ambassadors-layout-showcase
charitable-ambassadors-layout-showcase-poster
charitable-ambassadors-layout-rally

Utilisez la classe pour un CSS ciblé sans avoir à dupliquer les modèles.

Modèle

templates/campaign/fundraiser-page-enhanced.php   # default Enhanced + Visual template

Chemin de remplacement du thème : votre-thème/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php. Une fois le fichier de remplacement créé, l'emplacement personnalisé apparaît dans le sélecteur d'administration.

Les fichiers de modèle par variante se trouvent dans templates/campaign/fundraiser-page-layouts/<slug>.php. Le répartiteur du modèle parent choisit le bon en fonction de ambassadors_enhanced_layout_variant.

Filtres

Filtre	Défaut	Objectif
variante_de_mise_en_page_améliorée_ambassadeurs_caritatifs	valeur du paramètre	Outrepasser le variant de mise en page actif au moment du rendu.
ambassadeurs_caritatifs_afficher_fil_d_ariane_de_la_collecte_de_fonds	valeur du paramètre	Forcer l'affichage ou non du fil d'Ariane.
ambassadeurs_caritatifs_partager_la_collecte_de_fonds	valeur du paramètre	Forcer l'affichage ou non de la fenêtre contextuelle de partage.
ambassadeurs_caritatifs_commentaires_de_la_collecte_de_fonds	valeur du paramètre	Forcer l'affichage ou non des commentaires. Connecter wpDiscuz / Disqus ici.
position_du_mur_des_donateurs_de_la_collecte_de_fonds_ambassadeurs_caritatifs	valeur du paramètre	Forcer la position du mur des donateurs.
image_de_remplacement_de_la_collecte_de_fonds_ambassadeurs_caritatifs	valeur du paramètre	Forcer le comportement de secours de l'image principale.
ambassadeurs_caritatifs_nettoyer_la_barre_d_adresse	valeur du paramètre	Forcer l'activation ou la désactivation de clean-chrome.
ambassadeurs_caritatifs_url_de_la_documentation_de_la_page_de_collecte_de_fonds	cette page	Outrepasser l'URL de la documentation vers laquelle le sous-onglet pointe.
ambassadeurs_caritatifs_arguments_de_rendu_de_l_atome	arguments par atome	Contrôle côté client par variant des atomes individuels (image principale, carte de don, partage, mur des donateurs).

Actions

Action	Args	Se déclenche lorsque
ambassadeurs_caritatifs_avant_l_image_principale_de_la_page_de_collecte_de_fonds	$campaign_id	Juste avant que l'atome de l'image principale ne soit rendu.
ambassadeurs_caritatifs_après_l_image_principale_de_la_page_de_collecte_de_fonds	$campaign_id	Juste après l'image principale.
ambassadeurs_caritatifs_avant_l_histoire_de_la_page_de_collecte_de_fonds	$campaign_id	Juste avant la colonne de l'histoire.
ambassadeurs_caritatifs_après_l_histoire_de_la_page_de_collecte_de_fonds	$campaign_id	Juste après la colonne de l'histoire.

(Chaque variant déclenche également ses propres actions spécifiques au variant ; voir le fichier de modèle de variant pour la liste exacte.)

Porte de la version Pro de Rally

Le variant Rally nécessite Charitable Pro 1.8.13.1+ pour le widget de mini-don. Le sélecteur masque la carte Rally sur les anciennes versions Pro. La porte est implémentée par charitable_ambassadors_rally_is_available().

Détection de slot personnalisé

Une substitution de thème est détectée par charitable_ambassadors_fundraiser_template_is_theme_overridden(). Lorsque vrai :

1. La carte personnalisée apparaît dans le sélecteur.
2. La carte est étiquetée « Rendu actuellement » au lieu de « Sélectionné ».
3. Toutes les cartes intégrées deviennent is-overridden pour qu'il soit clair qu'elles ne sont pas actives.

Supprimez le fichier de substitution et le prochain chargement de page reviendra à la carte intégrée choisie.

Capacités

Accès aux paramètres : manage_charitable_settings. Le rendu côté client n'a pas de porte de capacité.

Exemples de personnalisation

Forcer la variante « faire un don d'abord » pour tous les utilisateurs non connectés (par exemple, pour un test A/B uniquement sur mobile) :

add_filter( 'charitable_ambassadors_enhanced_layout_variant', function ( $variant ) {
    if ( ! is_user_logged_in() && wp_is_mobile() ) {
        return 'donate-first';
    }
    return $variant;
} );

Utiliser wpDiscuz au lieu des commentaires WP natifs :

add_filter( 'charitable_ambassadors_fundraiser_show_comments', '__return_true' );
add_action( 'charitable_ambassadors_fundraiser_page_after_story', function ( $campaign_id ) {
    if ( function_exists( 'wpdiscuz' ) ) {
        echo do_shortcode( '[wpdiscuz_comments]' );
    }
} );

Toujours utiliser l'image mise en avant du parent si un ambassadeur n'en a pas téléchargé :

add_filter( 'charitable_ambassadors_fundraiser_hero_image_fallback', function () {
    return 'parent_featured';
} );

Injecter une bande de logos de sponsors juste en dessous de chaque héros :

add_action( 'charitable_ambassadors_fundraiser_page_after_hero', function ( $campaign_id ) {
    echo '<div class="sponsor-strip">' . do_shortcode( '[sponsors]' ) . '</div>';
} );

Masquer la fenêtre contextuelle de partage uniquement sur les pages d'aperçu des collectes de fonds rejetées :

add_filter( 'charitable_ambassadors_fundraiser_show_share', function ( $show ) {
    if ( is_singular( 'campaign' ) && 'charitable-rejected' === get_post_status() ) {
        return false;
    }
    return $show;
} );

Connexes

• Variantes de mise en page – plongée en profondeur dans chacune des 8 variantes.
• Thèmes – couleur d'accentuation, --cap-accent, chaîne de substitution de thème.
• Mode de modèle visuel – clonage du constructeur d'une campagne modèle pour chaque collecte de fonds.
• Réseaux de partage – sur quels réseaux la fenêtre contextuelle de partage s'affiche.
• Codes QR – rendu de code QR par surface.
• Hooks & filtres dans Ambassadors – référence complète.