Requis :
Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Avant même que vos ambassadeurs ne commencent à collecter des fonds, quelqu'un doit décider de l'apparence de leurs pages. C'est à cela que sert l'onglet Modèles.

L'onglet Modèles est le lieu unique pour les quatre décisions les plus visuelles de votre configuration Ambassadeurs : quelle famille de modèles s'affiche (Hérité, Amélioré ou Visuel), quelle variante de mise en page la famille Améliorée utilise, votre couleur d'accentuation principale et votre style de carte.

La plupart des autres paramètres d'affichage se trouvent dans de petits sous-onglets comme Page de collecte de fonds et Mes campagnes, mais Modèles est l'orientation. C'est l'endroit où vous commencez lorsque vous décidez de l'apparence et de la convivialité du programme.

Quand l'utiliser

Vous reviendrez sur cet onglet chaque fois que quelque chose concernant l'apparence de votre programme devra changer. Les raisons les plus courantes :

• Configuration initiale : décidez si vous souhaitez conserver les modèles hérités ou passer au rendu moderne Amélioré ou Visuel.
• Actualisation de la marque : mettez à jour votre couleur d'accentuation, changez le style de carte ou choisissez une variante de mise en page différente.
• Déploiement du mode Visuel : passez d'Amélioré à Visuel et choisissez la campagne qui sert de source de conception pour toutes les pages de collecte de fonds.

Comment y accéder

Allez dans Charitable » Ambassadeurs » Modèles.

Ce qui se trouve dans l'onglet Modèles

Trois groupes de paramètres vont de haut en bas. En pratique, vous les parcourez généralement dans l'ordre : choisissez un style, puis affinez la variante ou le choix du modèle, puis ajustez votre thème.

Groupe	Ce qu'il contient
Style de modèle frontal	Trois cartes : Hérité, Amélioré, Visuel. La décision la plus importante de l'onglet.
Mise en page / Modèle	Un deuxième sélecteur qui change en fonction du style ci-dessus. Sous Amélioré, c'est le sélecteur de mise en page à 8 variantes. Sous Visuel, c'est l'autocomplétion de la campagne de modèle de collecte de fonds. Caché sous Hérité.
Thème	La couleur d'accentuation principale et la radio du style de carte.

Style de modèle frontal

C'est le commutateur principal pour le rendu de vos pages de collecte de fonds. Choisissez celui qui correspond à l'étape de vie de votre programme.

Style	Ce qui s'affiche	Choisissez quand
Hérité	Les modèles et CSS originaux de la version 1.x, inchangés.	Vous avez personnalisé les modèles ou les CSS de votre thème et vous ne voulez rien changer.
Amélioré	Les modèles 3.0 avec barres de progression, statistiques d'icônes, fenêtre contextuelle de partage et recherche. Le sélecteur de variantes apparaît ci-dessous.	Vous voulez le look moderne mais n’avez pas encore conçu de modèle de campagne personnalisé.
Visuel	Chaque page de collecte de fonds est rendue à partir d’une mise en page de constructeur de campagne visuelle que vous choisissez. Le sélecteur de campagne modèle apparaît ci-dessous.	Vous voulez un contrôle maximal de la marque ou avez une exigence de conception axée sur le sponsor.

Vous pouvez passer d’un style à l’autre à tout moment. Revenir à l’ancien mode ne fait rien perdre : votre variante améliorée enregistrée et votre pointeur de campagne modèle visuelle sont tous deux conservés. Pour en savoir plus sur le mode visuel, consultez Mode modèle visuel.

Mise en page / Modèle (Contextuel)

Ce qui apparaît dans cette section dépend du style que vous avez sélectionné ci-dessus. Il n’apparaîtra pas du tout en mode Ancien, et il change complètement entre Amélioré et Visuel.

• En mode Ancien : rien ne s’affiche ici.
• En mode Amélioré : le sélecteur de variantes de mise en page à 8 variantes. Choisissez Classique, Histoire d’abord, Statistiques d’abord, Don d’abord, Magazine, Vitrine, Affiche vitrine ou Rallye.
• En mode Visuel : l’autocomplétion de campagne modèle de collecte de fonds. Choisissez quelle campagne sur votre site sert de source de conception pour toutes les pages de collecte de fonds.

Le sélecteur de mise en page apparaît également sur le sous-onglet Page de collecte de fonds. Ce sont les mêmes sélecteurs qui partagent le même paramètre, alors choisissez-le dans le sous-onglet qui vous semble le plus naturel.

