Documentation Charitable

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

Crochets et filtres dans Automation Connect

Comme toutes les extensions Charitable, Charitable Automation Connect est conçu pour être facile à utiliser par les développeurs, avec des hooks et des filtres qui vous aideront à le personnaliser selon vos besoins.

Extension payante

Charitable Automation Connect est un plugin premium. Procurez-le-vous dès aujourd'hui avec l'un de nos packs de plugins.

Filtres

charitable_automation_connect_languages_directory

Ajouté dans la version 1.0.0

Modifiez le répertoire où sont stockées les traductions des extensions.

Valeur de retour

Un string représentant le chemin du répertoire des langues, relatif au répertoire wp-content/plugins.

Arguments

  • $directory (chaîne)

    Le chemin du répertoire des langues. La valeur par défaut est charitable-automation-connect/languages.

charitable_webhook_subscription_failure_threshold

Ajouté dans la version 1.0.0

Modifiez le nombre de fois qu'un webhook peut échouer à être délivré avant que son statut ne soit changé en Désactivé.

Valeur de retour

Entier. La valeur par défaut est 5.

Arguments

  • $seuil (entier)

    Le nombre d'échecs avant qu'un abonnement webhook ne soit désactivé.

charitable_webhook_donation_payload_field_value

Ajouté dans la version 1.0.0

Modifiez la valeur retournée pour un champ spécifique dans les charges utiles de campagne.

Valeur de retour

Mixte.

Arguments

  • $value (mixte)

    La valeur non filtrée à afficher dans les données de la charge utile.

  • $id_champ (chaîne)

    L'ID du champ.

  • $campaign (Charitable_Campaign)

    Une instance de Charitable_Campaign représentant la campagne.

charitable_webhook_donation_payload_field_value

Ajouté dans la version 1.0.0

Modifiez la valeur retournée pour un champ spécifique dans les charges utiles de don.

Valeur de retour

Mixte.

Arguments

  • $value (mixte)

    La valeur non filtrée à afficher dans les données de la charge utile.

  • $id_champ (chaîne)

    L'ID du champ.

  • $donation (Charitable_Donation)

    Une instance de Charitable_Donation représentant le don.

charitable_webhook_recurring_donation_payload_field_value

Ajouté dans la version 1.0.0

Modifiez la valeur retournée pour un champ spécifique dans les charges utiles de don récurrent.

Valeur de retour

Mixte.

Arguments

  • $value (mixte)

    La valeur non filtrée à afficher dans les données de la charge utile.

  • $id_champ (chaîne)

    L'ID du champ.

  • $don_récurrent (Charitable_Recurring_Donation)

    Une instance de Charitable_Recurring_Donation représentant le don récurrent.

charitable_webhook_campaign_payload_fields

Ajouté dans la version 1.0.0

Filtrez la liste par défaut des champs de campagne à inclure. Cliquez ici pour voir tous les champs inclus par défaut.

Valeur de retour

Tableau

Arguments

  • $champs (chaînes[])

    Champs de don récurrent à inclure.

Utilisation

add_filter( 'charitable_webhook_campaign_payload_fields', function( $fields ) {
    unset( $fields['creator_action_required'] );
    return $fields;
} );

charitable_webhook_donation_payload_fields

Ajouté dans la version 1.0.0

Filtrez la liste par défaut des champs de don à inclure. Cliquez ici pour voir tous les champs inclus par défaut.

Valeur de retour

Tableau

Arguments

  • $champs (chaînes[])

    Champs de don récurrent à inclure.

Utilisation

add_filter( 'charitable_webhook_donation_payload_fields', function( $fields ) {
    unset( $fields['donor_comment'] );
    return $fields;
} );

charitable_webhook_recurring_donation_payload_fields

Ajouté dans la version 1.0.0

Filtrez la liste par défaut des champs de don récurrent à inclure. Cliquez ici pour voir tous les champs inclus par défaut.

Valeur de retour

Tableau

Arguments

  • $champs (chaînes[])

    Champs de don récurrent à inclure.

Utilisation

add_filter( 'charitable_webhook_recurring_donation_payload_fields', function( $fields ) {
    unset( $fields['recurring_renewal_date'] );
    return $fields;
} );

Action

charitable_automation_connect_start

Ajouté dans la version 1.0.0

Hook déclenché lorsque le plugin est chargé pour la première fois.

Valeur de retour

Vide

Arguments

  • $plugin (\Charitable\Pro\AutomationConnect\Domain\Bootstrap )

    Une instance de la classe Bootstrap du plugin.

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

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 !

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.

automatisation mettre à jour

⚡ Générateur d'automatisation visuelle : Glisser-déposer sans code !

Charitable Automation Connect 2.3.0 introduit le Générateur d'automatisation visuelle, une zone d'édition plein écran qui présente chaque automatisation sous forme de flux de cartes connectées : un déclencheur, des conditions facultatives et une liste d'actions exécutées dans l'ordre.

🧩 De nombreuses actions, un seul déclencheur : Taguez un donateur, envoyez un e-mail, ajoutez une note et déclenchez un webhook à partir d'un seul événement, disposés dans n'importe quel ordre.

✉️ Agissez à l'intérieur de Charitable : Les nouvelles actions Envoyer un e-mail, Taguez un donateur et Ajoutez une note de donateur s'exécutent sans service externe requis.

🔤 Étiquettes de fusion : Personnalisez les e-mails et les notes avec des champs dynamiques tels que {first_name}, {total} et {campaign_name}.

🔁 Appliquer aux donateurs existants : Exécutez Taguez un donateur et Ajoutez une note de donateur sur les donateurs que vous avez déjà.

🖥️ Zone d'édition ou Simple : Changez de vue à tout moment, et les automatisations créées avant la version 2.3.0 continueront de fonctionner sans modification.

En savoir plus ici.

Intégration mis à jour

📬 Présentation de Brevo pour Charitable : Transformez automatiquement les donateurs en abonnés

Le moment où un donateur fait un don est le moment où il est le plus engagé. Avec la nouvelle intégration Brevo pour Charitable, vous pouvez transformer automatiquement ces donateurs ponctuels en abonnés à long terme sans toucher à une seule feuille de calcul.

Collectez simplement le consentement du donateur directement sur votre formulaire de don et lancez votre série de bienvenue immédiatement.

Quoi de neuf :

🔄 Synchronisation automatisée des abonnés : Les nouveaux donateurs qui donnent leur accord sont ajoutés directement à votre liste de contacts Brevo dès que leur paiement est traité, sans aucune exportation manuelle ni importation de CSV.

🎯 Contrôle granulaire du consentement et de l'opt-in : Personnalisez le libellé de votre case à cocher, choisissez si elle est cochée par défaut ou non, ou activez le double opt-in de Brevo pour maintenir votre liste propre et conforme.

📋 Mappage de liste par campagne : Dirigez les sympathisants vers votre liste d'e-mails globale ou mappez des campagnes spécifiques à des listes Brevo ciblées pour adapter vos messages de suivi.

⚡ Configuration en 5 minutes : Connectez-vous instantanément en collant votre clé API Brevo dans les paramètres de Newsletter, mappez vos champs de contact et commencez à construire votre liste d'e-mails en mode pilote automatique.

Prêt à développer votre liste de diffusion ? Brevo est disponible dès maintenant à partir du plan Charitable Plus — connectez votre compte dès aujourd'hui !