Le shortcode [charitable_donors] vous permet d'afficher une liste de donateurs pour une ou toutes vos campagnes sur une page. Il utilise le même modèle frontend que le widget Donateurs, donc sa sortie est similaire — il vous offre simplement la flexibilité d'afficher les Donateurs à différents endroits.
Paramètres
numberNombre de donateurs à afficher. La valeur par défaut est10.orderbyPeut êtredate,donationsouamount. La valeur par défaut estdate.orderPeut êtreASC(ordre croissant) ouDESC(ordre décroissant). La valeur par défaut estDESC.campaignPeut être défini sur l'ID d'une campagne,currentpour afficher les donateurs de la campagne actuellement visualisée, ouallou0pour afficher les donateurs de n'importe quelle campagne. La valeur par défaut est0(donateurs de toutes les campagnes).distinct_donorsAfficher uniquement les donateurs uniques. Peut être défini sur0(ne pas afficher les distincts) ou1(afficher les distincts). Si un donateur a fait plus d'un don, il n'apparaîtra qu'une seule fois dans la liste, son montant de don étant calculé sur la base de tous ses dons. La valeur par défaut est0.orientationPeut êtreverticalouhorizontal. La valeur par défaut esthorizontal.show_nameIndique si le nom doit être affiché. Peut être1(afficher) ou0(ne pas afficher). La valeur par défaut est1.show_locationIndique si la localisation du donateur doit être affichée. Peut être1(afficher) ou0(ne pas afficher). La valeur par défaut est0.show_amountIndique si le montant donné par le donateur doit être affiché. Peut être1(afficher) ou0(ne pas afficher). La valeur par défaut est1.show_avatarIndique si l'avatar du donateur doit être affiché. Peut être1(afficher) ou0(ne pas afficher). La valeur par défaut est1.hide_if_no_donorsIndique si le shortcode doit afficher quelque chose si personne n'a encore fait de don. Peut être1(masquer) ou0(ne pas masquer). La valeur par défaut est0.
De plus, si Gift Aid est activé et que vous utilisez la version 1.1 ou supérieure, le paramètre suivant est disponible :
show_gift_aidIndique si le montant de Gift Aid pour le don doit être affiché. Peut être1(afficher) ou0(ne pas afficher). La valeur par défaut est0.
Utilisation
Utilisation par défaut :
[charitable_donors]
Afficher les donateurs de la campagne actuelle (à utiliser sur une page de campagne) :
[charitable_donors campaign=current]
Afficher les donateurs d'une campagne spécifique (remplacez 123 par l'ID de la campagne) :
[charitable_donors campaign=123]
Afficher un classement des donateurs, trié par montant donné :
[charitable_donors orderby=amount]
Afficher les donateurs dans une liste verticale :
[charitable_donors orientation=vertical]
Afficher uniquement les noms des donateurs (masquer le montant, la localisation et l'avatar) :
[charitable_donors show_name=1 show_location=0 show_amount=0 show_avatar=0]
Afficher le montant de l'Aide aux dons pour un donateur (nécessite Charitable Gift Aid 1.1+) :
[charitable_donors show_gift_aid=1]





