Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Mes campagnes est la page sur laquelle chaque ambassadeur arrive après s'être connecté – leur tableau de bord personnel pour les collectes de fonds qu'ils ont créées. C'est là qu'ils voient combien ils ont collecté, modifient une collecte de fonds, copient un lien de partage, recrutent de nouveaux ambassadeurs (si Invitations est activé), et passent en mode édition.

La page est rendue par un seul shortcode ([charitable_my_campaigns]) et stylisée par le même sélecteur de modèle que la page de collecte de fonds – donc un site exécutant des modèles améliorés obtient un "Mes campagnes" amélioré ; un site exécutant l'ancien obtient la vue héritée.

Quand l'utiliser

• Configuration de l'intégration – l'étape Pages de l'assistant de configuration crée automatiquement une page /my-campaigns/. Visitez-la une fois pour confirmer que le shortcode a été rendu.
• Ajustement de la mise en page – masquer la miniature, masquer le bouton de partage, trier par défaut par "montant le plus élevé collecté", etc. – le tout sans toucher au code.
• Ajout à une page existante – si vous avez déjà une page "Compte", placez [charitable_my_campaigns] dans une section existante.

Où trouver "Mes campagnes" chez les ambassadeurs

Dans votre administration WordPress, allez à Charitable » Ambassadeurs » Mes campagnes.

Le sous-onglet a deux moitiés : une colonne de paramètres à gauche, un aperçu en direct de la page visible par le visiteur à droite. L'aperçu se met à jour lorsque vous basculez les paramètres, vous pouvez donc voir l'effet sans changer d'onglet de navigateur.

Les paramètres de "Mes campagnes"

Paramètre	Défaut	Ce qu'il contrôle
Afficher la barre de recherche	Activé	L'entrée de recherche au-dessus de la liste des campagnes.
Afficher le menu déroulant de tri	Activé	Le menu déroulant de tri au-dessus de la liste.
Ordre de tri par défaut	Le plus récent d'abord	Le tri initial avec lequel la page se charge. Options : Le plus récent d'abord, Le plus ancien d'abord, Montant le plus élevé collecté, Le plus proche de l'objectif, Finissant bientôt. S'applique même si le menu déroulant est masqué.
Afficher la miniature de la campagne	Activé	L'image mise en avant sur chaque carte de campagne.
Afficher la barre de progression	Activé	La barre de progression de la collecte de fonds sur chaque carte.
Afficher le bouton de partage	Activé	Le bouton de partage sur chaque carte.
Afficher le code QR	Activé	Un lien "Code QR" dans chaque ligne qui ouvre un PNG téléchargeable de l'URL de la collecte de fonds. Ne s'affiche que si le commutateur global Codes QR est activé.

Le volet d'aperçu comprend un sélecteur d'état "Peuplé / Vide" afin que vous puissiez voir à quoi ressemble la page lorsqu'un ambassadeur a des collectes de fonds et lorsqu'il n'en a pas.

Le Shortcode

Toute la page est rendue par :

[charitable_my_campaigns]

Il ne prend aucun attribut requis. Placez-le dans n'importe quelle page ou publication ; il affiche les collectes de fonds de l'utilisateur actuel, ou un état vide s'il n'en a aucune.

