give_donor_wall shortcode allows you to display donor information publicly on your website when donors opt in. This shortcode can be customized with the Shortcode builder anywhere on your website. It can display a modal window donation form pop up, or redirect your donors to the form page.
Displaying the success of your campaign is a great way to encourage potential donors to turn into real donors. One way to do that is with the Give Donor Wall.
Donors appear on the Donor Wall only when they do not opt in to “Anonymous Donations”. Additionally, enable the donor note functionality for the note to appear in the donor wall.
Donor Wall Shortcode Arguments
The following attributes are available to use in conjunction with the
orderby= What you want to sort the donors by.
Accepts “donation_amount” (the amount the donor gave) or leave this attribute blank to sort by donation date.
order= The order in which you want the donors to appear.
Accepts “ASC” (newest to oldest). “DESC” (Oldest to newest). Defaults to “ASC”.
[give_donor_wall ids="12, 2, 34, 55"]
donors_per_page= Number of donors per page. Default ’12’. A “Load More” button will appear at the bottom of the donor wall after this limit has been reached.
comment_length= The number of words to display for the comments before a “Read more” link appears in the individual donation. Default is 140.
readmore_text= Change the text that appears when a comment is longer than the comment_length attribute. Defaults to “Read more”.
[give_donor_wall readmore_text="View donor"]
loadmore_text= Change the text that appears below the donor wall to show more donors. Defaults to “Load more”.
[give_donor_wall loadmore_text="View more donors"]
columns= Set the number of columns that the donations will appear.
Accepts ‘best-fit’, ‘1’, ‘2’, ‘3’, ‘4’. “Best fit” is designed to fit in virtually any available width and it most often the best option.
show_avatar= Choose whether an “avatar” will appear for the donor or not. Avatars only appear if the donor has a Gravatar account (the WordPress default behavior). If donors do not have a Gravatar account, the initials of their first and last name will appear in a circle as a fallback. See the example image above. Accepts “true” or “false”. Defaults to “true”.
show_name= Choose whether or not the donor’s name appears in this donor wall. Accepts “true” or “false”. Defaults to “true”.
show_total= Choose whether or not the amount donated will appear in the donor wall per donation. Accepts “true” or “false”. Defaults to “true”.
show_time= Choose to display the date of the last donation. Accepts “true” or “false”. Defaults to “true”.
show_comments= choose whether or not the donor comment is displayed in the donor wall per donation. Accepts “true” or “false”. Defaults to “true”.
[give_donor_wall] markup can be customized in a similar fashion to any of the other shortcodes. Simply copy the
shortcode-donor-wall.php file from the Give plugin and place it in your theme in a sub-directory called
give. See our docs on “Theming with Give” for more details.