Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Gérer un programme de collecte de fonds pair-à-pair signifie garder un œil sur beaucoup de monde. L’annuaire est l’endroit où ils se trouvent tous.

Chaque personne qui a soumis au moins un appel à dons apparaît ici. D’un seul écran, vous pouvez voir qui est vérifié, qui est le plus actif, qui s’est tu, et pour quelles causes chaque ambassadeur collecte des fonds. Vous pouvez vérifier quelqu’un en un clic, lui envoyer un e-mail personnalisé, ajouter un nouvel ambassadeur sans attendre une soumission, ou exporter toute la liste dans une feuille de calcul pour votre CRM.

Si l’Aperçu répond à « Comment se porte le programme dans l’ensemble ? », l’Annuaire répond à « Qui sont les personnes qui le dirigent ? »

Quand l'utiliser

L’Annuaire est l’écran sur lequel vous reviendrez encore et encore tout au long de la vie de votre programme. Voici les raisons les plus courantes :

• Intégration des nouveaux ambassadeurs : quelqu’un vient de s’inscrire. Recherchez son nom, vérifiez son compte, envoyez l’e-mail de bienvenue.
• Repérer les champions : triez par Montant collecté décroissant pour identifier vos meilleurs performeurs pour une reconnaissance personnelle.
• Réengager les plus discrets : filtrez sur Inactif et envoyez une petite relance personnalisée.
• Nettoyage de printemps : supprimez en masse et anonymisez les comptes qui n’ont jamais généré de collecte de fonds réelle.
• Alimenter votre CRM : exportez les lignes sélectionnées ou la liste entière en CSV.

Comment y accéder

Accédez à Charitable » Ambassadeurs » Annuaire. La page s’ouvre avec tous les ambassadeurs de votre site listés par ordre du plus récent au plus actif. Les en-têtes de colonne pour Montant collecté, Donateurs et Dernière activité sont cliquables pour trier la liste.

Les quatre vues de liste

Une sous-navigation au-dessus du tableau divise la liste des ambassadeurs en quatre portées, chacune avec son propre badge de compte afin que vous puissiez voir en un coup d’œil combien de personnes se trouvent dans chaque groupe.

Vue	Qui est dedans
Tout	Chaque ambassadeur, quel que soit son état. La vue par défaut.
Vérifié	Ambassadeurs que vous avez explicitement marqués comme vérifiés. Le badge apparaît également sur leurs pages publiques.
Non vérifié	Ambassadeurs qui n’ont pas encore été vérifiés, ce qui est l’état par défaut pour les nouvelles inscriptions.
Inactif	Ambassadeurs sans activité de collecte de fonds dans la fenêtre de seuil (90 jours par défaut). Utile pour trouver des personnes à réengager.

Les colonnes

Chaque ligne de la liste affiche les mêmes huit colonnes, vous donnant suffisamment de contexte pour agir sans avoir à ouvrir chaque profil individuellement.

Colonne	Ce qu'il montre
Case à cocher	Pour sélectionner plusieurs lignes.
Nom	Avatar (vrai Gravatar s’il est enregistré, initiales colorées sinon), nom d’affichage et e-mail.
Collectes de fonds	Nombre d’appels à dons soumis par la personne, ventilé par statut (par exemple, « 3 publiés, 1 en attente »).
Vérifié	Une coche verte s’ils sont vérifiés, un tiret sinon.
Collecté	Montant total collecté au cours de leur vie sur tous leurs appels à dons.
Donateurs	Nombre de donateurs uniques sur l'ensemble de leurs collectes de fonds.
Dernière activité	Action la plus récente de l'ambassadeur (soumission, don reçu, etc.).
Actions	Boutons en ligne : Voir le profil, Envoyer un e-mail, Voir en tant que, et plus encore.

Recherche et filtrage

La zone de recherche au-dessus du tableau effectue une recherche textuelle simple sur le nom d'affichage, l'e-mail et user_login. En dessous se trouve une ligne de filtres que vous pouvez combiner pour trouver exactement le groupe que vous recherchez.

Filtre	Ce qu'il fait
Répartition des statuts	Filtrez sur « a publié des collectes de fonds », « a des soumissions en attente » ou « n'a aucune collecte de fonds ». Utile pour le travail de nettoyage.
Recrutés	Filtrez sur les ambassadeurs qui sont venus via un lien d'invitation, ou ceux qui se sont inscrits eux-mêmes.
Rejoint de / à	Filtre de plage de dates sur la date user_registered de l'utilisateur WP.
Campagne parent	Afficher uniquement les ambassadeurs qui ont collecté des fonds pour une cause spécifique. Se pré-remplit lorsque vous cliquez sur la sous-vue Recrues d'une campagne depuis ailleurs.