Thème

Deux paramètres affectent toutes les pages rendues par Ambassadeurs sur votre site. Définissez-les une fois et ils s’appliquent automatiquement partout.

Paramètre	Défaut	Effet
Couleur d’accentuation principale	(hérite du thème)	Utilisé par les barres de progression, les boutons principaux, les états de survol et les surlignages d’état sélectionné dans les modes Amélioré et Visuel. Défini via le sélecteur de couleur WordPress.
Style de carte	Arrondi (ombre subtile)	Trois options : Plat (pas de bordure, pas d’ombre), Arrondi (ombre subtile), Bordé (bordure de 1 px, pas d’ombre). S’applique aux cartes Mes campagnes et à la carte de don de collecte de fonds.

Pour un aperçu plus approfondi de la thématisation, y compris la variable CSS --cap-accent, la chaîne de remplacement de thème et la gestion du mode sombre, consultez Thématisation.

Comment l’onglet Modèles est lié aux autres sous-onglets

L’onglet Modèles est l’orientation. Les paramètres plus lourds par fonctionnalité se trouvent sur leurs propres sous-onglets dédiés. Voici le plan pour que vous sachiez où aller pour quoi.

Préoccupation du paramètre	Vit sur
Quelle famille de modèles	Onglet Modèles (cette page).
Variante de mise en page améliorée	Onglet Modèles ou le sous-onglet Page de collecte de fonds.
Campagne de modèle visuel	Onglet Modèles.
Comportement de la page de collecte de fonds (partage, fil d'Ariane, mur des donateurs, chrome)	Sous-onglet Page de collecte de fonds.
Comportement de la page Mes campagnes (recherche, tri, miniature, partage)	Sous-onglet Mes campagnes.
Sélections de réseaux de fenêtres contextuelles de partage	Réseaux de partage.
Rendu du code QR sur chaque surface	Codes QR.

La plupart des gens passent la majorité de leur temps à ajuster les modèles sur cet onglet Modèles ainsi que sur le sous-onglet Page de collecte de fonds. Les autres sont des interrupteurs marche/arrêt plus petits que vous configurerez une fois et oublierez.

Conseils à garder à l'esprit

Quelques éléments qui vous feront gagner du temps lorsque vous commencerez à définir l'apparence de votre programme.

• Choisissez Amélioré, sauf si vous avez une raison de rester sur Hérité. Les modèles améliorés rendent le même contenu que les modèles hérités, mais avec un style moderne. Vous pouvez revenir en arrière instantanément si quelque chose ne convient pas.
• Passez à Visuel lorsque des exigences de marque strictes arrivent. La plupart des sites fonctionnent bien avec Amélioré et une variante de mise en page. Visuel est la bonne approche lorsqu'un sponsor ou des directives de marque exigent un contrôle au niveau du pixel sur la conception de la page de collecte de fonds.
• Définissez votre couleur d'accentuation maintenant, même si vous restez sur Hérité pour le moment. Amélioré et Visuel la récupèrent automatiquement. La définir une fois signifie qu'un futur changement de style aura déjà votre couleur de marque intégrée.
• Utilisez les aperçus en direct sur les sous-onglets avant de vous engager. Les sous-onglets Page de collecte de fonds et Mes campagnes disposent d'aperçus SVG en direct afin que vous puissiez voir vos modifications avant de basculer les onglets du navigateur pour vérifier le front-end.

Référence développeur

Le reste de cette page est destiné aux développeurs qui personnalisent le comportement de l'onglet Modèles.

Stockage des paramètres

charitable_settings > ambassadors > ambassadors_ui_version          # 'legacy' | 'enhanced' | 'visual'
charitable_settings > ambassadors > p2p_template_campaign_id        # int (0 = none)
charitable_settings > ambassadors > ambassadors_enhanced_layout_variant
charitable_settings > ambassadors > theme_primary_color             # hex string
charitable_settings > ambassadors > theme_card_style                # 'flat' | 'rounded' | 'bordered'

Aides

charitable_ambassadors_ui_version();                                // 'legacy' | 'enhanced' | 'visual'
charitable_ambassadors_should_use_p2p_template( $fundraiser_id );   // bool
charitable_ambassadors_fundraiser_template_is_theme_overridden();   // bool

Filtres

Filtre	Défaut	Objectif
charitable_ambassadors_settings_display_fields	calculé (ancien nom du filtre)	Modifiez l'ensemble de champs dans le sous-onglet Modèles. Nom du filtre conservé pour la compatibilité ascendante avec les sites qui ont ajouté des champs à l'ancien onglet « Affichage ».
charitable_ambassadors_visual_mode_is_available	calculé	Indique si le mode Visuel est sélectionnable sur cette installation (dépend de la version Pro).
charitable_ambassadors_rally_is_available	calculé	Indique si la variante de mise en page Rally apparaît dans le sélecteur (dépend du widget Mini Donation de Pro).
charitable_ambassadors_ui_version_force	null	Force une version spécifique de l'interface utilisateur, quel que soit le paramètre enregistré. Utile pour les tests A/B.

Actions

Action	Args	Se déclenche lorsque
charitable_ambassadors_ui_version_changed	$old, $new	Le paramètre de version de l'interface utilisateur a été enregistré avec une valeur différente.
charitable_ambassadors_layout_variant_changed	$old, $new	Le paramètre de variante de mise en page améliorée a été enregistré avec une valeur différente.
charitable_ambassadors_p2p_template_campaign_changed	$old_id, $new_id	Le paramètre de campagne de modèle en mode visuel a été enregistré.

Modèles

Chaque style a son propre fichier ou famille de modèles :

Style	Chemin du modèle
Hérité	templates/campaign/<filename>.php — inchangé depuis la version 1.x
Amélioré	templates/campaign/fundraiser-page-enhanced.php (+ partiels par variante)
Visuel	Remplace la campaign_settings_v2 de la campagne de modèle dans le rendu de la collecte de fonds à l'exécution

Chemin de remplacement du thème pour Enhanced et Visual : your-theme/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php.

Capacités

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

Exemples de personnalisation

Forcer Enhanced sur les installations existantes qui n'ont pas encore défini de style :

add_filter( 'charitable_ambassadors_ui_version_force', function () {
    if ( ! get_option( 'charitable_settings' ) ) {
        return 'enhanced';
    }
    return null;
} );

Envoyer un webhook à votre CRM chaque fois que la version de l'interface utilisateur change :

add_action( 'charitable_ambassadors_ui_version_changed', function ( $old, $new ) {
    wp_remote_post( 'https://crm.example.com/hooks/charitable', [
        'body' => [ 'event' => 'ui_version_changed', 'from' => $old, 'to' => $new ],
    ] );
}, 10, 2 );

Forcer le style Carte à Bordure pour un programme strictement conforme à la marque :

add_filter( 'pre_option_charitable_settings', function ( $value ) {
    if ( ! is_array( $value ) ) {
        return $value;
    }
    if ( isset( $value['ambassadors']['theme_card_style'] ) ) {
        $value['ambassadors']['theme_card_style'] = 'bordered';
    }
    return $value;
} );

Ajouter une bannière réservée aux administrateurs lorsque le mode Visuel est actif :

add_action( 'admin_notices', function () {
    if ( 'visual' === charitable_ambassadors_ui_version() ) {
        echo '
Visual mode is active. Edit the template campaign to change every fundraiser page at once.
';
    }
} );

En résumé

Cela couvre tout ce qui concerne l’onglet Modèles. Que vous preniez une décision rapide lors de votre première installation ou que vous peaufiniez une configuration visuelle contrôlée par la marque, c’est là que tout commence. Choisissez votre style, sélectionnez une mise en page, définissez votre couleur d’accentuation, et tout le reste suivra.

Si vous avez des questions ou besoin d’aide pour décider quel style convient le mieux à votre programme, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ces documents couvrent les paramètres qui découlent de l’onglet Modèles. Marquez ceux qui sont les plus pertinents pour la configuration de votre programme.

• Page de collecte de fonds – les commutateurs d’affichage par collecte de fonds qui se trouvent dans l’onglet voisin.
• Variantes de mise en page – une analyse approfondie de chacune des huit variantes améliorées.
• Mode de modèle visuel – comment fonctionne le chemin de rendu visuel et comment configurer votre campagne de modèle.
• Thèmes – couleur d’accentuation, la variable CSS --cap-accent, et la chaîne complète de substitution de thème.
• Mes campagnes – paramètres d’affichage pour la page du tableau de bord visible par les ambassadeurs.
• Hooks & filtres dans Ambassadeurs – la référence complète pour les développeurs.