Donor Wall
The donor wall is a public thank-you display for your Listener Support donations. Place the [benecaster_donor_wall] shortcode on any page or episode template to show a browsable list of supporters — their name, donation amount, date, and (optionally) the note they left you.
Donor email addresses and internal account IDs are never included in the output.
Basic Usage
On a single-show install, the shortcode needs no attributes:
[benecaster_donor_wall]
On a multi-show install, specify which show’s donations to display:
[benecaster_donor_wall show_id="12"]
Attributes
| Attribute | Default | Description |
|---|---|---|
show_id |
auto | WordPress post ID of the show. Optional on single-show installs; required on multi-show installs. |
limit |
20 |
Maximum donations per page. Capped at 100. |
orderby |
date_desc |
Sort order: date_desc (newest first), date_asc (oldest first), amount_desc (largest first), random. |
paged |
true |
Enable paginated browsing. Reads ?donor_page=N from the URL and renders a Previous / Page N of M / Next nav strip. |
format |
long |
long shows name, amount, date, and note. short omits the note. |
What Each Supporter Entry Shows
In long format (the default), each entry shows:
- Display name — the name the supporter submitted, or “Anonymous” if they left it blank or opted out
- Amount — formatted with the site’s locale settings (e.g.
USD 25.00,JPY 3,000). Omitted if the donation record has no currency code. Zero-decimal currencies like JPY display without decimal places. - Date — formatted with your WordPress site’s date format setting (Settings → General → Date format)
- Note — any message the supporter included with their donation, sanitised through WordPress’s
wp_kses_post
In short format, the note is omitted. Use this for a compact sidebar widget or a credits roll where space is limited.
Pagination
Pagination is on by default. The shortcode renders a Previous / “Page 2 of 7” / Next strip below the list using .benecaster-donor-wall__pagination BEM classes, which you can style from your theme.
To show a single static page of results with no navigation:
[benecaster_donor_wall show_id="12" paged="false" limit="50"]
Examples
Largest donations first:
[benecaster_donor_wall show_id="12" orderby="amount_desc"]
Compact sidebar — no notes, no pagination, 5 most recent:
[benecaster_donor_wall show_id="12" format="short" paged="false" limit="5"]
Random order (re-shuffles on each page load):
[benecaster_donor_wall show_id="12" orderby="random" paged="false"]
Customizing the Output
Developers can hook three PHP filters to modify the wall without overriding templates:
benecaster_donor_wall_item— modify or replace the HTML for an individual donor card. Return an empty string to suppress a card entirely.benecaster_donor_wall_query_args— change the query that fetches donations (filter by platform, date range, etc.) before it runs.benecaster_donor_wall_empty_message— replace the default “No donations yet” empty state with custom HTML or a call-to-action.
See the individual filter reference pages for signatures and examples.
Privacy Considerations
The donor wall is public — no login is required to view it. Only the information your supporters explicitly submitted (name, note) and the transaction metadata (amount, date) appears. Email addresses are never displayed. If a supporter left their display name blank or requested anonymity, they appear as “Anonymous.”
Consider whether your Listener Support page or privacy policy mentions that donations may be displayed publicly — if supporters expect a private transaction, surfacing their name and amount is a surprise worth disclosing.