Charitable Documentation

Learn how to make the most of Charitable with clear, step-by-step instructions.

Owner Dashboard

Requires: Charitable Pro 1.8.16+ Charitable Ambassadors 3.6.0+

This page is about Charitable Ambassadors, the addon that turns a Charitable campaign into a peer-to-peer one, where your supporters make their own fundraiser pages and raise money on your behalf. The owner dashboard is new in Ambassadors 3.6.0 and exists in no earlier version, so if you cannot find the screens below, update the addon first.

The owner dashboard is a read-only page on the front of your site. Somebody signs in and sees one campaign and everything fundraising beneath it: how much has come in, how many people have signed up, how many have actually raised something, and the newest gifts.

It is for the people running a piece of your program who are not WordPress administrators and should not have to become one.

To give somebody access to it, see Organizers.

The words on this page

Ambassadors nests campaigns inside each other, and this dashboard is a report on one slice of that nest. Four words do most of the work here, and all of them are covered at length on Peer-to-Peer Concepts.

  • Campaign. The appeal everybody is raising for, and the subject of one dashboard. Somebody with access to several switches between them.
  • Participant. One person’s own fundraiser page, nested beneath the campaign. This is what a supporter creates when they sign up to raise money, and what Top Participants ranks.
  • Group. An optional middle tier between the two, either a campaign nested under the parent or a team whose members each have their own page. A school running campaign > class > pupil has groups. A marathon running campaign > runner does not, and Top Groups stays hidden rather than appearing empty.
  • Owner. Whoever is allowed to see a campaign’s dashboard. This is a named list per campaign, not a WordPress role and not authorship, so even the person who created the campaign sees nothing until they are added to it. You manage that list on Organizers.

When you’d use it

  • A teacher wants their own class’s numbers without the whole school’s.
  • A team captain wants to see which of their runners have not started yet.
  • A chapter lead reports a weekly figure upward and currently asks you for it.
  • A board member wants to watch one appeal without an admin account.

Setting it up

Create a page, give it any title you like, and put this on it:

[charitable_owner_dashboard]

One page serves everybody. You do not make a page per campaign or per person. Each visitor sees only the campaigns they have been given, on the same page.

A page containing the owner dashboard shortcode

Publish it, then give somebody access from Organizers.

The page is excluded from page caching automatically, because what it shows differs per visitor. If you run a caching plugin you do not need to add an exclusion by hand.

What somebody sees who is not signed in

A short message asking them to sign in, and nothing else. No campaign names, no figures.

What somebody sees who has no access

A message saying this account is not set up to manage a campaign, and to contact their program administrator. Again, no figures.

This is deliberately a plain message rather than a 404 or a login form. Both of those read as a broken site and generate support tickets.

Switching between campaigns

Somebody with access to more than one campaign gets a selector at the top. The page reloads showing the campaign they chose.

Somebody with access to exactly one campaign does not see a selector, because there is nothing to choose.

The four numbers

The Raised, Registered, Active and Donors tiles

Each tile has a help icon next to its label with the same explanation.

Tile What it counts
Raised Every completed donation to this campaign and the pages beneath it, including gifts made directly on this page, not only on participants’ pages
Registered Fundraiser pages that exist beneath this campaign. A page counts whether or not it has raised anything yet
Active Participants with at least one completed donation. The gap between this and Registered is pages that exist but have not raised yet
Donors Distinct people, counted once each. Someone who gave to three participants counts once here, so this is lower than the participants’ donor counts added together

A fifth tile, Days Left, appears when the campaign has an end date.

Only completed donations count. Pending and failed payments are excluded, and so are test-mode donations when your site is set to exclude them.

The two empty states

  • Nobody has registered yet means no fundraiser pages exist beneath this campaign at all. That is a different problem from people signing up and not raising, so the dashboard says which one it is.
  • Nothing raised yet means pages exist but no completed donation has arrived.

Top Participants

Individual fundraiser pages beneath this campaign, ranked by money raised.

Top Groups

The tier between this campaign and its participants, ranked by money raised.

This only appears when your campaign is organized that way. It needs three levels: the campaign, a middle tier, then the participants. A school with campaign > class > pupil gets Top Groups. A marathon with campaign > runner does not, because there is no middle tier to rank, and the section is hidden rather than shown empty.

