Charitable Documentation

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

Organizers

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. Organizers, and the dashboard that access unlocks, are new in Ambassadors 3.6.0 and exist in no earlier version, so if there is no Organizers tab in your Ambassadors menu, update the addon first.

An organizer is somebody who can see the fundraising dashboard for a campaign without having created that campaign. A teacher who needs to watch their own class. A team captain who wants to see who on their team has started. A chapter lead who reports upward on one branch of a larger appeal.

The Organizers tab is where you grant that access, take it back, and see who currently has it.

If you are looking for what the dashboard itself shows once somebody can see it, that is the Owner Dashboard page.

The words on this page

  • Campaign. The appeal being raised for. Access is granted one campaign at a time, and it reaches everything nested beneath that campaign, so handing somebody one class does not hand them the school.
  • Participant. One person’s own fundraiser page beneath the campaign, which is what a supporter creates when they sign up to raise money. An organizer sees these as names and totals, never as editable pages.
  • Organizer. Somebody on a campaign’s access list. Not a WordPress role, not a capability, and not the campaign’s author, which is what makes it possible to give one teacher one class.
  • Dashboard. The read-only front-end page an organizer lands on. What it shows is documented on Owner Dashboard.

Peer-to-Peer Concepts covers the wider campaign, fundraiser and team vocabulary.

When you’d use it

  • A school runs one parent campaign and each teacher needs to see only their own class, not the whole school.
  • A charity runs a marathon appeal and each team captain wants their team’s numbers without seeing everyone else’s.
  • A staff member has to pull a weekly figure for one program and you would rather not give them access to the WordPress admin to get it.
  • Somebody has left and their access needs to come off today.

Why this is separate from being a campaign author

Access here is explicit. It is deliberately not “whoever created the campaign.”

On most platform setups, one administrator account creates every parent campaign and the families or team members create the pages underneath. If access followed authorship, that administrator would get everything and the people actually running each group would get nothing. That is exactly backwards, so you name the people instead.

An organizer is never given access to the WordPress admin by being made an organizer. They see one front-end page, read only.

Finding it

Go to Charitable > Ambassadors > Directory > Organizers. It sits just after Teams.

The Organizers tab under Charitable Ambassadors Directory

The tab is always present. It does not need switching on.

Before you start: the dashboard page

Organizers need somewhere to sign in and look. Create a page and put the dashboard shortcode on it:

[charitable_owner_dashboard]

You only need one page for the whole site. Everyone who has access to anything uses the same page, and each person sees only their own campaigns on it.

If you have not made that page yet, the Dashboard Settings box on any campaign will tell you so.

Adding somebody who already has an account

  1. Click + Add Organizer, top right.
  2. Start typing a name or email address in Name or Email. Matches appear under the field as you type.
  3. Click the person you meant. Their address fills the field.
  4. Choose the campaign in Campaign.
  5. Click Add Organizer.
Typing a name shows matching people under the field

They have access immediately. There is no email and nothing for them to accept, because the account already exists and already belongs to them.

Search looks at display names, usernames and email addresses. Type at least two real characters: punctuation on its own will not start a search.

Inviting somebody who has no account yet

Type the full email address. If nobody on the site uses it, the button changes to Send Invitation and a line appears telling you what is about to happen.

An unrecognized address turns the button into Send Invitation

Click Send Invitation and they get one email with one link.

An invitation is not access. Nothing is granted until they open the link and accept. Until then they show in the list as pending, and the campaign’s owner list does not include them.

What the person receives

The email names the campaign, names you as the person who invited them, and carries a single link. The link is good for seven days.

When they open it they see a confirmation page naming the campaign and the person who owns it, and two buttons: Accept Access and Decline.

The invitation confirmation page with Accept Access and Decline buttons

Opening the link does not accept anything. That matters because mail scanners and link previewers follow links in email before a person ever clicks. Access is granted only by pressing the button.

When they accept:

  • If they had no account, one is created for them and they are signed in and taken straight to the dashboard. They never choose a password.
  • If they already had an account, access is granted and they are asked to sign in as themselves.