Les visiteurs déconnectés voient une invite "Veuillez vous connecter" à la place. Le lien de connexion respecte le flux de connexion que vous avez configuré (l'écran de connexion intégré de Charitable par défaut).

Ce qui est rendu quand

Le rendu du shortcode dépend du paramètre Version de l’interface utilisateur (Charitable > Ambassadeurs > Général > Version de l’interface utilisateur) :

Version de l’interface utilisateur	Ce à quoi ressemble la page
Hérité	Le rendu original de la version 1.x. Liste simple, style minimal.
Amélioré	Le rendu de la version 3.0 : grille de cartes, mise en page moderne, menu de partage, carte de recrutement.
Visuel	Identique à « Amélioré pour Mes campagnes » ; la différence ne concerne que les pages de collecte de fonds elles-mêmes.

Le sous-onglet des paramètres et l’aperçu en direct reflètent la version de l’interface utilisateur sur laquelle vous vous trouvez. Si vous êtes toujours sur l’ancienne version, une bannière vous indiquera la mise à niveau.

La carte de recrutement

Si Invitations est activé et que l’utilisateur connecté est éligible au recrutement, une carte « Recruter des collecteurs de fonds » apparaît en haut de la page, au-dessus de leur grille de campagnes. La carte contient leur URL d’invitation personnelle, des boutons de partage, une ligne de statistiques et un interrupteur « Vos recrues ».

Voir Invitations – Recruter des collecteurs de fonds avec des liens personnels pour le résumé complet.

Actions par campagne

Chaque carte de campagne a une ligne d’actions en bas :

Action	Ce qu'il fait
Modifier	Ouvre la campagne dans le constructeur visuel Charitable (ou l’éditeur approprié pour la version de l’interface utilisateur de la campagne).
Partager	Ouvre le menu de partage avec les mêmes réseaux sociaux que ceux utilisés par la page de collecte de fonds elle-même.
Dons	Si le Rapport des dons du créateur est activé, liste chaque don effectué à cette campagne.
Code QR	Ouvre une fenêtre modale avec un PNG téléchargeable de l’URL du collecteur de fonds.
Recrue	(Campagnes parentes uniquement) Ouvre une fenêtre contextuelle d’URL d’invitation limitée à la campagne.

L’affichage de chaque action dépend des interrupteurs de visibilité dans les paramètres – masquez le bouton de partage sur l’ensemble du site, et il disparaîtra de chaque carte.

Rapport sur les dons du créateur de campagne

Fonctionnalité de longue date sur Mes campagnes : les ambassadeurs peuvent voir et télécharger un CSV de chaque don effectué à leur campagne. La section se trouve en bas du sous-onglet des paramètres de Mes campagnes (elle se trouvait sur le sous-onglet Général en 2.x, déplacée ici en 3.0).

Paramètre	Défaut	Ce qu'il contrôle
Autoriser l’exportation de l’historique des dons	Activé	Indique si le bouton d’action Dons apparaît sur chaque carte.
Inclure les détails personnels des donateurs anonymes	Désactivé	Indique si les donateurs anonymes sont affichés avec leur vrai nom dans l’exportation (à utiliser uniquement si votre politique de confidentialité le permet).
Inclure les dons des campagnes enfants	Désactivé	Pour les campagnes parentes : regrouper les dons des collecteurs de fonds sous-jacents dans l’exportation.

Surcharges de thème

L’ensemble du modèle est personnalisable depuis votre thème :

your-theme/charitable-pro/charitable-ambassadors/my-campaigns.php

Le modèle par défaut se trouve dans wp-content/plugins/charitable-ambassadors/templates/my-campaigns.php. Copiez-le dans votre thème pour apporter des modifications de mise en page sur l’ensemble du site qui survivront aux mises à jour du plugin.

Conseils

• Conservez la recherche et le tri activés. Une fois qu’un ambassadeur a plus de 3-4 collecteurs de fonds, les deux contrôles deviennent utiles.
• Par défaut, « Le plus collecté » pour les programmes établis. Les nouveaux ambassadeurs devraient atterrir d’abord sur leur collecteur de fonds le plus performant, pas sur le plus ancien.
• L'état vide est important. Visitez /my-campaigns/ en tant qu'utilisateur n'ayant aucune collecte de fonds et confirmez que la copie de l'état vide pointe clairement vers votre page de soumission.

---

Référence du développeur

Le reste de cette page est destiné aux développeurs qui personnalisent Mes Campagnes.

Raccourci

[charitable_my_campaigns]

Classe : Charitable_Ambassadors_My_Campaigns_Shortcode. Le rappel d'affichage renvoie directement le HTML rendu. La sortie peut être filtrée via charitable_my_campaigns_shortcode_output :

add_filter( 'charitable_my_campaigns_shortcode_output', function ( $html, $args, $atts ) {
    return $html . '<p>Need help? Email [email protected]</p>';
}, 10, 3 );

Stockage des paramètres

charitable_settings > ambassadors > my_campaigns_show_search
charitable_settings > ambassadors > my_campaigns_show_sort
charitable_settings > ambassadors > my_campaigns_default_sort
charitable_settings > ambassadors > my_campaigns_show_thumbnail
charitable_settings > ambassadors > my_campaigns_show_progress
charitable_settings > ambassadors > my_campaigns_show_share
charitable_settings > ambassadors > qr_codes_show_in_my_campaigns
charitable_settings > ambassadors > allow_creators_donation_export
charitable_settings > ambassadors > include_anonymous_donor_details
charitable_settings > ambassadors > creators_donation_export_include_child_campaigns

Lisez avec charitable_get_option( 'my_campaigns_default_sort', 'newest' ).

Version de l’interface utilisateur

charitable_ambassadors_ui_version() renvoie 'legacy', 'enhanced' ou 'visual'. Le shortcode rend le modèle approprié en fonction de cette valeur. Forcez la valeur pour les tests :

add_filter( 'pre_option_charitable_settings', function ( $v ) {
    // ...inject ambassadors.ambassadors_ui_version into the option array.
} );

Filtres

Filtre	Défaut	Objectif
charitable_my_campaigns_shortcode_output	HTML calculé	Filtrez la sortie entière du shortcode avant le retour. Reçoit ($html, $args, $atts).
ambassadeurs_caritatifs_mes_campagnes_tri_par_défaut	valeur du paramètre	Remplacez le tri par défaut par programmation.
ambassadeurs_caritatifs_mes_campagnes_afficher_recherche	valeur du paramètre	Forcez la visibilité de la recherche activée/désactivée.
ambassadeurs_caritatifs_mes_campagnes_afficher_tri	valeur du paramètre	Forcez la visibilité du menu déroulant de tri activée/désactivée.
ambassadeurs_caritatifs_mes_campagnes_afficher_vignette	valeur du paramètre	Forcez la visibilité de la miniature activée/désactivée.
ambassadeurs_caritatifs_mes_campagnes_afficher_progression	valeur du paramètre	Forcez la visibilité de la barre de progression activée/désactivée.
ambassadeurs_caritatifs_mes_campagnes_afficher_partage	valeur du paramètre	Forcez la visibilité du bouton de partage activée/désactivée.
charitable_ambassadors_my_campaigns_card_actions	tableau d'actions	Modifiez les actions en ligne sur chaque carte. (Le même hook d'action se déclenche pour la page et le flux de cartes de recrutement.)
ambassadeurs_caritatifs_mes_campagnes_arguments_requête	calculé	Modifiez les arguments WP_Query utilisés pour récupérer les campagnes de l'utilisateur actuel.

