The [wcdp_leaderboard]
Basic Usage
[wcdp_leaderboard]By default, this generates a leaderboard displaying the last 10 donations:
- Mary donated $10.00
2 months ago - Nadia donated $5.00
6 months ago - Carlos donated $10.00
8 months ago - Susan donated $95.00
8 months ago - Kai donated $50.00
8 months ago - Daniel donated $65.00
8 months ago - Elijah donated $45.00
8 months ago - Layla donated $80.00
8 months ago - Lucia donated $50.00
8 months ago - Anna donated $50.00
8 months ago
Shortcode Attributes
The shortcode can be customized using the following attributes:
| Attribute | Description | Default | Example |
|---|---|---|---|
id (optional) | Filters donations by product ID. Use -1 for all products. | -1 | [wcdp_leaderboard id="123"] |
limit (optional) | Sets the number of top donations to display. | 10 | [wcdp_leaderboard limit="5"] |
orderby (optional) | Sorts the leaderboard by date (most recent) or total (highest donation total). | date | [wcdp_leaderboard orderby="total"] |
style (optional) | Changes the leaderboard appearance. Use 1 or 2. | 1 | [wcdp_leaderboard style="2"] |
split (optional) | Enables pagination, showing additional donations on demand. Use -1 to disable. | -1 | [wcdp_leaderboard split="5"] |
button (optional) | Sets the text of the “Show more” button when split is enabled. | “Show more” | [wcdp_leaderboard split="10" button="Load more"] |
fallback (optional) | Message displayed when no donations have been made. | “No donation to this project yet.” | [wcdp_leaderboard fallback="Be the first to donate!"] |
Examples
Display the Top 5 Donors Sorted by Total Amount Donated
[wcdp_leaderboard limit="5" orderby="total"]Show a Leaderboard for a Specific Product (ID 3) with Style 2
[wcdp_leaderboard id="3" style="2"]Create a Paginated Leaderboard with 5 Entries Per Segment
[wcdp_leaderboard split="5" button="Load more donations"]Display a Custom Message When No Donations Exist
[wcdp_leaderboard fallback="Make the first donation now!"]This shortcode makes it easy to highlight and celebrate your donors while offering flexible customization options.