Charitable Documentation

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

How to Customize The Ambassador Dashboard: My Campaigns Page

Requires: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

My Campaigns is the page each ambassador lands on after they sign in – their personal dashboard for the fundraisers they’ve created. It’s where they see how much they’ve raised, edit a fundraiser, copy a share link, recruit new ambassadors (if Invitations is on), and pop into editing mode.

The page is rendered by a single shortcode ([charitable_my_campaigns]) and styled by the same template chooser as the Fundraiser Page – so a site running enhanced templates gets an enhanced My Campaigns; a site running legacy gets the legacy view.

The My Campaigns page from an ambassador's perspective, showing their fundraisers with progress bars and action buttons

When You’d Use It

  • Setting up onboarding – the Setup Wizard’s Pages step creates a /my-campaigns/ page automatically. Visit it once to confirm the shortcode rendered.
  • Tuning the layout – hide the thumbnail, hide the share button, default to “most raised” sort, etc. – all without touching code.
  • Adding to an existing page – if you already have an “Account” page, drop [charitable_my_campaigns] inside an existing section.

Where to Find My Campaigns in Ambassadors

In your WordPress admin, go to Charitable » Ambassadors » My Campaigns.

The sub-tab has two halves: a settings column on the left, a live preview of the visitor-facing page on the right. The preview updates as you toggle settings so you can see the effect without flipping browser tabs.

The My Campaigns settings sub-tab with the live preview pane on the right

The My Campaigns Settings

SettingDefaultWhat it controls
Show Search BarOnThe search input above the campaign list.
Show Sort DropdownOnThe sort dropdown above the list.
Default Sort OrderNewest FirstThe initial sort the page loads with. Options: Newest First, Oldest First, Most Raised, Closest to Goal, Ending Soon. Applies even if the dropdown is hidden.
Show Campaign ThumbnailOnThe featured image on each campaign card.
Show Progress BarOnThe fundraising progress bar on each card.
Show Share ButtonOnThe share button on each card.
Show QR CodeOnA “QR code” link in each row that opens a downloadable PNG of the fundraiser URL. Only renders if the global QR Codes toggle is enabled.

The preview pane includes a Populated / Empty state switcher so you can see how the page looks when an ambassador has fundraisers and when they don’t.

The Shortcode

The whole page is rendered by:

[charitable_my_campaigns]

It takes no required attributes. Drop it into any page or post; it shows the current user’s fundraisers, or an empty state if they have none.

Logged-out visitors see a “Please log in” prompt instead. The login link respects whatever login flow you’ve configured (Charitable’s built-in login screen by default).

What Renders When

The shortcode’s render depends on the UI version setting (Charitable > Ambassadors > General > UI Version):

UI versionWhat the page looks like
LegacyThe original 1.x rendering. Plain list, minimal styling.
EnhancedThe 3.0 rendering: card grid, modern layout, share menu, recruit card.
VisualSame as Enhanced for My Campaigns; the difference is only on the fundraiser pages themselves.

The settings sub-tab and live preview reflect whichever UI version you’re on. If you’re still on legacy, you’ll see a banner pointing you to the upgrade.

The Recruit Card

If Invitations is enabled and the signed-in user is eligible to recruit, a “Recruit Fundraisers” card appears at the top of the page above their campaign grid. The card has their personal invite URL, share buttons, a stats line, and a “Your Recruits” toggle.

See Invitations – Recruit Fundraisers with Personal Links for the full rundown.

Per-Campaign Actions

Each campaign card has a row of actions across the bottom:

ActionWhat it does
EditOpens the campaign in the Charitable visual builder (or the appropriate editor for the campaign’s UI version).
ShareOpens the share menu with the same social networks the fundraiser page itself uses.
DonationsIf the Creator Donations Report is enabled, lists every donation to this campaign.
QR CodeOpens a modal with a downloadable PNG of the fundraiser URL.
Recruit(Parent campaigns only) Opens a campaign-scoped invite URL popover.

Whether each action shows up follows the visibility toggles in the settings – hide the share button site-wide, and it disappears from every card.

Campaign Creator Donations Report

A long-running feature on My Campaigns: ambassadors can see and download a CSV of every donation to their fundraiser. The section lives at the bottom of the My Campaigns settings sub-tab (it was on the General sub-tab in 2.x, moved here in 3.0).

SettingDefaultWhat it controls
Allow Export of Donation HistoryOnWhether the Donations action button appears on each card.
Include personal details for anonymous donorsOffWhether anonymous donors are shown with their real name in the export (use only if your privacy policy allows).
Include child campaign donationsOffFor parent campaigns: roll up donations to underlying fundraisers in the export.

Theme Overrides

The whole template is overridable from your theme:

