Toolkit›Customize›Addons›Addons - Active

Addons - Active

Show which members are online right now with a fully customizable badge - colors, fonts, position, animation.

Active Badge - live online indicator on a member profile
Active Badge - example placement on a member profile.

What it does

Active shows a small colored badge on member photos indicating that the member is currently active on your site. Visitors get an at-a-glance signal of who's available right now — useful for marketplace, networking, dating, coaching, and community directories.

The badge appears in two places: on member photos in search result cards and on member profile pages.

Beyond Online Now you can add badges for members who were active recently, members with strong reviews, plan members, new members, featured or verified members, and members you tag (see Badges below).

Every aspect is configurable: how recent counts as "online," what the badge says, where it sits on the photo, what colors and fonts it uses, whether it pulses, and whether members can hide their own badge.

How "online" is determined

A member counts as online if they've been active on your site within the Online Minutes threshold you set. The widget tracks last-active timestamps via a lightweight heartbeat table (osb_heartbeat) that's created automatically the first time the widget runs.

Tune the threshold to match your community's pace:

  • Short window (5–10 minutes) — strict; only currently-on-page members show as online
  • Default (15 minutes) — balanced; covers brief tab-switches and reading time
  • Longer window (30–60 minutes) — generous; counts members who've been around recently as still active

Badges

To add more, open Badges and click Add badge, then pick a type. Each badge has its own words, position and colors, and its own Show when.

Group Badge Shows for
Activity Online now Members active on the site in the last few minutes (your Online Minutes setting)
Activity Available now Members who switched on Available now (see below)
Activity Active recently Members active in a window you set, 24 hours by default
Reputation Reviewed Members with more than four approved reviews
Reputation Top performer Members with at least five five-star reviews and an average above 4.5
Reputation Highly rated Members with at least five reviews and an average above 4.8
Membership Plan badge Members on the plans you choose
Membership New member Members who joined in a window you set, 30 days by default
Status Featured member / Verified member Members marked Featured or Verified on their member record
Custom Tagged members Members carrying a member tag you assign
Custom Custom badge Anyone you choose with your own conditions

Show when

Every badge has a Show when choice:

  • Always shows it on every member. Use it only for a badge every member should wear.
  • Only while the member is online is the right choice for Online Now. If Online Now is set to Always, every card shows "Online Now".
  • While the member has set Available now is for the Available now badge.
  • These conditions... lets you build your own rule from member details: membership plan, review count, average rating, five-star reviews, last active, last login, join date, member tag, account status, verified, featured, top-level category, what the listing represents, city, state and country. Pick whether a member must match all of them or any one.

Reviews without a star rating are left out of the rating conditions; they are never counted as zero.

Several badges on one card

Most badges in one spot (default 2) limits how many badges stack in the same position on a photo. The badge higher in your list wins, so put your best badge first. For the reputation badges, put Highly rated above Top performer above Reviewed in the same spot and set this to 1: each member then wears only their highest one.

Settings tab

Configure via Plugins -> DirectoryCustomize -> My Widgets -> Active Badge -> Configure -> Settings.

Setting Default What it controls
Enable Badge On Master toggle — turn off to disable the entire widget without deleting it
Online Minutes 15 Minutes of inactivity before a member's badge stops appearing
Badge Text Online Now Text inside the badge — localize ("En ligne", "Activo") or rebrand ("Live", "Available", "Here", "Active")
Badge Position bottom-center Where the badge sits on the member photo. Options include: top-left, top-right, top-center, bottom-left, bottom-right, bottom-center
Show Pulse On Subtle pulsing animation around the badge dot — draws the eye to "live" status. Turn off for a static look

Design tab

Configure via Plugins -> DirectoryCustomize -> My Widgets -> Active Badge -> Configure -> Design.

Option Default What it controls
Badge Background Color #23a300 (green) Fill color of the badge — pick from color picker
Badge Text Color #ffffff (white) Color of the "Online Now" text inside the badge
Badge Dot Color #ffffff (white) Color of the indicator dot inside the badge
Badge Shadow Color rgba(0,0,0,0.25) Drop-shadow color behind the badge — softens the edge against varying photo backgrounds
Font Family (inherit site font) Override the badge's font family. Leave empty to inherit your site's default font
Font Size 11px Badge text size. Options: 10px / 11px / 12px / 13px
Font Weight 600 (Semi-bold) Badge text weight. Options: 400 / 500 / 600 / 700
Badge Corner Radius 20px (full pill) Roundness of the badge's corners. Options: 0 (sharp) / 4px / 8px / 20px (full pill)