If they decline, no access is granted and the invitation is removed. Nothing is sent to you, so check the list if you want to know.

Reading the list

Column What it tells you
Name The person’s name above their email address. Somebody who has not accepted yet has no account and so no name, and the cell says “Not accepted yet” instead
Manages How many campaigns. Click the count to see them all. A pending row reads “Invited to” and names the one campaign
Status Active, or Invite Pending with the date the invitation was sent
Actions The … menu

Addresses are shown in full here, deliberately. This is the screen where a typo in an address means somebody never gets access, so you need to be able to read it. The small icon beside each address copies it to your clipboard.

There are no separate first and last name columns. An organizer invited by email has no account until they accept, so those columns would be empty for most of the people on this screen.

What you can do to a row

Open the … menu at the end of the row.

For somebody with access:

  • Manage Campaigns opens a window listing every campaign they manage, with a Remove beside each one and a picker at the bottom for adding another. Removing one leaves the rest untouched.
  • Email Sign-In Link sends them a fresh link straight into the dashboard. See below.

For a pending invitation:

  • Resend Invitation sends it again. The earlier link stops working.
  • Revoke Invitation withdraws it. The link stops working and the row disappears.
The campaigns window listing what one organizer manages

You can also reach that same window by clicking the campaign count in the Manages column.

Removing access does not delete the person’s WordPress account. It only stops them seeing that campaign.

Sending a sign-in link

An organizer whose account was created by accepting an invitation has no password, because one was never chosen and never sent. The first visit works because accepting signs them in, but sessions end.

When they need to get back in, click Email sign-in link on their row. They get a one-time link that takes them to the dashboard.

That link:

  • can be used once
  • expires one hour after you send it
  • stops working if their access is removed before they use it

Send a fresh one whenever they ask. There is no limit on how many you send, and sending a new one does not break anything they have not used yet.

What an organizer can and cannot do

Can:

  • see the dashboard for campaigns they have been given
  • see totals, participant counts, top participants and recent donations for those campaigns and everything beneath them
  • switch between their own campaigns if they have more than one

Cannot:

  • see any campaign they have not been given
  • see the WordPress admin
  • edit campaigns, approve fundraisers, or see donor records
  • add or remove other organizers

Changing the word “Organizer”

The word is used throughout the tab, the emails and the confirmation page. Schools often prefer “Teacher”, teams prefer “Captain”, and chapter-based charities prefer “Lead”.

This is changed with a small code snippet, not a setting. Your developer will find both filters in the developer reference below.

Tips

  • Give one person one campaign first and look at the dashboard yourself before sending invitations widely. It is much easier to answer “what will they see” once you have seen it.
  • Check the address before you invite. An invitation to a wrong address is a link somebody else can accept.
  • If a campaign has two people who should see it, add them both to the same campaign rather than making a second campaign.
  • When somebody leaves, remove them the same day. Their access does not expire on its own.

Developer reference

Everything below describes the code surface. None of it is required to use the feature.

Where access is stored

There is no new table. An organizer is a user id in post meta on the campaign:

Key Holds
_charitable_ambassadors_dashboard_owners Array of user ids with access to this campaign

A pending invitation is an unredeemed row in the passwordless tokens table, with the purpose dashboard_access. That table and its lifecycle are documented on How Sign-In Link Data Is Stored.

Token purposes and lifetimes

Purpose Default lifetime Filter
dashboard_access (invitation) 7 days charitable_ambassadors_dashboard_access_token_lifetime
dashboard_signin (sign-in link) 1 hour charitable_ambassadors_dashboard_signin_token_lifetime

Both filters take seconds and are clamped to between one minute and one week after they run, so an out-of-range value cannot mint a link that is already expired or one that never expires.

Neither purpose is accepted by the fundraiser sign-in flow. A dashboard invitation cannot be redeemed as a fundraiser signup, and a fundraiser link cannot be redeemed as dashboard access.

Filters