your-theme/charitable-pro/charitable-ambassadors/my-campaigns.php

The default template lives at wp-content/plugins/charitable-ambassadors/templates/my-campaigns.php. Copy it to your theme to make site-wide layout changes that survive plugin updates.

Tips

  • Keep search and sort on. Once an ambassador has more than 3-4 fundraisers, both controls become useful.
  • Default to “Most Raised” for established programs. New ambassadors should land on their highest-performing fundraiser first, not their oldest.
  • The empty state matters. Visit /my-campaigns/ as a user who has zero fundraisers and confirm the empty-state copy points clearly at your submission page.

Developer reference

The rest of this page is for developers customizing My Campaigns.

Shortcode

[charitable_my_campaigns]

Class: Charitable_Ambassadors_My_Campaigns_Shortcode. Display callback returns the rendered HTML directly. The output is filterable via charitable_my_campaigns_shortcode_output:

add_filter( 'charitable_my_campaigns_shortcode_output', function ( $html, $args, $atts ) {
    return $html . '<p>Need help? Email [email protected]</p>';
}, 10, 3 );

Settings storage

charitable_settings > ambassadors > my_campaigns_show_search
charitable_settings > ambassadors > my_campaigns_show_sort
charitable_settings > ambassadors > my_campaigns_default_sort
charitable_settings > ambassadors > my_campaigns_show_thumbnail
charitable_settings > ambassadors > my_campaigns_show_progress
charitable_settings > ambassadors > my_campaigns_show_share
charitable_settings > ambassadors > qr_codes_show_in_my_campaigns
charitable_settings > ambassadors > allow_creators_donation_export
charitable_settings > ambassadors > include_anonymous_donor_details
charitable_settings > ambassadors > creators_donation_export_include_child_campaigns

Read with charitable_get_option( 'my_campaigns_default_sort', 'newest' ).

UI version

charitable_ambassadors_ui_version() returns 'legacy', 'enhanced', or 'visual'. The shortcode renders the appropriate template based on this value. Force the value for testing:

add_filter( 'pre_option_charitable_settings', function ( $v ) {
    // ...inject ambassadors.ambassadors_ui_version into the option array.
} );

Filters

FilterDefaultPurpose
charitable_my_campaigns_shortcode_outputcomputed HTMLFilter the entire shortcode output before return. Receives ($html, $args, $atts).
charitable_ambassadors_my_campaigns_default_sortsetting valueOverride the default sort programmatically.
charitable_ambassadors_my_campaigns_show_searchsetting valueForce search visibility on/off.
charitable_ambassadors_my_campaigns_show_sortsetting valueForce sort dropdown visibility on/off.
charitable_ambassadors_my_campaigns_show_thumbnailsetting valueForce thumbnail visibility on/off.
charitable_ambassadors_my_campaigns_show_progresssetting valueForce progress-bar visibility on/off.
charitable_ambassadors_my_campaigns_show_sharesetting valueForce share-button visibility on/off.
charitable_ambassadors_my_campaigns_card_actionsarray of actionsModify the inline actions on each card. (Same action hook fires for both the page and the recruit-card flow.)
charitable_my_campaigns_query_argscomputedModify the WP_Query args used to fetch the current user’s campaigns.

Actions

ActionArgsFires when
charitable_ambassadors_my_campaigns_before_grid$campaigns, $user_idJust before the campaign grid renders. The recruit card mounts here when Invitations is enabled.
charitable_ambassadors_my_campaigns_after_grid$campaigns, $user_idJust after the grid. Use for an additional footer block.
charitable_ambassadors_my_campaigns_card_actions$campaign_id, $contextInside each campaign card’s action row.

Template

templates/my-campaigns.php                                           # Legacy
templates/my-campaigns-enhanced.php                                  # Enhanced + Visual

Theme override path: your-theme/charitable-pro/charitable-ambassadors/<filename>.php. The template chooser uses Charitable’s standard charitable_template_name + charitable_locate_template filters.

Capabilities

The shortcode renders for any logged-in user. There’s no admin capability gate – if you’re signed in, you see your own fundraisers. To hide My Campaigns from specific user roles, gate the shortcode at render time via charitable_my_campaigns_shortcode_output.

Customization examples

Always sort by Most Raised, regardless of setting:

add_filter( 'charitable_ambassadors_my_campaigns_default_sort', function () {
    return 'most_raised';
} );

Inject a “Start a New Fundraiser” CTA at the top of the grid:

add_action( 'charitable_ambassadors_my_campaigns_before_grid', function ( $campaigns, $user_id ) {
    $url = home_url( '/submit-campaign/' );
    echo '<p class="my-campaigns-cta"><a class="button" href="' . esc_url( $url ) . '">Start a new fundraiser</a></p>';
}, 10, 2 );

