DOCS

User Dashboard

The User Dashboard is a front-end view of all fundraising pages belonging to the currently logged-in user. It is rendered by the [get_fund_user_dashboard] shortcode. This is a free feature.

User dashboard frontend

Why use this

Fundraisers need to see all their pages in one place, with quick access to edit each one. Without a dashboard, they would need to navigate individually to each fundraising page. The dashboard provides a visual grid of cards showing key stats and action buttons.

What it does

The shortcode queries the current user’s get_fund_action posts (up to 100) and displays them as cards. If the user is not logged in, a “Please log in” message is shown instead.

Card content

Each card displays:

  • Featured image.
  • Post title linked to the fundraising page.
  • Status badge (active, completed, pending, cancelled, closed).
  • Goal amount and raised amount.
  • Progress bar with percentage.
  • Edit button linking to the frontend edit form (?edit_fund={id}).
  • View Action button linking to the fundraising page.

Raised amount calculation

  • The base raised amount comes from _get_fund_raised_amount.
  • _get_fund_raised_amount_offset (manual boost) is added to the display value.
  • If get_fund_exclude_tips_from_amounts is enabled, tip donations are subtracted from the displayed raised amount. Tips are identified by querying donation posts with the relevant status and tip meta.

How to use it

  1. Confirm the Fundations Account page exists (go to Fundations > Settings > Pages).
  2. The Account page should contain the [get_fund_user_dashboard] shortcode (auto-installed).
  3. Link logged-in users to the Account page URL, for example via a “My Fundraising Pages” menu item.
  4. Users see their pages when they visit the page while logged in.
User dashboard card

Shortcode attributes

AttributeDefaultDescription
status(all)Filter cards to a specific _get_fund_status value
orderbydateWP_Query orderby parameter
orderDESCASC or DESC

Examples

Show only active fundraising pages, ordered by title:

[get_fund_user_dashboard status="active" orderby="title" order="ASC"]

Show all pages in default order:

[get_fund_user_dashboard]

Settings and options

Option keyDefaultDescription
get_fund_account_page_id(auto)Page ID of the account/dashboard page
get_fund_edit_page_id(auto)Page ID used for the Edit button links
get_fund_exclude_tips_from_amountsfalseSubtract tip amounts from the displayed raised total

What you can and cannot do

Notes
Display separate dashboards per statusUse the status attribute on separate pages.
Filter query argumentsUse the get_fund_dashboard_query_args filter.
Modify per-card statsUse the get_fund_dashboard_stats filter.
Show another user’s pagesNot possible without custom code. The query is always scoped to the current user.
Display more than 100 actionsNot by default. Override the limit via get_fund_dashboard_query_args.

Troubleshooting

Dashboard shows no cards for a logged-in user. Confirm the user has get_fund_action posts with post_author matching their user ID. Guest-created actions (where the creator is stored in meta rather than as the post author) will not appear unless the post author was updated during the claim process.

Raised amount on dashboard differs from the fundraising page. The dashboard calculates raised amount from postmeta. If the custom table is in use but postmeta has not been synced, a discrepancy can appear. Trigger a stats recalculation for the affected actions.

Edit button links to a 404. Confirm get_fund_edit_page_id points to an existing page. Reinstall the Edit Fundations page from Fundations > Settings > Pages.

Developer reference

Filters

HookArgumentsDescription
get_fund_dashboard_query_argsarray $query_args, int $user_idModify the WP_Query arguments used to fetch the user’s actions.
get_fund_dashboard_statsarray $stats, int $post_idModify per-card stats. Keys: goal_amount, display_raised, percentage, status.