Filter Purpose
charitable_ambassadors_organizer_label The singular noun. Default Organizer
charitable_ambassadors_organizer_label_plural The plural noun. Default Organizers
charitable_ambassadors_dashboard_owner_ids The resolved owner ids for a campaign. Receives ( $ids, $campaign_id )
charitable_ambassadors_admin_directory_sub_tabs The Directory sub-tab map, if you want to reorder or relabel
charitable_ambassadors_dashboard_access_token_lifetime Invitation lifetime in seconds
charitable_ambassadors_dashboard_signin_token_lifetime Sign-in link lifetime in seconds

charitable_ambassadors_dashboard_owner_ids affects what is read, including the access gate. Returning extra ids from it grants those people access. Writing never passes through it, so an id added by this filter is never persisted to post meta.

Classes

Class Responsibility
Charitable_Ambassadors_Owners Reads and writes the owner list. get_owner_ids(), user_owns(), add_owner(), remove_owner(), get_owned_campaign_ids()
Charitable_Ambassadors_Directory_Organizers The tab, the Add form, and the row actions
Charitable_Ambassadors_Directory_Organizers_Data Builds the rows. Reads only
Charitable_Ambassadors_Directory_Organizers_Search The people-search AJAX endpoint
Charitable_Ambassadors_Organizer_Accept_Endpoint The public accept and sign-in pages
Charitable_Ambassadors_Email_Organizer_Invite The invitation email
Charitable_Ambassadors_Email_Organizer_Signin The sign-in link email

Admin-post actions

All six require the manage_charitable_settings capability and a nonce whose action incorporates the row’s own ids, so a nonce minted for one row cannot act on another.

Action Does
charitable_ambassadors_add_organizer Adds or invites from the form
charitable_ambassadors_organizer_add_campaign Adds one campaign to one organizer
charitable_ambassadors_organizer_remove_campaign Removes one campaign from one organizer
charitable_ambassadors_organizer_resend Resends a pending invitation
charitable_ambassadors_organizer_revoke Withdraws a pending invitation
charitable_ambassadors_organizer_signin_link Emails a sign-in link

AJAX endpoint

charitable_ambassadors_organizer_search powers the Add form’s search. It is registered for logged-in requests only and checks manage_charitable_settings after the nonce. It returns display name and email for matches, capped, and searches user_login, display_name and user_email.

On multisite it is scoped to the current site, so a user who belongs to another site on the network will not be found.

The public endpoint

Both the invitation and the sign-in link resolve at:

https://example.org/organizer-invite/<token>/

The query-arg form ?charitable_ambassadors_organizer_accept=<token> also works, for sites without pretty permalinks. The page is excluded from page caches, carries noindex and no-referrer, and sets no cookie on the GET.

Emails

Email ID Sent when
organizer_invite You invite an address with no account
organizer_signin You click Email sign-in link

organizer_invite is force-enabled, because it carries the only link that can complete an invitation and an operator switching it off would make invitations silently useless. organizer_signin follows the normal enable toggle.

Both have their own merge tags, and each link tag is restricted to its own email. Pasting [charitable_email show=organizer_signin_link] into a donation receipt yields nothing, rather than mailing that receipt’s recipient a working sign-in link.

Customization examples

Call them Teachers

add_filter( 'charitable_ambassadors_organizer_label', function () {
    return 'Teacher';
} );

add_filter( 'charitable_ambassadors_organizer_label_plural', function () {
    return 'Teachers';
} );

Make invitations expire in 48 hours instead of a week

add_filter( 'charitable_ambassadors_dashboard_access_token_lifetime', function () {
    return 2 * DAY_IN_SECONDS;
} );

Give a reporting account read access to every campaign

add_filter(
    'charitable_ambassadors_dashboard_owner_ids',
    function ( $ids, $campaign_id ) {
        $ids[] = 42; // The reporting user's id.
        return $ids;
    },
    10,
    2
);

This grants access on read without writing anything to the database, so the Organizers list will not show that account. Remove the snippet and the access goes with it.

Related


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.