Documentation Charitable

Apprenez à tirer le meilleur parti de Charitable grâce à des instructions claires, étape par étape.

Ressources populaires

Commencez ici

Gestion des donateurs

Dons récurrents

Collecte de fonds pair-à-pair

Intégrations

Extensions

Image vedette pour les campagnes visuelles

Le réglage Image vedette pour les campagnes visuelles vous permet d'attribuer une miniature dédiée à chaque campagne depuis le constructeur de campagnes. Cette image est utilisée comme miniature de campagne dans les listes de campagnes, les shortcodes et le partage sur les réseaux sociaux, et remplace la première photo de votre mise en page de campagne lorsqu'elle est définie. Elle est disponible à partir du plugin Charitable Pro 1.8.13+.

Table des matières

Démarrage

L'image vedette est un réglage au niveau de la campagne dans le constructeur de campagnes Charitable Pro. Lorsque vous définissez une image vedette pour une campagne, elle devient l'image principale affichée chaque fois que cette campagne apparaît dans les grilles, les listes, les shortcodes (par ex. [campaigns]) et lorsqu'elle est partagée sur les plateformes sociales. Si vous ne définissez pas d'image vedette, Charitable utilise la première photo de votre mise en page de campagne (le cas échéant) ou la miniature de l'article WordPress pour les campagnes héritées.

Avantages clés

  • Un seul endroit pour définir la miniature de la campagne — Pas besoin de dépendre de l'ordre de la mise en page ; définissez une image qui représente la campagne partout.
  • Meilleur contrôle pour le partage sur les réseaux sociaux — Utilisez une image optimisée pour les réseaux sociaux (par ex. 1200 × 630 px) pour que les partages soient cohérents.
  • Accessibilité et SEO — Champ de texte alternatif dédié pour les lecteurs d'écran et les moteurs de recherche.
  • Image de marque cohérente — Même image sur les boucles de campagne, les shortcodes et les intégrations (par ex. Divi, Elementor).

Exigences

  • WordPress : 6.2 ou supérieur
  • PHP : 7.4 ou supérieur
  • Charitable Pro : 1.8.13 ou supérieur

Le réglage d'image vedette n'est disponible que pour les campagnes modifiées dans le constructeur de campagnes (campagnes non héritées).

Où le trouver

  1. Dans l'administration WordPress, allez à Charitable → Campagnes (ou Constructeur de campagnes).
  2. Ouvrez ou créez une campagne dans le constructeur de campagnes.
  3. Dans la barre latérale gauche, cliquez sur Réglages.
  4. Dans le sous-menu Réglages, cliquez sur Image vedette (sous Options de don).

Le panneau Image vedette apparaît dans la zone de contenu principale.

Options de configuration

Téléchargement d'image

  • Cliquez pour télécharger ou sélectionner une image — Utilisez la zone de dépôt pour ouvrir la médiathèque ou télécharger une nouvelle image. Vous pouvez également utiliser Remplacer sur un aperçu existant pour choisir une image différente, ou Supprimer / Supprimer l'image pour l'effacer.
  • URL de l'image — L'URL de l'image sélectionnée est stockée ; le champ de téléchargement peut être masqué par conception mais est utilisé pour la sauvegarde.
  • Télécharger l'image — Bouton alternatif pour ouvrir le sélecteur de médias.

Dimensions recommandées

  • 1200 × 630 px — Recommandé pour un affichage optimal dans les grilles de campagnes et le partage sur les réseaux sociaux (par ex. Open Graph). D'autres tailles fonctionnent mais peuvent être recadrées ou mises à l'échelle en fonction de votre thème et des plateformes sociales.

Texte Alternatif

  • Objectif : Texte alternatif pour les lecteurs d'écran et le SEO.
  • Placeholder : « Décrivez cette image pour l'accessibilité. »
  • Comportement : Si vous laissez le texte alternatif vide et que l'image provient de la médiathèque, Charitable peut la remplir automatiquement à partir du texte alternatif de la pièce jointe, le cas échéant.

Où l'image vedette est utilisée