Color picking tips:

  • Bright green #23a300 (default) — universal "active/available" signal; most familiar to users
  • Brand color — match your directory's primary palette for cohesive look
  • High-contrast — picks the eye out of photo backgrounds; avoid dark colors that get lost in dark photos

Position tips:

  • bottom-center (default) — balanced, centered placement that doesn't obscure the face
  • top-right — natural reading position; good when photos have important content at the bottom
  • bottom-right — classic chat-app convention; instantly understood as "online indicator"

Member privacy controls

Each member can hide their own badge from their profile settings. The widget uses an opt-out heartbeat row (the opt_out column on the osb_heartbeat table) — when a member toggles their badge off:

  • The badge stops appearing for all visitors
  • Their actual last-active data is unaffected — only the visible badge is hidden
  • They can re-enable any time from the same setting

This is recommended for communities that take privacy seriously — health, coaching, dating, networking — where a member might not want to advertise when they're online.

Available now

Members can tell visitors they are free to take business right now, for as long as they choose, and it switches itself off when the time is up. Members pick their own words, for example:

  • "Available now" for a hairdresser taking calls on a day off
  • "Open now" for a food truck that just set up
  • "Afternoon free" for a consultant with a gap in the day

Setting it up

  1. Open Badges and add the Available now badge (Activity group). Its text is the wording members start with, so change it to suit your directory, for example "Open now".
  2. Add the member button to your profile form: a form field of type HTML containing [widget=Online Status - Member Fields]. You can also place the same widget on the member dashboard for a quick one-click button.
  3. Optional, under Settings > Available Now: pick which membership plans can use it (empty means every plan), turn off Members can write their own words, and choose which quick picks show.

What members do

Members click Set available now and choose how long:

  • a quick pick: 1 hour, 2 hours, 4 hours or Rest of today
  • For the next a number of minutes, hours or days
  • Until a date and time

They can type their own words if you allow it. The button then shows the words and the end time, with an x to stop early. Times use the member's own time zone.

A member who has hidden their online status cannot turn this on, because visitors would not see it.

What visitors see

An Available now badge on the member's photo on search results and the profile, with the member's words. It disappears at the end time, even on a page that is already open.

With Directory Hours

If Directory Hours is installed, the hours show the status too, for example "Closed - Available now until 3 PM", and the member button sits in the Hours Quick set row. Directory Hours has a setting, Replace hours while Available now is on, that shows the member as Open until their Available now ends.

Common questions

Why isn't a badge showing for an active member?
Check the following:
  1. Has the member been active within your Online Minutes threshold? Try lowering the threshold to confirm.
  2. Has the member opted out of badge display via their profile settings?
  3. Is the member an active full-status member? Pending or suspended accounts don't display the badge.

Why does every member show "Online Now"?
The Online Now badge's Show when is set to Always. Open the badge in Badges and set Show when to Only while the member is online.

Can I change "Online Now" to something else?
Yes — change Badge Text in Settings. Any short word fits ("Live", "Available", "Here", "Active", or a localized translation).

What's the difference between "Show Pulse" and not?
With Pulse on, a subtle ring animation expands and fades around the badge dot — draws the visitor's eye to the badge as a "live" indicator. With Pulse off, the badge is static. Pulse is recommended for high-engagement directories where you want to actively signal activity; static is cleaner for editorial/professional contexts.

Will the badge slow down my site?
No. The widget reads from a lightweight heartbeat table indexed for fast lookup. The query runs once per page render, no per-card database calls.

Does it work on mobile?
Yes. The badge scales with the photo and stays in the configured position on every screen size. The pulse animation works on every modern browser.

Can a member hide their badge?
Yes. Each member sees a privacy toggle in their profile settings, and switching it off stops their badge appearing for all visitors. Their actual last-active data is unaffected — only the visible badge changes.

Where it lives

In your DirectoryCustomize plugin admin: Plugins -> DirectoryCustomize -> My Widgets -> Active Badge.

Configuration tabs include Badges (your badge list), Settings and Design. Changes apply as soon as they save, with no rebuild or republish.

Need more help?

If you've checked the questions above and the badge still isn't behaving as expected, contact support with:

  • Your directory URL
  • The member username you're testing with
  • A screenshot of your Settings + Design tab values

We'll help you sort it out.