Prérequis :
- Charitable Pro 1.8.15+
- Mises à jour de campagne Charitable 1.0.8+
Mises à jour de campagne vous permet de publier des posts de progression pour n'importe quelle campagne, de les afficher sur la page de campagne (ou n'importe quelle page), et d'envoyer par e-mail les donateurs qui ont choisi de recevoir ces mises à jour. Trois types de mises à jour (général, jalon, urgent), une épingle « à la une » par campagne, et un lien de désinscription par campagne dans chaque e-mail pour que l'hygiène de la liste se gère d'elle-même.
Quand l'utiliser
- Vous voulez que les donateurs voient la campagne avancer après avoir donné, pas seulement lors des remerciements de fin de campagne.
- Vous menez une campagne de plusieurs semaines ou plusieurs mois et avez besoin d'un moyen de mettre en avant les jalons et les demandes urgentes (don correspondant sur le point d'expirer, objectif d'étirement d'urgence).
- Vous voulez une audience inscrite par campagne au lieu d'une liste globale qui inclut tout le monde.
Où le trouver
Toute la fonctionnalité se trouve dans le Générateur de campagne. Ouvrez n'importe quelle campagne et regardez dans la barre latérale gauche :
Admin WordPress > Campagnes > [votre campagne] > Générateur de campagne > Mises à jour de campagne
Le panneau a trois sous-onglets en bas :
- Flux de mises à jour — par défaut. Aperçu de la dernière mise à jour plus le flux complet des cartes de mise à jour (ajouter, modifier, supprimer, envoyer).
- Abonnés — les donateurs qui ont choisi de recevoir les mises à jour par e-mail pour cette campagne, plus l'historique des envois d'e-mails.
- Paramètres — l'activation/désactivation par campagne, la limite de contenu et le comportement des e-mails.
La vue d'ensemble
Trois éléments interagissent ensemble :
| Partie | Où elle se trouve | Ce qu'il fait |
|---|---|---|
| Le flux de mises à jour | Générateur de campagne > Mises à jour de campagne > Flux de mises à jour | La liste des mises à jour pour une campagne. Ajouter, modifier, supprimer, envoyer. |
| L'opt-in du donateur | Formulaire de don, lorsque le consentement du contact est activé | Une case à cocher « Je souhaite recevoir des mises à jour » à côté de la case à cocher de consentement au moment du don. |
| L'affichage | Page de campagne (via le champ Générateur de campagne ou le bloc Gutenberg) | La liste publique que les donateurs et les visiteurs voient sur la page de campagne. |
Une campagne a besoin des trois éléments activés pour offrir l'expérience complète : vous publiez une mise à jour, les donateurs qui ont choisi de la recevoir reçoivent un e-mail, et les visiteurs qui arrivent sur la page de campagne voient la mise à jour affichée là.
Configuration étape par étape
La première fois que vous configurez ceci pour une campagne :
- Activez-la pour la campagne. Ouvrez Générateur de campagne > Mises à jour de campagne > Paramètres. Basculez Activer les mises à jour de campagne sur On. C'est le commutateur principal pour tout le reste sur cette campagne.
- Vérifiez que le chemin d'opt-in existe. Allez dans Charitable > Paramètres > Confidentialité et confirmez que le Consentement du contact est activé. La case à cocher d'opt-in des Mises à jour de campagne s'appuie sur celle-ci ; sans elle, la case à cocher ne peut pas s'afficher sur le formulaire de don. (L'onglet Paramètres vous avertira si l'une de ces prérequis est manquante.)
- Ajoutez le champ Mises à jour de campagne à la mise en page de la campagne. Ouvrez Générateur de campagne > Conception > Ajouter des champs et déposez Mises à jour de campagne où vous voulez que les mises à jour s'affichent sur la page de campagne. Pour les campagnes basées sur Gutenberg ou les pages non-campagnes, utilisez plutôt le bloc Mises à jour de campagne.
- Confirmez que l’e-mail est activé. Allez dans Charitable > Paramètres > E-mails et assurez-vous que Mise à jour de campagne est activé. L’onglet Paramètres le signalera également si cela est manquant.
- Publiez votre première mise à jour. De retour dans Constructeur de campagne > Mises à jour de campagne > Flux de mises à jour, cliquez sur Ajouter la première mise à jour. Voir Création de mises à jour pour la présentation complète de la fenêtre modale.
Après l’étape 5, votre formulaire de don affichera la case à cocher d’adhésion, votre page de campagne affichera la mise à jour et (selon votre mode d’envoi) l’e-mail peut être envoyé automatiquement ou attendre que vous l’envoyiez.
Onglet Paramètres
Chaque campagne a ses propres paramètres sous Constructeur de campagne > Mises à jour de campagne > Paramètres :
Paramètres d’affichage
| Paramètre | Ce qu'il fait |
|---|---|
| Activer les mises à jour de campagne | Interrupteur principal pour cette campagne. Désactivé signifie : pas de case à cocher d’adhésion, pas d’envoi d’e-mails, pas de mises à jour affichées sur le front-end. |
| Limite de contenu | Nombre maximum de mises à jour que le champ/bloc doit afficher par défaut. Chaque instance du champ Mises à jour de campagne peut remplacer cela. Définir sur 0 pour aucune limite. |
Notifications par e-mail
| Paramètre | Ce qu'il fait |
|---|---|
| Activer les e-mails de mise à jour | Permet l’envoi d’e-mails de mise à jour pour cette campagne. Nécessite également que l’e-mail Mise à jour de campagne soit activé dans les paramètres globaux des e-mails de Charitable. |
| Envoi automatique d’e-mails | Trois modes – Manuel uniquement (vous cliquez sur « envoyer » par mise à jour), Auto pour les mises à jour mises en avant (la publication d’une mise à jour mise en avant envoie automatiquement), Auto pour toutes les mises à jour (chaque mise à jour publiée envoie automatiquement). |
| Longueur du contenu de l’e-mail | Nombre de caractères du corps de la mise à jour à inclure dans l’e-mail. 0 signifie contenu complet. Utile pour garder les e-mails consultables. |
L’onglet Paramètres affiche des bannières d’avertissement jaunes s’il détecte l’un des éléments suivants :
- L’e-mail Mise à jour de campagne est désactivé dans les paramètres d’e-mail de Charitable.
- Le consentement de contact est désactivé dans les paramètres de confidentialité.
- Le formulaire de campagne n’a pas de champ de confidentialité/consentement (donc les nouveaux donateurs ne peuvent pas adhérer).
Corrigez ce que les avertissements signalent avant de commencer à publier des mises à jour, sinon les nouveaux donateurs ne pourront pas s’inscrire.
Conseils
- Une mise à jour mise en avant à la fois. Marquer une deuxième mise à jour comme mise en avant désactive automatiquement la précédente. Utilisez-la pour « c’est la seule chose que vous devez savoir maintenant ».
- Les brouillons n’envoient pas d’e-mails. Enregistrer en tant que brouillon est sûr – les brouillons sont invisibles pour les donateurs et ne déclenchent jamais d’envois, même en mode d’envoi automatique. Utilisez les brouillons pour composer des mises à jour avant qu’elles ne soient publiées.
- Testez avant d’envoyer. La fenêtre modale d’envoi contient un lien « Envoyer un e-mail de test » qui envoie à l’utilisateur actuellement connecté. Envoyez-vous toujours un test avant de toucher la vraie liste.
- Le désabonnement des donateurs est par campagne. Un donateur qui se désabonne de votre campagne de gala ne se désabonne pas de votre campagne de sauvetage d’animaux. Le lien de désabonnement est limité à la campagne.
- La réinscription est automatique lors de nouveaux dons. Si un donateur se désabonne puis fait plus tard un nouveau don à la même campagne avec l’option d’adhésion cochée, il est de retour sur la liste. Aucun nettoyage manuel nécessaire.
Référence du développeur
Filtres
Ce sont les filtres à fort trafic les plus susceptibles d'apparaître dans le travail de personnalisation. Voir Hooks et filtres pour l'inventaire complet.
| Filtre | Défaut | Objectif |
|---|---|---|
charitable_campaign_updates_default_checked |
faux |
Si la case à cocher d'opt-in du formulaire de don est pré-cochée. |
charitable_campaign_updates_consent_label |
"Je souhaite recevoir des mises à jour sur la progression de cette campagne." |
L'étiquette de la case à cocher d'opt-in. |
charitable_campaign_updates_require_contact_consent |
vrai |
Si la case à cocher d'opt-in est désactivée jusqu'à ce que le consentement de contact soit coché. |
charitable_campaign_update_types |
(tableau) | La liste des types de mises à jour – général, étape importante, urgent – ainsi que leurs étiquettes, icônes et couleurs. |
charitable_campaign_updates_content_limit |
(int) | Limite de contenu par défaut par campagne. |
charitable_can_user_manage_campaign_updates |
vrai |
Si l'utilisateur actuel peut ajouter/modifier/supprimer des mises à jour pour une campagne. |
Actions
| Action | Quand cela s'exécute |
|---|---|
charitable_campaign_update_meta_saved |
Après que les métadonnées d'une mise à jour ont été enregistrées depuis l'admin (post_id, post). |
charitable_campaign_updates_builder_loaded |
Lorsque le panneau Mises à jour de campagne du Constructeur de campagne a fini de se charger. |
charitable_campaign_updates_activated |
Lors de l'activation du plugin. |
charitable_campaign_updates_installed |
Après l'installation du plugin (version string passée). |
Fonctions d'aide et type de publication
| Symbole | Objectif |
|---|---|
charitable_get_campaign_update_types() |
Retourne le tableau des types de mises à jour enregistrés. Appliquez le filtre charitable_campaign_update_types pour ajouter/modifier des types. |
Type de publication : campaign_update |
Chaque mise à jour est une publication campaign_update avec les métadonnées _campaign_id, _update_type, _featured et (pour les urgentes) _urgency_level. |
Porte de capacité
L'accès à la modification est accordé par défaut à toute personne pouvant modifier la campagne. Remplacez le filtre charitable_can_user_manage_campaign_updates pour restreindre (par exemple, à l'auteur de la campagne uniquement) :
add_filter( 'charitable_can_user_manage_campaign_updates', function( $can, $campaign_id ) {
if ( ! $can ) {
return $can;
}
$campaign = get_post( $campaign_id );
return $campaign && (int) $campaign->post_author === get_current_user_id();
}, 10, 2 );
Exemples de personnalisation
Cochez la case d'opt-in pour les donateurs novices :
add_filter( 'charitable_campaign_updates_default_checked', '__return_true' );
Modifiez l'étiquette de consentement pour qu'elle soit spécifique à la campagne :
add_filter( 'charitable_campaign_updates_consent_label', function( $label ) {
return 'Email me updates about this campaign. We send roughly one per month.';
} );
Ajoutez un quatrième type de mise à jour (« inspiration ») pour partager les histoires des donateurs :
add_filter( 'charitable_campaign_update_types', function( $types ) {
$types['inspiration'] = array(
'label' => __( 'Inspiration', 'your-textdomain' ),
'description' => __( 'Stories and quotes from donors and beneficiaries.', 'your-textdomain' ),
'icon' => 'fa-heart',
'color' => '#9333ea',
);
return $types;
} );
Remplacez globalement la limite de contenu par campagne par défaut par 10 :
add_filter( 'charitable_campaign_updates_content_limit', function( $limit, $campaign_id ) {
return 10;
}, 10, 2 );
Connexes
- Création de mises à jour – La fenêtre modale d'ajout/modification, les types de mises à jour, l'épinglage mis en avant, brouillon vs publication.
- Notifications par e-mail – Opt-in du donateur, envoi manuel et automatique, désinscription et réinscription.
- Champ de création de campagne – Le champ glisser-déposer pour afficher les mises à jour dans la mise en page du créateur de campagne.
- Bloc de mises à jour de campagne – Le bloc Gutenberg, le shortcode et la fonction PHP pour afficher les mises à jour n'importe où sur le site.
- Hooks et filtres – Référence complète pour les développeurs.
