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

Codes courts des campagnes

Table des matières
Paramètres
Utilisation
Paramètres supplémentaires ajoutés par les extensions
Ambassadeurs
Utilisation
Géoréférencement
Utilisation

Le code court [campaigns] vous permet d'afficher une collection de campagnes dans vos articles ou pages.

Paramètres

  • number : Le nombre de campagnes à afficher. Définissez cette valeur sur -1 pour afficher toutes les campagnes. Par défaut, le nombre d'articles que vous affichez sur les pages de blog.
  • orderby : L'ordre dans lequel les campagnes sont affichées. Les options incluent post_date, popular et ending. Depuis la version 1.4, vous pouvez également utiliser l'une des options que WP_Query accepte. Par défaut, post_date.
  • order : Change la direction dans laquelle les campagnes sont triées. Accepte DESC ou ASC. Par défaut, DESC.
  • category : Affiche uniquement les campagnes de certaines catégories, identifiées par leur slug. Passez plusieurs slugs de catégories sous forme de liste séparée par des virgules pour inclure plus d'une catégorie.
  • tag : Affiche uniquement les campagnes avec certaines étiquettes, identifiées par leur slug. Passez plusieurs slugs d'étiquettes sous forme de liste séparée par des virgules pour inclure plus d'une étiquette. Introduit dans Charitable Pro.
  • creator : Affiche uniquement les campagnes créées par un certain utilisateur. L'ID utilisateur doit être passé.
  • exclude : Exclut des campagnes spécifiques par leur ID. Passez plusieurs ID sous forme de liste séparée par des virgules pour en exclure plus d'un.
  • include_inactive : Inclut les campagnes expirées en définissant cette valeur sur 1 ou true. Par défaut, false.
  • status : Filtre les campagnes par statut. Les options incluent active (uniquement les campagnes actives), ended (uniquement les campagnes terminées) ou all (toutes les campagnes quel que soit leur statut). Ce paramètre a priorité sur include_inactive. Introduit dans Charitable Pro.
  • columns : Choisissez le nombre de colonnes dans lesquelles vous souhaitez afficher les campagnes. Prend en charge tout nombre entre 1 et 4. Par défaut, 2.
  • button : Choisissez si vous souhaitez afficher un bouton Faire un don (par défaut), un lien lire la suite (button="details"), ou rien du tout (button="0").
  • id : Affiche des campagnes spécifiques. Vous pouvez fournir un seul numéro ou plusieurs ID sous forme de liste séparée par des virgules.
  • parent_campaigns : Affiche uniquement les campagnes enfants des ID de campagnes parents spécifiés. Passez plusieurs ID sous forme de liste séparée par des virgules. Introduit dans Charitable Pro 1.8.5.
  • parent_only : Affiche uniquement les campagnes parents (campagnes de premier niveau sans parent). Définissez sur 1 ou true pour activer. Ce paramètre a priorité sur parent_campaigns. Introduit dans Charitable Pro.
  • description_limit : Limite le nombre de mots affichés de la description de la campagne. Accepte tout entier positif. Par défaut, 100. Introduit dans Charitable Pro.
  • responsive : Adaptez les campagnes à une mise en page à colonne unique sur les petits écrans. Réglez sur 0 pour désactiver le comportement adaptatif, ou spécifiez un point de rupture personnalisé avec une valeur en px ou em. Le point de rupture par défaut est 768px.
  • masonry : Affichez les campagnes dans une mise en page en mosaïque (comme Pinterest). Réglez sur 1 pour activer la mise en page en mosaïque. Par défaut, la valeur est 0.
  • pagination : Activez ou désactivez la pagination pour la liste des campagnes. Réglez sur true pour activer la pagination, false pour la désactiver. Par défaut, la valeur est false. Introduit dans Charitable Pro 1.8.6.1.
  • pagination_position : Contrôlez où la pagination apparaît par rapport à la liste des campagnes. Les options incluent haut, bas ou les deux. Par défaut, la valeur est bas. Introduit dans Charitable Pro 1.8.6.1.
  • pagination_prev_next : Contrôlez si les liens Précédent/Suivant doivent être affichés dans la pagination. Réglez sur true pour afficher ces liens, false pour les masquer. Par défaut, la valeur est true. Introduit dans Charitable Pro 1.8.6.1.
  • pagination_first_last : Contrôlez si les liens Première/Dernière page doivent être affichés dans la pagination. Réglez sur true pour afficher ces liens, false pour les masquer. Par défaut, la valeur est true. Introduit dans Charitable Pro 1.8.6.1.
  • pagination_mid_size : Contrôlez combien de numéros de page afficher de chaque côté de la page actuelle. Accepte tout entier positif. Par défaut, la valeur est 2. Introduit dans Charitable Pro 1.8.6.1.