Lorsqu'elle est définie, l'image mise en avant est utilisée comme miniature de la campagne dans :

  • Listes et grilles de campagnes — par ex. l'archive des campagnes et les shortcodes comme [campaigns].
  • Modèle de boucle de campagne — Le modèle campaign-loop/thumbnail.php affiche la miniature de l'article WordPress lorsqu'elle est définie. Lorsque l'image mise en avant du constructeur de campagne est synchronisée avec la miniature de l'article lors de la sauvegarde, elle apparaît ici.
  • Shortcodes — Tous les shortcodes qui affichent les miniatures de campagne (par ex. grille de campagnes, bloc de campagne).
  • Partage sur les réseaux sociaux — Lorsque votre thème ou vos plugins utilisent l'image mise en avant/miniature de la campagne pour Open Graph ou des balises meta similaires.
  • Constructeurs de pages — Divi et autres intégrations qui affichent les images de campagne utilisent la même source de miniature (par ex. .campaign-thumbnail, .campaign-featured-image img).

Si aucune image mise en avant n'est définie, Charitable utilise la première photo de la mise en page de la campagne, ou l'ancienne image mise en avant WordPress pour les campagnes plus anciennes.

Dépannage

L'image mise en avant ne s'affiche pas sur le frontend

  • Enregistrer la campagne — Cliquez sur Enregistrer dans le constructeur de campagne après avoir défini ou modifié l'image mise en avant.
  • Vérifier le type de campagne — Le paramètre s'applique aux campagnes modifiées dans le constructeur de campagne. Les anciennes campagnes utilisent l'image mise en avant standard de WordPress dans l'éditeur.
  • Cache — Videz le cache du site ou de la page afin que la miniature mise à jour soit visible.
  • Substitutions de thème — Si votre thème substitue charitable/campaign-loop/thumbnail.php, assurez-vous qu'il utilise la miniature de la campagne (par ex. get_post_thumbnail_id() ou équivalent).

L'image semble rognée ou de mauvaise qualité

  • Utilisez une image d'au moins 1200 × 630px pour les grilles et le partage sur les réseaux sociaux.
  • Téléchargez une résolution suffisamment élevée pour les tailles utilisées par votre thème et vos shortcodes (par ex. « medium », « large »).

Le texte alternatif ne s'enregistre pas

  • Assurez-vous de cliquer sur Enregistrer après avoir modifié la campagne. Le texte alternatif est stocké avec les paramètres de la campagne et (le cas échéant) peut être synchronisé à partir de la pièce jointe du média si laissé vide.

Ressources pour les développeurs