Les filtres se combinent, vous pouvez donc associer Vérifié, Recruté et une plage de dates de jointure pour trouver exactement la cohorte dont vous avez besoin. Par exemple, « tous les ambassadeurs qui sont venus via des Invitations cette année et qui ont déjà été vérifiés ».

Agir sur une ligne

Chaque ligne a des boutons d'action en ligne dans la colonne Actions afin que vous puissiez effectuer les tâches les plus courantes sans ouvrir d'abord un profil.

Action	Ce qu'il fait
Profil	Ouvre la page complète du profil de l'ambassadeur.
Vérifier / Annuler la vérification	Basculement en un clic. L'insigne apparaît immédiatement sur leurs pages publiques.
Envoyer un e-mail	Ouvre une fenêtre modale où vous pouvez rédiger un e-mail unique avec substitution de balises intelligentes.
E-mail de bienvenue	Renvoie l'e-mail de bienvenue avec un lien magique unique pour une connexion automatique.
Voir en tant que	Connexion en un clic en tant qu'utilisateur pour voir ce qu'il voit sur /my-campaigns/ ou sur n'importe quelle page frontale. Définit un cookie de retour pour revenir à votre session d'administrateur.

Le profil complet de l'ambassadeur

Cliquez sur le nom d'un ambassadeur ou sur le bouton d'action Profil pour ouvrir son profil complet. Le profil est un tableau de bord à plusieurs onglets pour un seul ambassadeur, vous offrant une vue beaucoup plus approfondie que la liste seule.

• Aperçu – la carte d'un coup d'œil avec le montant total collecté, le montant de l'année en cours, le nombre de donateurs, le nombre de dons, l'état de vérification et le nombre de recrues.
• Campagnes – chaque collecte de fonds soumise par cette personne, avec le statut, le montant collecté et l'objectif.
• Dons – chaque don reçu sur l'ensemble de ses collectes de fonds, avec la date, le donateur, le montant et la collecte de fonds spécifique à laquelle il est allé.
• Données du formulaire – ce qu'ils ont rempli dans le formulaire de soumission (nom, lieu, biographie, etc.), utile lorsque vous devez vérifier un détail sans avoir à le leur demander.

Deux onglets supplémentaires, Journaux et Notes, seront disponibles dans une future version. Les partiels sont déjà sur le disque et peuvent être activés via le filtre charitable_ambassadors_directory_profile_tabs. Voir Onglets du profil d'annuaire pour une présentation complète de chaque onglet.

Actions groupées

Cochez les cases de plusieurs lignes et choisissez une Action groupée dans le menu déroulant au-dessus du tableau pour agir sur toutes en même temps. Les actions groupées sont limitées à 50 lignes par appel par défaut pour maintenir la rapidité, donc pour les tâches plus importantes, travaillez par lots.

Action	Utilisez-le lorsque
Vérifier / Annuler la vérification	Vous intégrez un lot connu d'ambassadeurs en même temps.
Renvoyer l'e-mail de bienvenue	Une poignée d'ambassadeurs n'a pas reçu l'e-mail original, ce qui est courant après avoir changé de fournisseur SMTP.
Exporter les sélectionnés en CSV	Alimentez votre CRM, créez un rapport personnalisé ou remettez une liste à une équipe marketing.
Supprimer & Anonymiser	Suppression de compte de style RGPD. Remplace les champs identifiants de l'utilisateur par des données anonymisées afin que les dons historiques restent attribuables mais que leurs informations personnelles soient supprimées.

Ajouter un ambassadeur manuellement

Parfois, vous souhaitez ajouter un ambassadeur sans attendre qu'il soumette une campagne : migration depuis une autre plateforme, réponse à une demande personnelle d'un donateur majeur souhaitant faire une campagne, ou configuration d'un compte de test. Cliquez sur Ajouter un ambassadeur en haut à droite de la page.

Le formulaire prend les mêmes champs que le formulaire de soumission public. Enregistrez, et un compte est créé. Cochez Envoyer l'e-mail de bienvenue pour envoyer le même message de bienvenue qu'un utilisateur s'inscrivant lui-même reçoit, y compris un lien magique qui le connecte directement à /my-campaigns/ afin qu'il n'ait pas à définir de mot de passe au préalable.