The middle tier can be either kind of grouping Ambassadors supports: a campaign nested under the parent, or a team whose members each have their own fundraiser page. Both rank the same way. A team’s row totals every gift to its members, plus any gift made to the team page itself.

Looking into a row

Hover over a name in Top Groups or Top Participants, tab to it with the keyboard, or tap it on a phone. A panel opens showing:

  • the amount raised
  • the date of the last gift
  • a seven-day trend
  • participation, for a group, or donor count, for a participant
The detail panel open on a participant row

Everything in the panel is read-only. There is nothing to click inside it.

Finding who has not started

The gap between Registered and Active is the people who signed up and have not raised anything. That number can be clicked or tapped, and it expands into a list naming them, each linking to their fundraiser page.

The expanded list of participants who have not raised anything

The first 50 names show. Long lists scroll inside the panel.

This is usually the most useful thing on the page: it turns a number into a list of people somebody can actually contact.

Recent Donations

The newest completed donations anywhere in this campaign, including gifts made directly to this page.

Whether donor names appear here is set per campaign. See Dashboard Settings below. With names switched off the dashboard shows amounts only.

Beyond Your Campaign

An optional table listing every participating campaign on the site and what it has raised. Names and totals, nothing else: no groups, no participants, no donors.

The Beyond Your Campaign table showing other campaigns and their totals

It is off until you switch it on, per campaign. A campaign joins only when you tick the box in Dashboard Settings on that campaign. Until at least one campaign has opted in, the section does not appear at all.

Think about this one before switching it on. Everyone who can see any dashboard on your site can see every campaign that has opted in. If you run unrelated clients or chapters on one site and they should not see each other’s totals, leave it off.

Dashboard Settings on a campaign

Each campaign has a Dashboard Settings box in the sidebar of its edit screen.

The Dashboard Settings box on a campaign edit screen
Setting Effect
Show donor names on the dashboard Off shows amounts only in Recent Donations
Include on the cross-campaign scoreboard Off by default. On puts this campaign’s name and total in front of everyone who can see any dashboard on this site

The box also tells you if no page carries the dashboard shortcode yet, and links to the Organizers tab for granting access. Access is not granted from here.

The card on My Campaigns

Somebody who has dashboard access and visits My Campaigns sees a card linking to their dashboard, so they do not have to be sent the URL every time.

It finds the page by looking for the shortcode. If you have more than one candidate page, or want it to point somewhere specific, a filter sets the URL directly. See the developer reference.

Tips

  • Look at the dashboard yourself before you hand it out. Add yourself as an organizer on one campaign and open the page.
  • Check whether your campaign has a middle tier before promising anyone Top Groups.
  • Decide about the cross-campaign table before inviting people, not after.
  • If the numbers look wrong, check whether your site is set to exclude test-mode donations. The dashboard follows that setting.

Developer reference

Shortcode

[charitable_owner_dashboard]

Accepts one optional attribute, campaign, pinning the page to one campaign id. A visitor without access to that campaign still sees only their own, so the attribute narrows rather than grants.

Templates

Template Renders
templates/dashboard/owner-dashboard.php The shell
templates/dashboard/partials/tiles.php The number tiles
templates/dashboard/partials/leaderboards.php Top Groups and Top Participants
templates/dashboard/partials/scoreboard.php Beyond Your Campaign
templates/dashboard/partials/state-notice.php The two empty states

Override any of them from your theme at:

your-theme/charitable/charitable-ambassadors/dashboard/owner-dashboard.php

The base path is filterable with charitable_ambassadors_theme_template_path.

Post meta

Key Holds
_charitable_ambassadors_dashboard_owners Array of user ids with access
_charitable_ambassadors_dashboard_show_donor_names 1 or 0
_charitable_ambassadors_dashboard_on_scoreboard 1 to appear on the cross-campaign table
_charitable_ambassadors_dashboard_generation Cache generation counter, bumped when donations or activity change

Filters

