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 !

Nouveau modèles

🤩 Nouveaux modèles de campagne Beacon avec bloc « Héros » !

Avec les nouveaux modèles de campagne Beacon pour Charitable Pro, vous pouvez lancer une page de collecte de fonds époustouflante sur toute la largeur qui capte instantanément l’attention des visiteurs au-dessus de la ligne de flottaison.

En-tête de la page de collecte de fonds pour Sauver le parc Maple Grove avec un widget de don et une petite photo carrée d'une miniature d'arbre ensoleillé à gauche.

🔦 Impact au-dessus de la ligne de flottaison : commencez avec une image principale sur toute la largeur, votre logo et votre objectif avec un widget de don directement sur la bannière afin que votre demande et votre élan soient enregistrés instantanément sans faire défiler.

📐 Deux mises en page flexibles : choisissez entre une mise en page structurée à deux colonnes pour le récit côte à côte et les détails de support, ou une vue épurée à une colonne conçue pour des récits longs et ininterrompus.

⚡ Champ Héros tout-en-un : alimenté par le nouveau champ Héros de campagne, réunissant les médias d’arrière-plan, les barres de progression en direct, les montants de don personnalisés et les onglets de dons récurrents dans un seul bloc cohérent qui peut être intégré dans n’importe quelle mise en page.

🎨 Correspondance automatique des thèmes : la bannière principale et le widget de don héritent automatiquement des couleurs de bouton et d’accent de votre thème de campagne, garantissant que l’ensemble de votre présentation reste magnifiquement fidèle à la marque sans toucher une ligne de CSS.

En savoir plus ici.

formulaire de don Fonctionnalité Nouveau

📝 Bloc de formulaire de don : Intégrez un formulaire de don fonctionnel n'importe où

Avec le nouveau bloc de formulaire de don pour Charitable Pro, vous pouvez placer un formulaire de don entièrement fonctionnel directement sur n'importe quelle page ou publication dans l'éditeur de blocs WordPress. Pas de redirections, pas de rechargements de page, et zéro friction entre la lecture de votre histoire et la contribution.

📝 Placez des formulaires n'importe où : Placez un formulaire fonctionnel directement sur votre page d'accueil, à l'intérieur d'une publication de blog axée sur l'histoire, sur une page de destination dédiée, ou dans une annonce de campagne.

🎯 Liaison dynamique de campagne : Choisissez facilement une campagne spécifique dans la barre latérale du bloc ou définissez-la pour qu'elle se lie automatiquement à la campagne en cours de visualisation.

📐 Vues de formulaire complètes vs minimales : Basculez entre une mise en page complète ou une vue minimale compacte pour s'adapter parfaitement aux barres latérales, aux colonnes étroites ou aux larges pages de destination.

🎨 Styles sans code ciblés : Personnalisez la typographie, l'espacement des conteneurs, le rayon des bordures, les boutons de montant et les couleurs d'accent indépendamment pour chaque instance de formulaire sans toucher une ligne de CSS.

En savoir plus ici.

ambassadeurs Nouveau

👤 Profils des créateurs : Mettez un visage derrière chaque campagne pair-à-pair

Ambassadors 3.3.0 propose désormais des profils de créateurs, offrant à vos supporters un espace public permanent et partageable qui transforme les collecteurs de fonds ponctuels en relations durables.

👤 Pages publiques des créateurs : Donnez à chaque collecteur de fonds une page de destination instantanée et soignée sur /creator/leur-nom/ pour présenter leur avatar personnalisé, leur biographie et une grille consultable de leurs campagnes.

📊 Preuve d'impact : Renforcez la confiance des donateurs en affichant les jalons de l'ensemble du site sur le profil, tels que le montant total collecté et le nombre total de donateurs.

💳 Cartes interactives au survol : Lorsque les donateurs survolent le nom d'un créateur sur une page de campagne, une carte compacte s'affiche avec sa biographie et ses identifiants sociaux au moment de la décision.

📍 Partage responsable de la localisation : Permettez aux créateurs d'indiquer en toute sécurité où se trouvent leurs supporters locaux en utilisant uniquement les détails de la ville, de l'État et du pays.

🛠️ Personnalisation en libre-service : Les collecteurs de fonds peuvent mettre à jour leurs propres profils et lier jusqu'à six réseaux sociaux directement depuis le hub Mes campagnes, ce qui vous fait gagner du temps d'administration.

Prêt à responsabiliser vos défenseurs ? Mettez à jour vers Ambassadors 3.3.0 et activez "Activer la page publique du créateur" dès aujourd'hui !

Amélioration Paiements

📱 Transformez les utilisateurs mobiles en donateurs : Découvrez la mise à niveau Mollie de Charitable

Vous perdez des supporters mobiles parce qu'ils détestent taper de longs numéros de carte sur leur téléphone ? L'intégration Mollie mise à jour de Charitable propose :

⚡ Paiement instantané via portefeuille : Permettez aux donateurs d'effectuer leurs dons instantanément en utilisant Apple Pay ou Google Pay avec une simple analyse faciale, une empreinte digitale ou un toucher.

💰 Pas de charge PCI supplémentaire : Évitez la vérification complexe du domaine et la conformité de sécurité, car toutes les transactions de portefeuille s'effectuent en toute sécurité via le paiement hébergé de Mollie.

🛠️ Routage personnalisé de l'annulation : Gardez l'expérience prévisible en renvoyant automatiquement les donateurs qui se retirent vers votre page d'annulation, ou utilisez des filtres de développeur pour les rediriger vers une page personnalisée.

Visitez cette page pour en savoir plus.

ambassadeurs amélioré Nouveau

Écrans de modération et d'annuaire dans Ambassadors 3.0

Ambassadors 3.0 propose de nouvelles fonctionnalités : écrans de modération et d'annuaire... voyez facilement ceux qui gagnent des dons sur votre réseau pair-à-pair, y compris les créateurs de campagnes qui pourraient avoir besoin d'être vérifiés, le tout en un seul endroit. Générez des rapports, envoyez des e-mails directement aux ambassadeurs et aux créateurs de campagnes, et plus encore.

🚀 Voyez quand les créateurs de campagnes et les ambassadeurs ont mis à jour leurs campagnes, ce que les donateurs/dons qu'ils ont apportés et plus encore.

🎉 Ajoutez manuellement des ambassadeurs et des créateurs de campagnes, et approuvez-les en un clic !

Visitez cette page pour en savoir plus.