Exportation

Le bouton Exporter CSV en haut de la page exporte la vue actuellement filtrée, quelles que soient les lignes que vous avez sélectionnées et quel que soit l'ordre de tri actif. Si vous avez filtré sur « tous les ambassadeurs non vérifiés qui ont rejoint ce trimestre », c'est exactement ce qui est exporté. Pour un aperçu complet de ce que contient chaque colonne, consultez Exportations CSV.

Supprimer et anonymiser

Il existe deux façons de supprimer un ambassadeur de votre programme, selon que vous ayez besoin de préserver les données historiques ou de les effacer entièrement.

Chemin	Ce qui se passe
Anonymiser (recommandé, conforme au RGPD)	La connexion, l'e-mail, le nom d'affichage, le prénom et le nom de l'utilisateur, ainsi que les métadonnées PII connues sont remplacés par des valeurs anonymisées. Leurs campagnes et leur historique de dons restent intacts, mais la personne n'est plus identifiable.
Suppression définitive	L'utilisateur WP est supprimé. Leurs campagnes sont réattribuées à un utilisateur sentinelle nommé « Ambassadeur Anonyme » afin que les dons historiques ne perdent pas leur enregistrement parent.

Les deux chemins passent par Charitable_Ambassadors_Directory_Delete. Le nom et l'e-mail de l'utilisateur sentinelle peuvent être personnalisés via les filtres charitable_ambassadors_directory_sentinel_email et charitable_ambassadors_directory_sentinel_display_name.

Conseils à garder à l'esprit

Quelques habitudes qui rendent la gestion de l'annuaire beaucoup plus fluide une fois votre programme lancé.

• Effectuez un passage de nettoyage mensuel. Filtrez sur Inactifs avec zéro campagne, puis supprimez et anonymisez en masse. Cela permet de garder la liste précise et vos données organisées.
• Considérez le badge Vérifié comme quelque chose qui a de la valeur. Ne vérifiez pas automatiquement chaque inscription. Réservez le badge aux ambassadeurs que vous avez réellement examinés : un humain réel, une cause réelle, une réelle intention de collecter des fonds. Il a plus de poids lorsqu'il est utilisé avec soin.
• Utilisez Voir comme avant de répondre aux demandes de support. Lorsqu'un ambassadeur signale un écran déroutant, cliquez sur Voir comme pour voir exactement ce qu'il voit. C'est mieux que cinq minutes d'échanges de « qu'est-ce que votre écran montre ? » à chaque fois.
• Si les statistiques semblent obsolètes, recalculez-les. L'action Recalculer les statistiques dans le menu de la ligne réexécute les agrégats à vie pour un seul utilisateur. Il existe également un bouton de recalculation pour l'ensemble du site sur la page des outils. Les deux sont utiles après une importation groupée de dons.

Référence développeur

Le reste de cette page est destiné aux développeurs qui personnalisent l'annuaire.

Stockage

Les lignes d'ambassadeurs sont des utilisateurs WordPress standard. L'annuaire n'ajoute pas de tables personnalisées. Le critère « est un ambassadeur » est « a au moins une collecte de fonds publiée, OU a le drapeau d'utilisateur _charitable_ambassadors_directory_added_manually défini par le formulaire Ajouter ».

Les statistiques par utilisateur (montant collecté à vie, nombre de donateurs, dernière activité) sont calculées à la volée à partir des tables de dons et de campagnes, les résultats étant mis en cache brièvement par requête.

Drapeau vérifié

user_meta key: _charitable_ambassadors_verified
value:        '1' = verified, '' (empty) = not verified

Constante : Charitable_Ambassadors_Directory_Data::VERIFIED_META.

Filtres