Utilisation

Utilisation par défaut :

[campaigns]

Inclure les campagnes expirées :

[campaigns include_inactive=1]

Afficher 30 campagnes :

[campaigns number=30]

Trier les campagnes par le montant d'argent qu'elles ont collecté :

[campaigns orderby=popular]

Trier les campagnes par la date de fin (les plus proches de la fin sont affichées en premier) :

[campaigns orderby=ending]

Afficher uniquement les campagnes de la catégorie « problèmes environnementaux » :

[campaigns category=environmental-issues]

Afficher uniquement les campagnes avec des étiquettes spécifiques :

[campaigns tag=urgent,featured]

Afficher uniquement les campagnes de l'utilisateur avec l'ID 33 :

[campaigns creator=33]

Afficher les campagnes en 3 colonnes :

[campaigns columns=3]

Afficher un lien « lire la suite » pour les campagnes :

[campaigns button="details"]

Afficher uniquement les campagnes avec les ID 33 et 44 :

[campaigns id=33,44]

Afficher uniquement les campagnes enfants de la campagne parente avec l'ID 30 :

[campaigns parent_campaigns=30]

Afficher uniquement les campagnes parentes (campagnes de premier niveau) :

[campaigns parent_only=1]

Filtrer par statut de campagne (afficher uniquement les campagnes actives) :

[campaigns status=active]

Filtrer par statut de campagne (afficher uniquement les campagnes terminées) :

[campaigns status=ended]

Limiter la description de la campagne à 50 mots :

[campaigns description_limit=50]

Désactiver le style adaptatif :

[campaigns responsive=0]

Définir un point de rupture personnalisé de 600px pour le style adaptatif :

[campaigns responsive=600px]

Activer la pagination (4 campagnes par page) :

[campaigns 
    number="4" 
    pagination="true" 
    pagination_position="bottom" 
    pagination_prev_next="true" 
    pagination_first_last="true" 
    pagination_mid_size="2"
]

Paramètres supplémentaires ajoutés par les extensions

Ambassadeurs

Si vous utilisez Charitable Ambassadors version 2.0 ou supérieure, des paramètres supplémentaires sont disponibles pour filtrer les campagnes affichées :

  • parent : Afficher uniquement les campagnes enfants d'une campagne parente spécifique. C'est un alias pour parent_campaigns lors de l'utilisation de Charitable Ambassadors. Passez plusieurs ID sous forme de liste séparée par des virgules.
  • fundraiser_type : Afficher uniquement les campagnes de collecte de fonds d'un type spécifique. Les options incluent :
    • individual – Collectes de fonds individuelles pour des campagnes existantes.
    • team – Collectes d'équipe pour les campagnes existantes.
    • team-member – Campagnes des membres d'équipe.
    • fundraiser – Toute campagne pour une campagne existante ou l'organisation.
    • personal – Toute campagne pour une cause personnelle.
  • fundraiser_type_not: Exclure les campagnes de collecte de fonds d'un type spécifique. Passez plusieurs types sous forme de liste séparée par des virgules. Introduit dans Charitable Ambassadors 2.1.0.
  • fundraise_button: Si défini sur false, le bouton Collecter des fonds ne sera pas affiché. Définissez-le sur le texte de votre bouton préféré si vous souhaitez afficher le bouton. La valeur par défaut est false.
  • join_team_button: Si défini sur false, le bouton Rejoindre l'équipe ne sera pas affiché. Définissez-le sur le texte de votre bouton préféré si vous souhaitez afficher le bouton. La valeur par défaut est false.

