Skip to content

Every member controls their own favourite notifications from their BuddyPress profile. Everything is on by default, so a member only visits these screens if they want fewer.

Favourite alerts are set in two places under Settings in the member’s own BuddyPress profile:

  • Settings > Email is BuddyPress’s own email tab. It holds the email switches.
  • Settings > Favorite Notifications is the plugin’s tab (URL slug favorite-notifications). It holds the web and real-time switches, and links to the Email settings.

The plugin tab needs the BuddyPress Settings and Notifications components to be active. While Notifications is off the tab is hidden, because web and real-time alerts cannot be delivered. A member can only edit their own settings, or a moderator with the bp_moderate capability can edit any.

On Settings > Email, the Likes table has two rows, each with Yes and No:

  • A member likes your activity
  • A member likes your comment

Choosing No stops that email. The unsubscribe link in each email does the same. See Email Alerts.

The Settings > Favorite Notifications tab has one row per notification type:

  • Likes on my activity posts: someone likes the member’s activity posts.
  • Likes on my comments: someone likes the member’s comments.

Each row has a switch per channel:

  • Web: the on-screen BuddyPress notification.
  • Real-time: the on-screen popup. This column only appears when the site owner has switched real-time popups on.

Turning a channel off stops that notification for that type. All channels are on by default, so a new member receives everything until they change it.

Each surface checks its own channel before firing:

  • A web notification is created only if the member’s “web” preference for that type is on.
  • An email is sent only if the member’s email preference for that type is on. This does not depend on the web channel.
  • Popups run only if the site owner has them on and the member has “real-time” on for at least one type.

Preferences are stored in the plugin’s own {prefix}bp_favorite_notification_prefs table, keyed by member and notification type. BuddyPress writes the email choices as user meta (favorite_activity and favorite_activity_comment), and the plugin keeps the two in step, so the Email tab, the unsubscribe link and the stored preference never disagree.