Filtre	Défaut	Objectif
annuaire_ambassadeurs_caritatifs_colonnes	tableau de 8 colonnes	Ajouter ou supprimer des colonnes du tableau de liste.
annuaire_ambassadeurs_caritatifs_actions_massives	tableau de 5 actions	Ajouter ou supprimer des actions groupées du menu déroulant.
annuaire_ambassadeurs_caritatifs_actions_ligne	tableau de métadonnées de ligne	Modifier les liens d'action de ligne en ligne. Reçoit $row_meta, $user_id.
annuaire_ambassadeurs_caritatifs_boutons_action	tableau de boutons d'action	Modifier les boutons de la colonne Actions. Reçoit $buttons, $user_id.
annuaire_ambassadeurs_caritatifs_arguments_requete_utilisateur	calculé	Modifier les arguments de WP_User_Query avant l'exécution de la liste. Utile pour exclure des rôles spécifiques.
annuaire_ambassadeurs_caritatifs_onglets_profil	tableau de 4 onglets	Ajouter ou supprimer des onglets de profil. Les parties Journal et Notes existent mais ne sont pas activées par défaut.
annuaire_ambassadeurs_caritatifs_champs_supplementaires_donnees_formulaire	[]	Ajouter des champs supplémentaires à l'onglet de profil Données du formulaire. Reçoit [], $user_id.
annuaire_ambassadeurs_caritatifs_droit_ligne_massive	50	Nombre maximum de lignes par appel d'action groupée.
annuaire_ambassadeurs_caritatifs_seuil_jours_inactif	90	Jours d'inactivité avant qu'un utilisateur n'apparaisse dans la vue Inactifs.
annuaire_ambassadeurs_caritatifs_titre_accueil	24 * HEURE_EN_SECONDES	Durée de vie du lien magique pour la connexion automatique de l'e-mail de bienvenue.
annuaire_ambassadeurs_caritatifs_email_sentinelle	anonyme@…	E-mail sentinelle utilisé lorsqu'une suppression définitive réattribue les collectes de fonds d'un utilisateur supprimé.
annuaire_ambassadeurs_caritatifs_nom_affichage_sentinelle	Ambassadeur Anonyme	Nom d'affichage sentinelle.
annuaire_ambassadeurs_caritatifs_nom_affichage_anonymiser	Ambassadeur Anonyme	Nom d'affichage qu'un utilisateur anonymisé reçoit.
annuaire_ambassadeurs_caritatifs_motif_email_anonymiser	anonymous-%[email protected]	Modèle d'e-mail (sprintf avec ID utilisateur) pour les utilisateurs anonymisés.
annuaire_ambassadeurs_caritatifs_cles_meta_anonymiser	tableau de clés PII	Clés meta utilisateur effacées lors de l'anonymisation.
charitable_ambassadors_directory_csv_max_rows	10000	Plafond du nombre de lignes d'exportation CSV.
charitable_ambassadors_directory_csv_cell	''	Fournir une valeur personnalisée pour une clé de colonne inconnue lors de l'exportation CSV. Reçoit ('', $col, $user).
annuaire_ambassadeurs_caritatifs_tags_intelligents_envoyer_email	tableau de balises	Ajouter des substitutions de balises intelligentes à la fenêtre modale Envoyer un e-mail.
annuaire_ambassadeurs_caritatifs_max_par_heure_envoyer_email	100	Limitation des envois d'e-mails par modérateur et par heure.
annuaire_ambassadeurs_caritatifs_ajouter_champs	calculé	Modifier les champs affichés sur le formulaire Ajouter un ambassadeur.

Actions

Action	Args	Se déclenche lorsque
annuaire_ambassadeurs_caritatifs_verification_modifiee	$user_id, $is_verified, $moderator_id	Un appel de vérification ou d'annulation de vérification s'exécute.
annuaire_ambassadeurs_caritatifs_email_envoye	$user_id, $subject, $body, $moderator_id	Une soumission de modal Envoyer un e-mail se produit.
annuaire_ambassadeurs_caritatifs_ambassadeur_ajoute	$user_id, $post_data	Une soumission du formulaire Ajouter un ambassadeur se produit.
annuaire_ambassadeurs_caritatifs_avant_anonymisation	$user_id	Juste avant que l'anonymisation ne s'exécute.
annuaire_ambassadeurs_caritatifs_apres_anonymisation	$user_id	Juste après que l'anonymisation soit terminée.
annuaire_ambassadeurs_caritatifs_avant_suppression_definitive	$user_id	Juste avant que la suppression définitive ne s'exécute.
annuaire_ambassadeurs_caritatifs_apres_suppression_definitive	$user_id, $sentinel_id	Après la suppression définitive et la réaffectation des publications.

Points de terminaison AJAX

Tous sur wp_ajax_ uniquement, action nonce charitable_ambassadors_directory, capacité manage_charitable_settings :