Filter Purpose
charitable_ambassadors_owner_dashboard_url Return a URL to override where the My Campaigns card points
charitable_ambassadors_force_owner_dashboard_page Treat a specific page as the dashboard page
charitable_ambassadors_dashboard_owner_ids The resolved owner ids. Receives ( $ids, $campaign_id )
charitable_ambassadors_dashboard_label Any one of the dashboard’s nouns. Receives ( $default, $key )
charitable_ambassadors_dashboard_label_<key> One specific noun. Keys: board, group, groups, participant, participants, section
charitable_ambassadors_dashboard_activity_key Which Activity value to surface as a tile
charitable_ambassadors_dashboard_activity_tile_label That tile’s label
charitable_ambassadors_dashboard_generation_campaign_id The campaign whose generation counter is bumped

Caching

Payloads are cached per scope in a cap_dash_ transient keyed to the campaign’s generation counter, so a donation or activity entry invalidates the payload rather than waiting for a timeout. The cross-campaign table is cached separately for five minutes.

The page registers as dynamic through Charitable Pro’s charitable_is_dynamic_page framework, which is what keeps it out of page caches.

Authorization

Charitable_Ambassadors_Scope is the gate. Its constructor is private and it is built through Scope::for_owner( $user_id, $campaign_id ), which returns null when that user does not own that campaign. Every query the dashboard runs is bounded by the campaign ids that scope resolved, so there is no path that reads outside it.

The row-detail drill-down re-authorizes on every request rather than trusting the page that rendered the link.

AJAX endpoint

charitable_ambassadors_dashboard_not_started returns the expanded list of participants who have not raised. Logged-in only, nonce charitable_ambassadors_dashboard_row_detail, and it re-resolves the viewer’s scope from the session rather than from the request.

Customization examples

Call the middle tier “Classes” instead of “Groups”

add_filter( 'charitable_ambassadors_dashboard_label_groups', function () {
    return 'Classes';
} );

add_filter( 'charitable_ambassadors_dashboard_label_group', function () {
    return 'Class';
} );

Point the My Campaigns card at a specific page

add_filter( 'charitable_ambassadors_owner_dashboard_url', function () {
    return home_url( '/program-dashboard/' );
} );

Surface an Activity value as a fifth tile

add_filter( 'charitable_ambassadors_dashboard_activity_key', function () {
    return 'miles_run';
} );

add_filter( 'charitable_ambassadors_dashboard_activity_tile_label', function () {
    return 'Miles Run';
} );

Related

  • Organizers – granting and removing access
  • My Campaigns – where the pointer card appears
  • Activity – the module behind the optional fifth tile
  • Overview – the admin-side view across every campaign

Still have questions? We’re here to help!

Last Modified:

What's New In Charitable

View The Latest Updates
🔔 Subscribe to get our latest updates
📧 Subscribe to Emails

Email Subscription

Join our Newsletter

We won’t spam you. We only send an email when we think it will genuinely help you. Unsubscribe at any time!

ambassadors New

🔑 Introducing Passwordless Fundraisers: Sign Up With Just an Email!

Supporters arrive wanting to help, and then the form asks them to invent a password for a website they may only visit twice. A lot of them stop right there. Passwordless Fundraiser Accounts, new in Charitable Ambassadors 3.5.0, let a supporter start a peer to peer fundraiser with nothing but an email address. Why this is important:

  • 🔑 No password step to lose them at: Switch it on in Charitable » Ambassadors » Templates » Submit Form and the create-fundraiser form asks only for a name, an email address and a page title.
  • 👤 Still a real WordPress account: One click in one email confirms the address, signs them in and creates the account, so they can come back later to edit their story, change their photo and see who has donated.
  • 🎚️ Your call on every campaign: Each peer to peer campaign can follow the site default or override it, which matters when a campaign pays fundraisers through Stripe Connect and those people do need a password.
  • 📋 See who has not clicked yet: The Charitable » Ambassadors » Directory » Awaiting Sign-In tab lists everyone still waiting, with the campaign they joined and a Resend button, so a typo or a spam folder is something you can spot and fix.
  • 🛡️ Links a scanner cannot use up: Opening the link only shows a page, and your fundraiser is signed in when they press the button on it, so corporate email scanners never burn the link. Each one works once, expires on its own and is stored only as a hash.

Check out our announcement here.

ambassadors New

🏃 Introducing Activity: Show Progress on More Than Money!