Hide the Share button from non-verified ambassadors:

add_filter( 'charitable_ambassadors_my_campaigns_show_share', function ( $show ) {
    $user_id = get_current_user_id();
    if ( '1' !== get_user_meta( $user_id, '_charitable_ambassadors_verified', true ) ) {
        return false;
    }
    return $show;
} );

Add a custom inline action (“Email Donors”) to each card:

add_action( 'charitable_ambassadors_my_campaigns_card_actions', function ( $campaign_id, $context ) {
    $url = add_query_arg( 'campaign_id', $campaign_id, home_url( '/email-donors/' ) );
    echo '<a class="my-campaigns-action" href="' . esc_url( $url ) . '">Email donors</a>';
}, 10, 2 );

Filter the campaigns shown to exclude charitable-rejected:

add_filter( 'charitable_my_campaigns_query_args', function ( $args ) {
    $args['post_status'] = [ 'publish', 'pending', 'draft' ]; // omit charitable-rejected
    return $args;
} );

Related

Helpful Links

🤝 Get help when you need it

Connect with Customer Support →

📑 Find the guide you need

Browse the Documentation Hub →

⬇️ Download proven strategies, campaign ideas, and expert tools

Get the Fundraising Kit →

🔗 Let your AI Assistant do the fundraising work for you.

Connect Charitable to your AI assistant →

💸 Get Free Fundraising Resources
Head to the Charitable Fundraising Hub →

🤔 Got questions about Charitable?
Charitable FAQs →

Need help understanding non-profit terms and jargon?
See our Non-Profit Glossary →

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!

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.

Feature New

🎟️ Introducing Charitable Events: Sell Tickets Inside Your Campaigns!

Most nonprofits sell event tickets in one tool and collect donations in another, which leaves two sets of reports and a manual match at the end of the year. Charitable Events brings both together, selling tickets through the same donation forms and payment gateways you already run in Charitable. Why this is important:

  • 🎟️ Every ticket is a donation: Ticket sales run through the gateway you already use and count toward the campaign goal, with everything managed under Charitable » Events.
  • 📱 QR check-in from any phone: Each attendee gets their own QR code on the receipt, and volunteers scan at the door through a check-in link that needs no WordPress account.
  • 🧾 Receipts ready for tax time: Give each ticket type a fair market value, and Charitable puts the correct tax-deductible amount on every donor receipt.
  • 📋 Attendee details at checkout: Ask every guest for a meal choice, shirt size, or access needs, with a separate attendee record created for each ticket.
  • 🗓️ Blocks and calendars included: Three editor blocks plus Sugar Calendar and The Events Calendar support put your events where supporters already look.

Check out our announcement here.

ai New

🚀 Unleash AI Power in Charitable!

Your AI assistant can now build, edit, and manage your Charitable fundraising campaigns directly — just by asking. With Charitable Pro adding write support for the WordPress Abilities API, tools like ChatGPT, Claude, and Cursor can handle full administrative actions safely through MCP. Why this is important:

  • 🤖 Campaign creation in plain language: Prompt your assistant with a goal like “Set up a fundraiser for the shelter with a $5,000 goal”, and it builds a real draft campaign complete with suggested donation tiers.
  • 🎨 Instant donation form tweaks: Add custom fields, change button colors, or reorder elements without diving into form settings.
  • 📝 Offline gift logging: Tell your assistant about cash or check gifts, and it will match donor emails and record transactions into your history.
  • 🛡️ Safety and control by default: Write access stays strictly off until turned on in Charitable » Tools » AI MCP, keeping read-only reporting safe by default.
  • 📜 Full audit logging: Every change made by an AI assistant is tracked under Charitable » Tools » Logs, so you always know who (or what) updated your site.

Check out our announcement here.

Improvement Payments

💰 Accept Recurring Donations with Windcave and Charitable

A donor sets their gift up once on Windcave’s secure payment page, and Charitable bills every renewal after that on schedule. Why this is important:

🏦 Organizations banked in New Zealand or Australia: monthly giving on the gateway your bank already set you up with, with no second processor to onboard.
⛪ Churches taking regular tithes and offerings: congregants set their own schedule once, which is the simplest way to launch recurring church giving without a separate platform.
🌏 Groups with donors in several currencies: Windcave handles more than 20, so a supporter can give in the currency they actually hold.
📅 Operating funds rather than one-time campaigns: switch on Recurring Only mode and the one-off option disappears, so every gift to that campaign is a subscription.
🧾 Teams with no developer on staff: 3 sets of credentials pasted into a settings page, and no code anywhere.

Check out our announcement here.