Action	Objectif
annuaire_ambassadeurs_caritatifs_bascule_verification	Basculer le drapeau vérifié d'un utilisateur.
annuaire_ambassadeurs_caritatifs_envoyer_bienvenue	Renvoyer l'e-mail de bienvenue avec un nouveau lien magique.
annuaire_ambassadeurs_caritatifs_envoyer_email	Envoyer un e-mail unique avec substitution de balise intelligente.
annuaire_ambassadeurs_caritatifs_recalculer_statistiques	Relancer les agrégats à vie pour un seul utilisateur.

Gestionnaires de soumission de formulaire

URL	Objectif
admin-post.php?action=charitable_ambassadors_directory_bulk	Gestionnaire d'actions groupées.
admin-post.php?action=charitable_ambassadors_directory_add_submit	Soumission du formulaire Ajouter un ambassadeur.
admin-post.php?action=charitable_ambassadors_directory_manual_recalc	Bouton de ré-calcul des statistiques sur l'ensemble du site.

Connexion automatique par lien magique

L'e-mail de bienvenue contient un lien magique unique consommé à la priorité init 5 via Charitable_Ambassadors_Directory::maybe_consume_magic_link(). La durée de vie par défaut est de 24 heures, filtrable via charitable_ambassadors_directory_welcome_ttl.

Voir en tant que

L'action Afficher en tant que déconnecte le modérateur et se connecte en tant qu'utilisateur cible, avec un cookie de retour qui leur permet de revenir à leur session d'origine en un clic. Propulsé par le plugin User Switching lorsqu'il est installé. Le répertoire relie le bouton Afficher en tant que son aide switch_to_user_url().

Capacités

manage_charitable_settings est requis pour toutes les opérations d'administration et est accordé aux administrateurs par défaut.

Exemples de personnalisation

Ajouter une colonne « Téléphone » à la liste des ambassadeurs :

add_filter( 'charitable_ambassadors_directory_list_columns', function ( $cols ) {
    $cols['phone'] = __( 'Phone', 'your-textdomain' );
    return $cols;
} );

Abaisser le seuil d'inactivité à 30 jours :

add_filter( 'charitable_ambassadors_directory_inactive_threshold_days', function () {
    return 30;
} );

Réactiver les onglets de profil Journaux et Notes :

add_filter( 'charitable_ambassadors_directory_profile_tabs', function ( $tabs, $user_id ) {
    $tabs['logs']  = [ 'label' => 'Logs',  'count' => null ];
    $tabs['notes'] = [ 'label' => 'Notes', 'count' => null ];
    return $tabs;
}, 10, 2 );

Envoyer un webhook à votre CRM chaque fois qu'un ambassadeur est vérifié :

add_action( 'charitable_ambassadors_directory_verification_changed', function ( $user_id, $is_verified, $moderator_id ) {
    if ( ! $is_verified ) {
        return;
    }
    wp_remote_post( 'https://crm.example.com/hook', [
        'body' => [
            'user_id'      => $user_id,
            'verified_at'  => time(),
            'verified_by'  => $moderator_id,
        ],
    ] );
}, 10, 3 );

Prolonger la durée de vie du lien magique de l'e-mail de bienvenue à 7 jours :

add_filter( 'charitable_ambassadors_directory_welcome_ttl', function () {
    return 7 * DAY_IN_SECONDS;
} );

En résumé

Cela couvre tout ce que le répertoire peut faire pour vous. Que vous intégriez un nouveau groupe d'ambassadeurs, recherchiez quelqu'un qui a besoin d'un coup de pouce, prépariez une exportation CRM ou effectuiez un nettoyage trimestriel, le répertoire est votre écran de référence pour gérer les personnes de votre programme.

Si vous avez des questions ou rencontrez quelque chose qui n'est pas couvert ici, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ce sont les documents sur les ambassadeurs les plus étroitement liés au répertoire. Marquez ceux qui sont pertinents pour la façon dont vous gérez votre programme.

• Onglets de profil du répertoire – une plongée en profondeur dans les quatre onglets de la page de profil de chaque ambassadeur.
• Exportations CSV – le dictionnaire complet des colonnes pour chaque point d'exportation, y compris l'exportation de la liste du répertoire.
• Invitations – comprenez quels ambassadeurs sont arrivés via quel lien d'invitation.
• Tableau de bord de présentation – le widget Top Ambassadeurs puise dans les mêmes données sous-jacentes.
• Hooks & filtres dans Ambassadeurs – la référence complète pour les développeurs.