Actions

Action	Args	Se déclenche lorsque
charitable_ambassadors_my_campaigns_before_grid	$campaigns, $user_id	Juste avant le rendu de la grille de campagnes. La carte de recrutement est montée ici lorsque les Invitations sont activées.
ambassadeurs_caritatifs_mes_campagnes_après_grille	$campaigns, $user_id	Juste après la grille. À utiliser pour un bloc de pied de page supplémentaire.
charitable_ambassadors_my_campaigns_card_actions	$campaign_id, $context	Dans la ligne d'actions de chaque carte de campagne.

Modèle

templates/my-campaigns.php                                           # Legacy
templates/my-campaigns-enhanced.php                                  # Enhanced + Visual

Chemin de remplacement du thème : your-theme/charitable-pro/charitable-ambassadors/<filename>.php. Le sélecteur de modèle utilise les filtres standard de Charitable charitable_template_name + charitable_locate_template.

Capacités

Le shortcode s'affiche pour tout utilisateur connecté. Il n'y a pas de restriction de capacité d'administrateur – si vous êtes connecté, vous voyez vos propres collectes de fonds. Pour masquer Mes Campagnes à des rôles d'utilisateurs spécifiques, restreignez le shortcode au moment du rendu via charitable_my_campaigns_shortcode_output.

Exemples de personnalisation

Toujours trier par Montant collecté, quel que soit le réglage :

add_filter( 'charitable_ambassadors_my_campaigns_default_sort', function () {
    return 'most_raised';
} );

Injecter un appel à l'action « Démarrer une nouvelle collecte de fonds » en haut de la grille :

add_action( 'charitable_ambassadors_my_campaigns_before_grid', function ( $campaigns, $user_id ) {
    $url = home_url( '/submit-campaign/' );
    echo '<p class="my-campaigns-cta"><a class="button" href="' . esc_url( $url ) . '">Start a new fundraiser</a></p>';
}, 10, 2 );

Masquer le bouton Partager aux ambassadeurs non vérifiés :

add_filter( 'charitable_ambassadors_my_campaigns_show_share', function ( $show ) {
    $user_id = get_current_user_id();
    if ( '1' !== get_user_meta( $user_id, '_charitable_ambassadors_verified', true ) ) {
        return false;
    }
    return $show;
} );

Ajouter une action personnalisée en ligne (« Envoyer un e-mail aux donateurs ») à chaque carte :

add_action( 'charitable_ambassadors_my_campaigns_card_actions', function ( $campaign_id, $context ) {
    $url = add_query_arg( 'campaign_id', $campaign_id, home_url( '/email-donors/' ) );
    echo '<a class="my-campaigns-action" href="' . esc_url( $url ) . '">Email donors</a>';
}, 10, 2 );

Filtrer les campagnes affichées pour exclure charitable-rejected :

add_filter( 'charitable_my_campaigns_query_args', function ( $args ) {
    $args['post_status'] = [ 'publish', 'pending', 'draft' ]; // omit charitable-rejected
    return $args;
} );

Connexes

• Soumettre une campagne – le formulaire de soumission que les ambassadeurs utilisent pour créer une collecte de fonds.
• Page de collecte de fonds – le côté public de la collecte de fonds d'un ambassadeur.
• Invitations – la carte de recrutement qui apparaît en haut de cette page.
• Codes QR – la fenêtre modale du code QR par carte.
• Hooks & filtres dans Ambassadors – référence complète.