Most peer-to-peer fundraisers are about more than the money. A read-a-thon is about minutes read, a walkathon is about miles walked, and a food drive is about meals packed. Activity for Charitable Ambassadors lets your fundraisers show that effort right beside the dollars they raise. Why this is important:

  • 🎯 Progress on what you actually count: A progress bar shows each thing you count against its own target, sitting right beside the money raised.
  • 🏅 Milestones for the yes or no things: A milestone badge marks the efforts that are simply done or not done, with no number to chase.
  • ✍️ Fundraisers log their own numbers: Your supporters enter their totals from their own pages, so the effort stops living in a spreadsheet, a comment, or nowhere at all.
  • 🤖 Some numbers count themselves: An AUTOMATIC tag appears wherever the site worked the figure out from completed donations, so you can see at a glance what nobody typed in.
  • 🧩 Set it up once, use it anywhere: You decide what gets counted one time, then choose which campaigns count it. Available now in Charitable Ambassadors 3.4.7, with no new plugin and no developer.

Check out our announcement here.

ambassadors New

🖨️ Introducing Fliers and Posters: Raise Money Away From the Screen!

A lot of peer-to-peer fundraising happens away from a screen: at the finish line of a 5K, on a school noticeboard, in an office kitchen. Charitable Ambassadors 3.4.7 adds 2 printables, a fundraiser flier carrying each fundraiser’s own story and QR code, and a recruitment poster that signs new fundraisers up. Both open as a normal web page and print straight from the browser. Why this is important:

  • 🏁 A flier for every fundraiser: Each one carries that fundraiser’s own photo, story and goal, with a QR code that opens their page rather than your main campaign.
  • 📌 A poster that recruits: It shows “Now Recruiting” above your campaign name with a large QR code that opens your sign-up form, so someone can start fundraising without waiting on a link from you.
  • 🪄 No design tool needed: Both printables render as a normal web page and print from the browser, with no PDF plugin and no designer.
  • 📄 2 flier layouts: Hand out carries the full story for giving to friends and family, and Post up carries a short hook with 5 tear-off tabs for a noticeboard.
  • 🛡️ Off until you switch it on: Fliers stay off after the update until you enable them under Charitable » Ambassadors » Other » Fliers, and only the owner or an administrator can open one.

Check out our announcement here.

Improvement Payments

💸 Introducing Tiered Rates for Fee Relief: Match the Ask to the Gift!

Fee Relief asks your donors one short question at checkout: would you like to cover the processing fee on this gift? Until now that question used a single rate for every donation on a gateway, so a $10 gift and a $500 gift were asked for the same percentage. Fee Relief 1.3.0 lets you set as many donation bands as you like, each carrying its own rate. Why this is important:

  • 🪙 Gentler on small gifts: A fixed transaction cost is a far bigger share of a $10 donation than a $500 one, so bands let you ask for less at the bottom.
  • 🎚️ As many bands as you need: Each band carries its own percentage and its own fixed amount, and the top band runs on with no upper limit.
  • 🛑 An optional ceiling: A Maximum fee field stops any donor being asked for more than a number you choose, however large the gift.
  • 🔌 Set per payment gateway: Stripe can run on four bands while Windcave and Payfast stay on a single rate, because bands belong to a gateway and not to your whole site.
  • 🛡️ Nothing changes until you say so: Your current rates stay exactly as they are until you switch Use Tiered Rates on under Charitable » Settings » Advanced » Fee Relief.

Check out our announcement here.

Donations Improvement

📊 Your Pro Dashboard Can Now Compare, Export, and Score!

Most fundraising dashboards only tell you how much you have raised. Charitable Pro 1.8.19 rebuilds the dashboard and the Reports Overview around the harder questions: whether anything is broken, whether this period beat the last one, and which single change would make the most difference today. Why this is important:

  • 📈 Every figure has a trend: Pick a period and the tiles and the chart move together, with each total shown against the previous period.
  • 🗓️ Charts that stay readable: Short ranges group donations day by day, while longer ranges group by week or month, so a full year reads as a curve instead of a flat line.
  • 🔀 Compare any 2 periods: Not just consecutive ones, so you can ask how this December did against last December. That matters because fundraising is seasonal.
  • 📤 Export the whole summary: Send the full overview out as CSV or PDF, ready for a board pack or a funder report.
  • 🎯 Score your setup for free: Have your fundraising setup scored, so the one change worth making next is the one you can see.

Check out our announcement here.