Fundations provides two leaderboard blocks: Top Fundraisers (get-fund/top-members) and Top Teams (get-fund/top-teams). Both rank entries with gold, silver, and bronze medals. This is a free feature.
Why use this
Leaderboards motivate fundraisers by showing who is raising the most. Displaying top performers on a campaign page or the site homepage encourages friendly competition and gives recognition to high-performing supporters.
What it does
Top Fundraisers block (get-fund/top-members)
Displays the fundraising pages with the highest raised amounts within a campaign or globally. Each entry shows the position medal (gold, silver, bronze for positions 1–3), the fundraiser name (post title), the raised amount (optional, toggle in block settings), and a link to the fundraising page (optional).
Top Teams block (get-fund/top-teams)
Displays teams ranked by total raised amount. Otherwise identical in structure to the Top Fundraisers block.
Block attributes
Both blocks share these configurable attributes:
| Attribute | Default | Description |
|---|---|---|
showTitle | true | Show/hide the block heading |
customTitle | Top Fundraisers / Top Teams | Custom heading text |
showAmount | true | Show the raised amount next to each entry |
showMedalIcons | true | Show medal emoji for positions 1, 2, 3 |
showLink | true | Link each entry to its fundraising page |
goldColor | #FFD700 | Color for the first-place medal indicator |
silverColor | #C0C0C0 | Color for the second-place medal indicator |
bronzeColor | #CD7F32 | Color for the third-place medal indicator |
fontSize | 16 | Name font size (px) |
fontWeight | 600 | Name font weight |
amountFontSize | 18 | Amount font size (px) |
amountFontWeight | 700 | Amount font weight |
titleFontSize | 24 | Heading font size (px) |
titleFontWeight | 700 | Heading font weight |
titleColor | #1d2327 | Heading text color |
All blocks are server-rendered. The data is fetched fresh on each page load.
How to use it
- Open a campaign page or any page in the block editor.
- Add the Top Fundraisers or Top Teams block from the Fundations block category.
- In the block sidebar, configure the display options.
- Optionally set a custom heading.
- Save and view the page.
What you can and cannot do
You can customise medal colors to match your brand, hide the amounts or the link arrows, and change the heading text per block instance.
You cannot change the ranking logic (it always ranks by raised amount, descending). You also cannot cache the leaderboard output at the block level; caching is handled by your theme or a caching plugin at the page level.
Troubleshooting
Leaderboard shows no entries. Confirm that fundraising pages with raised amounts greater than zero exist and are published. If the block is placed on a non-campaign page, it may need a postId attribute set to the campaign post ID.
Medal icons not appearing. The block uses Unicode emoji characters for medals. Confirm your server’s PHP version supports the emoji output and that no sanitisation filter is stripping them.
Developer reference
The leaderboard blocks do not currently expose a filter hook for their output. The underlying WP_Query arguments and display logic are in Get_Fund_Block_Editor::render_top_members_block() and render_top_teams_block().
To modify the data or output, extend the block via a wrapper block or override the server render with a child theme template.