The 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.

 

NOTE: Give also has a Donor Wall block which we recommend if you are using the WordPress block editor.

 
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.

An example Donor Wall on the San Diego Refugee Tutoring website.

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 give_donor_wall shortcode:

  • form_id = choose to display donors from all forms or one specific form. If this attribute is not set, the shortcode will display donors from all forms combined.

    To find the form ID, go to the Donations screen, hover over the form and the ID appears as shown below.

Example:

[give_donor_wall form_id="23"]
  • order = The order in which you want the donors to appear.
    Accepts “ASC” (newest to oldest). “DESC” (Oldest to newest). Defaults to “ASC”.

Example

[give_donor_wall order="ASC"]
  • ids = A comma-separated list of donor IDs to display. It allows you to display all donors or only specific donors. If this attribute is not set, the shortcode will display all donors.

    To find the donor ID, go to the Donors screen, hover over the donor name and the ID appears as shown below.

Example

[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.

Example

[give_donor_wall donors_per_page="20"]
  • comment_length = The number of words to display for the comments before a “Read more” link appears in the individual donation. Default is 140.

Example

[give_donor_wall comment_length="50"]
  • read_more_text = Change the text that appears when a comment is longer than the comment_length attribute. Defaults to “Read more”.

Example

[give_donor_wall read_more_text="View donor"]
  • load_more_text = Change the text that appears below the donor wall to show more donors. Defaults to “Load more”.

Example

[give_donor_wall load_more_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.

Example

[give_donor_wall columns="4"]
  • 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”.

Example

[give_donor_wall show_avatar="false"]
  • show_name = Choose whether or not the donor’s name appears in this donor wall. Accepts “true” or “false”. Defaults to “true”.

Example

[give_donor_wall show_name="false"]
  • show_total = Choose whether or not the amount donated will appear in the donor wall per donation. Accepts “true” or “false”. Defaults to “true”.

Editor

[give_donor_wall show_total="false"]
  • show_time = Choose to display the date of the last donation. Accepts “true” or “false”. Defaults to “true”.

Example

[give_donor_wall show_time="false"]
  • show_comments = choose whether or not the donor comment is displayed in the donor wall per donation. Accepts “true” or “false”. Defaults to “true”.

Example

[give_donor_wall show_comments="false"]

For Developers

The [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.