Documentation Charitable

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

Crochets et filtres dans les reçus annuels

Comme toutes les extensions Charitable, Charitable Annual Receipts est conçue pour être conviviale pour les développeurs, avec des hooks et des filtres qui vous aideront à la personnaliser selon vos besoins.

Extension payante

Charitable Annual Receipts est un plugin premium. Obtenez-le dès aujourd'hui avec l'un de nos packs de plugins.

Filtres

charitable_dompdf_options

Ajouté dans la version 1.0.0

Modifiez le tableau d'options passé à Dompdf lors de la génération du PDF. Pour voir toutes les options disponibles, consultez :
https://github.com/dompdf/dompdf/blob/master/src/Options.php#L6-L286

Valeur de retour

Un tableau représentant un ensemble d'options.

Arguments

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

charitable_pdf_mode

Ajouté dans la version 1.0.0

Cela vous permet de changer le mode dans lequel le PDF sera chargé. Par défaut, il sera automatiquement téléchargé, mais vous pouvez le changer pour qu'il s'affiche en ligne.

Valeur de retour

Soit download, soit inline.

Arguments

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

Utilisation

add_filter( 'charitable_pdf_mode', function() {
    return 'inline';
} );

charitable_pdf_download_annual_receipt

Ajouté dans la version 1.0.0

Utilisez votre propre classe pour générer le PDF. La classe doit implémenter l'interface \Charitable\Packages\Pdf\Interfaces\ClientInterface.

Valeur de retour

Un objet qui implémente l'interface \Charitable\Packages\Pdf\Interfaces\ClientInterface.

Arguments

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

charitable_annual_receipts_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

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

charitable_annual_receipts_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

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

charitable_annual_receipts_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

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

charitable_annual_receipts_theme_template_path

Ajouté dans la version 1.0.0

Changez le répertoire où sont stockés les fichiers de modèles, relatif au thème/thème enfant.

Valeur de retour

Un string représentant le chemin du répertoire des modèles, relatif au dossier du thème.

Arguments

  • $mode (chaîne de caractères)

    Le mode. Par défaut, download.

Action

charitable_annual_receipts_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

  • $view_args (tableau)

    Arguments passés au modèle.

charitable_before_annual_receipt

Ajouté dans la version 1.0.0

Faites quelque chose avant l’affichage du reçu annuel.

Valeur de retour

Vide

Arguments

  • $view_args (tableau)

    Arguments passés au modèle.

charitable_after_annual_receipt

Ajouté dans la version 1.0.0

Faites quelque chose après l’affichage du reçu annuel.

Valeur de retour

Vide

Arguments

  • $view_args (tableau)

    Arguments passés au modèle.

charitable_annual_receipts_pdf_styles

Ajouté dans la version 1.0.0

Ajoutez des styles personnalisés à la version PDF du reçu annuel.

Valeur de retour

Vide

Arguments

  • $view_args (tableau)

    Arguments passés au modèle.

Utilisation

add_action( 'charitable_annual_receipts_pdf_styles', function() {
    echo "color: #444;";
} );

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 !

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 !

dons récurrents mis à jour

💳 Mises à jour de carte : Corrigez les cartes expirées sans perdre vos abonnements !

Les cartes de crédit expirées ou mises à jour sont l’une des plus grandes fuites silencieuses dans les collectes de fonds récurrentes. Avec les mises à jour de carte dans l’extension Dons récurrents, les donateurs peuvent désormais actualiser leurs informations de paiement directement, en conservant leur abonnement, leur calendrier et leur historique de dons complètement intacts.

Aucun plan annulé, aucun historique perdu et zéro casse-tête administratif pour votre équipe.

Quoi de neuf :

⚡ Assistance en 30 secondes : les donateurs obtiennent un bouton « Mettre à jour la carte » dédié dans leur tableau de bord qui ouvre le portail client sécurisé et conforme PCI de Stripe pour mettre à jour instantanément les détails de la carte.

🔒 Accès sécurisé et limité : limité exclusivement aux mises à jour de carte par défaut, les donateurs ne peuvent pas annuler ou modifier accidentellement leurs plans depuis le portail, en gardant vos webhooks et vos données synchronisés.

🤝 Assistance administrative : vous aidez un donateur par téléphone ? Ouvrez son portail Stripe sécurisé en un clic depuis votre écran d’administration ou générez un lien de mise à jour à usage unique à lui envoyer par e-mail.

📋 Piste d’audit automatique : chaque mise à jour de méthode de paiement est enregistrée automatiquement avec un horodatage dans les journaux système et le profil du donateur individuel.

Prêt à protéger vos revenus récurrents ? Obtenez le forfait Plus ou Pro et mettez à jour Dons récurrents vers la version 2.3.0+ et activez « Mettre à jour la méthode de paiement » dans vos Paramètres dès aujourd’hui !

Intégration constructeur de pages

Les fans de Divi se réjouissent ! Module natif de barre de progression de campagne Divi 5 !

Avec notre nouveau module natif Divi 5, vous pouvez ancrer vos microsites avec des statistiques de collecte de fonds en temps réel directement sur la toile visuelle. Voici comment cela fonctionne et pourquoi il est intéressant de l'activer dès aujourd'hui.

Créez des mises à jour de campagne VISUELLES ET EN DIRECT. Vous pouvez également :

📊 Barre de progression de campagne : Insérez une barre de progression en direct dans n'importe quelle mise en page Divi 5 et affichez la progression de l'objectif en temps réel.

🎨 Contrôles de style approfondis : Personnalisez facilement la couleur de la barre et de la piste, la hauteur et le rayon pour qu'ils correspondent parfaitement à votre marque.

👁️ Prêt pour le Visual Builder : Configurez et prévisualisez tout directement sur la toile Divi en tant que module de première classe.

🔁 Rendu identique : Le même moteur exact alimente ce module, ce qui signifie une conception cohérente sans correctifs hérités.

✅ Lancements plus rapides : Ne quittez jamais l'interface Divi 5 pour configurer des shortcodes ou deviner à quoi ressembleront vos étiquettes d'objectif.

En savoir plus ici.