Données stockées

  • Les données de l'image mise en avant sont stockées dans les métadonnées de campagne campaign_settings_v2 sous settings['featured-image'] :
    • featured_image_id — ID de la pièce jointe WordPress.
    • featured_image_url — URL de l'image.
    • featured_image_alt — Texte alternatif.
  • Pour afficher dans la boucle de campagnes, l'ID de la pièce jointe de l'image mise en avant peut être synchronisé avec le champ _thumbnail_id du billet lors de la sauvegarde de la campagne (par exemple, via le filtre charitable_campaign_builder_save_campaign_settings ou l'action charitable_builder_save_campaign). Ensuite get_post_thumbnail_id( $campaign_id ) et has_post_thumbnail( $campaign_id ) refléteront l'image mise en avant de la campagne.

Substitution de modèle

  • Pour personnaliser la sortie de la miniature de campagne, remplacez le modèle dans votre thème :
    • Copiez wp-content/plugins/charitable-pro/templates/campaign-loop/thumbnail.php
    • vers votre thème : your-theme/charitable/campaign-loop/thumbnail.php.

Hooks et filtres

  • Enregistrement du panneau de paramètres — Le panneau Image mise en avant est ajouté à la barre latérale des paramètres du constructeur de campagne via :
    • Filtre : charitable_builder_panels_settings_ (slug du panneau : featured-image).
  • Chemin du fichier du panneau — Filtre : charitable_builder_panels_settings_file (utilisé pour charger la classe du panneau Pro).
  • Affichage de la miniature — Filtre : charitable_campaign_loop_thumbnail_size pour changer la taille de l'image utilisée dans la boucle de campagne.
  • Forcer la miniature mise en avant — Filtre : charitable_campaign_loop_featured_thumbnail pour forcer l'utilisation de l'image mise en avant/miniature dans des contextes spécifiques.

Classes CSS (administration du constructeur de campagne)

  • Section du panneau : .charitable-panel-content-section-featured-image
  • Carte d'aperçu : .charitable-featured-image-card
  • Zone de dépôt : .charitable-featured-image-dropzone
  • Actions de superposition : .charitable-featured-image-overlay, .charitable-featured-image-overlay-replace, .charitable-featured-image-overlay-remove

Pour une assistance supplémentaire avec le paramètre Image mise en avant, veuillez consulter notre documentation d'assistance ou contacter notre équipe.

Vous avez encore des questions ? Nous sommes là pour vous aider !

Soumettre un ticket de support
Contactez-nous

Dernière modification :

Quoi de neuf dans Charitable

Voir les dernières mises à jour
🔔 Abonnez-vous pour recevoir nos dernières mises à jour
📧 Abonnez-vous aux e-mails

Abonnement par e-mail

Rejoignez notre newsletter

Nous ne vous enverrons pas de spam. Nous envoyons un e-mail uniquement lorsque nous pensons qu'il vous sera réellement utile. Désabonnez-vous à tout moment !

Amélioration Paiements

💸 Introduction des tarifs échelonnés pour l'allègement des frais : Adaptez la demande au don !

L'allègement des frais pose une courte question à vos donateurs lors du paiement : souhaitez-vous couvrir les frais de traitement de ce don ? Jusqu'à présent, cette question utilisait un taux unique pour chaque don sur une passerelle, de sorte qu'un don de 10 $ et un don de 500 $ se voyaient demander le même pourcentage. L'allègement des frais 1.3.0 vous permet de définir autant de tranches de dons que vous le souhaitez, chacune portant son propre taux. Pourquoi c'est important :

  • 🪙 Plus doux pour les petits dons : Un coût de transaction fixe représente une part beaucoup plus importante d'un don de 10 $ que d'un don de 500 $, les tranches vous permettent donc de demander moins en bas.
  • 🎚️ Autant de tranches que nécessaire : Chaque tranche porte son propre pourcentage et son propre montant fixe, et la tranche supérieure s'exécute sans limite supérieure.
  • 🛑 Un plafond facultatif : Un champ de frais maximum empêche qu'un donateur ne se voie demander plus qu'un nombre que vous choisissez, quel que soit le montant du don.
  • 🔌 Défini par passerelle de paiement : Stripe peut fonctionner avec quatre tranches tandis que Windcave et Payfast restent sur un taux unique, car les tranches appartiennent à une passerelle et non à l'ensemble de votre site.
  • 🛡️ Rien ne change tant que vous ne le décidez pas : Vos taux actuels restent exactement les mêmes jusqu'à ce que vous activiez « Utiliser les tarifs échelonnés » sous Charitable » Paramètres » Avancé » Allègement des frais.

Consultez notre annonce ici.

Dons Amélioration

📊 Votre tableau de bord Pro peut désormais comparer, exporter et évaluer !

La plupart des tableaux de bord de collecte de fonds vous indiquent seulement combien vous avez collecté. Charitable Pro 1.8.19 reconstruit le tableau de bord et la Vue d'ensemble des rapports autour des questions les plus difficiles : si quelque chose ne fonctionne pas, si cette période a été meilleure que la précédente, et quel changement unique ferait la plus grande différence aujourd'hui. Pourquoi c'est important :

  • 📈 Chaque chiffre a une tendance : Choisissez une période et les vignettes ainsi que le graphique bougent ensemble, chaque total étant affiché par rapport à la période précédente.
  • 🗓️ Des graphiques lisibles : Les courtes périodes regroupent les dons jour par jour, tandis que les longues périodes regroupent par semaine ou par mois, de sorte qu'une année complète se lit comme une courbe au lieu d'une ligne plate.
  • 🔀 Comparez n'importe quelles 2 périodes : Pas seulement consécutives, vous pouvez donc demander comment ce mois de décembre s'est comparé au mois de décembre dernier. C'est important car la collecte de fonds est saisonnière.
  • 📤 Exportez le résumé complet : Envoyez la vue d'ensemble complète en CSV ou PDF, prête pour un dossier de conseil d'administration ou un rapport de bailleur de fonds.
  • 🎯 Évaluez votre configuration gratuitement : Faites évaluer votre configuration de collecte de fonds, de sorte que le seul changement à faire ensuite soit celui que vous pouvez voir.

Consultez notre annonce ici.

Fonctionnalité Nouveau

🎟️ Présentation des Événements Caritatifs : Vendez des Billets dans Vos Campagnes !

La plupart des organisations à but non lucratif vendent des billets d'événement dans un outil et collectent des dons dans un autre, ce qui laisse deux ensembles de rapports et une correspondance manuelle à la fin de l'année. Événements Caritatifs réunit les deux, en vendant des billets via les mêmes formulaires de don et passerelles de paiement que vous utilisez déjà dans Charitable. Pourquoi c'est important :

  • 🎟️ Chaque billet est un don : Les ventes de billets passent par la passerelle que vous utilisez déjà et comptent pour l'objectif de la campagne, le tout géré sous Charitable » Événements.
  • 📱 Enregistrement par QR code depuis n'importe quel téléphone : Chaque participant reçoit son propre code QR sur le reçu, et les bénévoles scannent à l'entrée via un lien d'enregistrement qui ne nécessite aucun compte WordPress.
  • 🧾 Reçus prêts pour la déclaration de revenus : Attribuez à chaque type de billet une juste valeur marchande, et Charitable indiquera le montant déductible d'impôt correct sur chaque reçu de donateur.
  • 📋 Détails des participants au moment du paiement : Demandez à chaque invité son choix de repas, sa taille de chemise ou ses besoins d'accès, avec un enregistrement distinct du participant créé pour chaque billet.
  • 🗓️ Blocs et calendriers inclus : Trois blocs d'éditeur ainsi que la prise en charge de Sugar Calendar et The Events Calendar placent vos événements là où les supporters les recherchent déjà.

Consultez notre annonce ici.

ia Nouveau

🚀 Libérez la puissance de l'IA dans Charitable !

Votre assistant IA peut désormais créer, modifier et gérer vos campagnes de collecte de fonds Charitable directement — il suffit de demander. Avec Charitable Pro ajoutant la prise en charge de l'écriture pour l'API WordPress Abilities, des outils comme ChatGPT, Claude et Cursor peuvent gérer des actions administratives complètes en toute sécurité via MCP. Pourquoi c'est important :

  • 🤖 Création de campagnes en langage clair : Demandez à votre assistant un objectif comme « Mettre en place une collecte de fonds pour le refuge avec un objectif de 5 000 $ », et il crée une ébauche de campagne complète avec des paliers de dons suggérés.
  • 🎨 Modifications instantanées du formulaire de don : Ajoutez des champs personnalisés, changez les couleurs des boutons ou réorganisez les éléments sans avoir à modifier les paramètres du formulaire.
  • 📝 Enregistrement des dons hors ligne : Informez votre assistant des dons en espèces ou par chèque, et il associera les e-mails des donateurs et enregistrera les transactions dans votre historique.
  • 🛡️ Sécurité et contrôle par défaut : L'accès en écriture reste désactivé jusqu'à ce qu'il soit activé dans Charitable » Outils » AI MCP, maintenant la sécurité des rapports en lecture seule par défaut.
  • 📜 Journalisation complète des audits : Chaque modification apportée par un assistant IA est suivie dans Charitable » Outils » Journaux, vous savez donc toujours qui (ou quoi) a mis à jour votre site.

Consultez notre annonce ici.

Amélioration Paiements

💰 Acceptez les dons récurrents avec Windcave et Charitable

Un donateur configure son don une seule fois sur la page de paiement sécurisée de Windcave, et Charitable facture chaque renouvellement par la suite selon le calendrier établi. Pourquoi c'est important :

🏦 Organisations basées en Nouvelle-Zélande ou en Australie : dons mensuels sur la passerelle avec laquelle votre banque vous a déjà configuré, sans second processeur à intégrer.
⛪ Églises acceptant les dîmes et offrandes régulières : les membres de la congrégation définissent leur propre calendrier une fois, ce qui est le moyen le plus simple de lancer des dons d'église récurrents sans plateforme distincte.
🌏 Groupes avec des donateurs dans plusieurs devises : Windcave en gère plus de 20, ainsi un sympathisant peut donner dans la devise qu'il détient réellement.
📅 Fonds de fonctionnement plutôt que des campagnes ponctuelles : activez le mode « Récurrent uniquement » et l'option ponctuelle disparaît, de sorte que chaque don à cette campagne est un abonnement.
🧾 Équipes sans développeur attitré : 3 jeux d'identifiants collés sur une page de paramètres, et aucun code nulle part.

Consultez notre annonce ici.

Voir toutes les annonces