Utilisation

Afficher les campagnes qui sont enfants de la campagne parente avec l'ID 30 :

[campaigns parent=30]

Afficher uniquement les campagnes de collecte de fonds d'équipe :

[campaigns fundraiser_type=team]

Afficher uniquement les campagnes personnelles :

[campaigns fundraiser_type=personal]

Exclure les collectes de fonds individuelles :

[campaigns fundraiser_type_not=individual]

Afficher les boutons « Collecter des fonds » et « Rejoindre l'équipe » dans la grille des campagnes :

[campaigns fundraise_button="Fundraise" join_team_button="Join Team"]

Géoréférencement

Si vous avez installé Campaigns Geolocation, vous pouvez afficher les campagnes sur une carte Google, avec quelques paramètres supplémentaires :

  • map: Défini sur 1 ou true pour afficher les campagnes sur une carte. La valeur par défaut est false.
  • width: Définissez la largeur souhaitée de votre carte. Ceci doit être passé comme une largeur CSS valide (400px, 100%, etc.). La valeur par défaut est 100%.
  • height: Définissez la hauteur souhaitée de votre carte. Ceci doit être passé comme une hauteur CSS valide. La valeur par défaut est 500px.
  • zoom: Définissez le niveau de zoom initial auquel vous souhaitez que votre carte s'affiche. La valeur par défaut est auto, le niveau de zoom étant basé sur les épingles ajoutées à la carte.

Utilisation

Afficher les campagnes sur une carte avec une largeur de 900px, une hauteur de 600px et un niveau de zoom défini sur 5 :

[campaigns map=1 width=900px height=600px zoom=5]

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 !

ambassadeurs Nouveau

🖨️ Présentation des prospectus et affiches : collectez des fonds loin de l'écran !

Une grande partie de la collecte de fonds de pair à pair se fait loin d'un écran : à la ligne d'arrivée d'un 5 km, sur un panneau d'affichage d'école, dans une cuisine de bureau. Charitable Ambassadors 3.4.7 ajoute 2 imprimables, un prospectus de collecte de fonds portant la propre histoire et le code QR de chaque collecteur de fonds, et une affiche de recrutement qui inscrit de nouveaux collecteurs de fonds. Les deux s'ouvrent comme une page Web normale et s'impriment directement depuis le navigateur. Pourquoi c'est important :

  • 🏁 Un prospectus pour chaque collecteur de fonds : Chacun porte la propre photo, histoire et objectif de ce collecteur de fonds, avec un code QR qui ouvre sa page plutôt que votre campagne principale.
  • 📌 Une affiche qui recrute : Elle affiche « Recrutement en cours » au-dessus du nom de votre campagne avec un grand code QR qui ouvre votre formulaire d'inscription, afin que quelqu'un puisse commencer à collecter des fonds sans attendre un lien de votre part.
  • 🪄 Aucun outil de conception nécessaire : Les deux imprimables s'affichent comme une page Web normale et s'impriment depuis le navigateur, sans plugin PDF et sans designer.
  • 📄 2 mises en page de prospectus : « À distribuer » contient l'histoire complète pour donner à vos amis et à votre famille, et « À afficher » contient un court message accrocheur avec 5 languettes détachables pour un panneau d'affichage.
  • 🛡️ Désactivé jusqu'à ce que vous l'activiez : Les prospectus restent désactivés après la mise à jour jusqu'à ce que vous les activiez sous Charitable » Ambassadeurs » Autre » Prospectus, et seul le propriétaire ou un administrateur peut en ouvrir un.

Consultez notre annonce ici.

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.

Voir toutes les annonces