Skip to main content
← All apps

Community

Engagement points & badges

This manual is a draft and may change.

What it does

Gives your supporters points for the good things they do: donating, volunteering and bringing in a friend. It keeps one running total per person, awards badges at milestones, and can show an opt-in leaderboard. Today it works quietly in the background; it has no pages of its own yet.

Who uses it

Engagement manager: the role for whoever decides what earns points and how many, creates badges, and adjusts a balance by hand with a reason. Be aware that today the role is only a label: no screen exists for it, and the app's own code does not check who makes an adjustment. It only checks that a reason and a named staff user are given and that the person is not adjusting their own points. Members: earn points automatically; they may choose a public nickname if they want to appear on a leaderboard. There is no screen for either yet, so your 1vsM team does the setup with you.

Setup

  1. Ask your 1vsM contact to install Engagement points & badges on your site.
  2. It installs these first, automatically: Contacts, Outbox + bridge dispatcher, Access.
  3. Ask your 1vsM team to switch on the earning rules you want (see Admin tasks).
  4. Ask them to assign the Engagement manager role to the staff member who will own this.
  5. Optionally ask them to add one or two badges. On the demo site, sample DEMO rules and badges are already loaded.

Admin tasks

There are no admin tabs for this app yet. It is used like this:

  1. Decide what should earn points. Choices today: a donation received, volunteer hours marked verified, a friend referral you approved.
  2. For each, pick either a fixed number of points, or points per unit (for example 1 point per $1, or 10 points per volunteer hour).
  3. Decide on badges: one for reaching a number of points, or one for a number of times someone did something.
  4. Ask your 1vsM team to enter the rules and badges. Only one rule can be active per kind of event.
  5. To correct a balance by hand, your manager gives a reason in writing; members cannot change their own points.

Member view

Members do not see this app yet. Their points are recorded and ready; a page showing balance, history and badges is planned.

Styling it to your brand

This app takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. It applies to every app automatically, so there is nothing to set up here.

Troubleshooting

  1. A rule is refused. You can only reward things the app tracks, and only one rule can be active for each. Turn off the old rule first.
  2. A donation gave no points. Check that a rule for donations is switched on, and that the donor's email matches exactly one person in your contact list; if it matches two, no points are given.
  3. Volunteer hours gave no points. Only hours verified by someone other than the volunteer count, and staff hours never count.
  4. A nickname is refused. It must be 2 to 32 characters, letters, digits, spaces and a few symbols, with no email address, and not already taken.
  5. A balance went below zero. A refund took back points that were already spent. Redeeming is blocked until the member earns more.
  6. A manual change is refused. It needs a reason, a named staff user, and cannot be made by a member on themselves.

FAQ

Can members cheat the total? No. Every change is added to a permanent list that cannot be edited, and the total is kept by the database.

Do points disappear? Not unless a refund reverses them.

Is someone's email shown on the leaderboard? Never. Only the nickname they chose and their points.

Do members get an email when they earn points? Not yet. Nothing is sent.

Can points be spent? Yes, through Loyalty & rewards, if that app is installed.

What to connect

These accounts make the app work with your own services. Enter them once in Set up your site in your account.

  • Discord community — optional. A "Join our Discord" invite and community page on your site.