[benecaster_donor_wall]
Renders a paginated, public thank-you wall of Listener Support donations for a show. Displays donor name, donation amount, date, and (in long format) the donor’s optional note. Donor email addresses and internal user IDs are never rendered.
On single-show installs (exactly one published, non-archived show), show_id is optional — the shortcode auto-resolves the show via benecaster_get_sole_show_id(). On multi-show installs without an explicit show_id, renders an HTML comment and short-circuits.
Pagination: When paged="true", the shortcode reads ?donor_page=N from the URL and renders a Previous / “Page N of M” / Next strip below the list using .benecaster-donor-wall__pagination BEM classes. Multiple shortcodes on one page share the same query var by default — use a custom query var or separate page requests to disambiguate multi-show placements.
Amount display: Amounts are formatted via number_format_i18n as CURRENCY N,NNN.NN. Zero-decimal currencies (JPY, KRW, etc.) render without decimal places. Amount is omitted entirely when the donation row carries no currency code.
Orderby whitelist: Unknown orderby values silently fall through to date_desc rather than erroring. Only date_desc, date_asc, amount_desc, and random are meaningful.
Developer filters: Three PHP filters let you customize per-card markup, query arguments, and the empty state — benecaster_donor_wall_item, benecaster_donor_wall_query_args, and benecaster_donor_wall_empty_message. See the individual filter pages for signatures and examples.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
show_id |
int |
— | No | WordPress post ID of the show whose donations to display. Optional on single-show installs — auto-resolved. Required on multi-show installs. |
limit |
int |
20
|
No | Maximum donations to display per page. Clamped to 100 — values above 100 are silently reduced. |
orderby |
string |
date_desc
|
No | Sort order. Options: date_desc (newest first), date_asc (oldest first), amount_desc (largest first), random. Unknown values fall back to date_desc. |
paged |
bool |
true
|
No | Enable query-string pagination. When true, reads ?donor_page=N and renders a Previous / Page N of M / Next nav strip. Set to false to show a single static page of results. |
format |
string |
long
|
No | Display format. long shows display_name, amount, donated_at, and note. short omits the note field. |