Skip to content

BuddyPress groups

Kanbanomy overviewPremiumGet Kanbanomy →

If your site runs BuddyPress with Groups turned on, a group admin can link one of their projects to a private or hidden group. Everyone in the group joins the project, the group gets a Projects tab, and finished work shows up in the group’s activity. Without BuddyPress, nothing here appears and Kanbanomy works as usual.

Works with BuddyPress 12 or newer, in light and dark mode on BuddyX and BuddyX Pro.

  1. Open the group and its Projects tab. While no project is linked, only group admins see this tab.
  2. Open Link a project. It lists the projects you own (Project Managers and administrators see every project). Search by title if the list is long.
  3. Press Link next to the project.

You become an Owner of the project if you were not one already. Everyone else in the group joins as a Member in the background, 200 people at a time, so linking a group of thousands takes a few moments. The project’s Connections tab shows “Adding group members: 400 of 2,000.” until it is done.

Only private and hidden groups can be linked. Anyone can join a public group, so linking one would let anyone on the site into the project. A public group’s Projects tab says so, and the link list is not offered there. Make the group private or hidden in its settings first.

A project belongs to one group at a time. Linking it to a second group moves it: the people the first group brought in leave the project.

  • Everyone in the group joins as a Member, clients included. A client who joins through a group sees what any Member sees: tasks marked Internal, Team only comments and the team list.
  • When a group is linked, each person gets a notice in the bell. No email is sent, however large the group.
  • Someone who joins the group later joins the project and gets the usual “You were added” email.
  • Someone who leaves the group, or is removed or banned from it, leaves the project. Their tasks stay assigned to them, and every project Owner gets a notice listing how many open tasks they still have, with a link to those tasks.
  • People you added to the project by hand are never removed by the group. If you change the role of someone the group brought in, they become hand-managed from then on.

If a group admin switches a linked group to public, the project stops taking new people from the group:

  • Every Owner of the linked project gets a notice in the bell, with a link to the project’s Connections tab.
  • The BuddyPress group card there shows Sync paused and explains why.
  • People who join the group from then on do not join the project. People already on the project stay.
  • Kanbanomy stops posting the project’s work to the group’s activity.

Switch the group back to private or hidden and the sync resumes: Kanbanomy adds everyone who joined the group in the meantime. Or unlink the group.

If BuddyPress is switched off for a while, nothing is lost: people keep their project access. When BuddyPress comes back, Kanbanomy checks every linked group again and adds or removes people to match.

Group members see the linked projects they can open, as the same cards as the Projects page: progress, status and the team. Twelve projects show per page. A project only shows to people who can open it, so a Private project stays hidden from group members who are not on it.

Kanbanomy posts to the group’s activity stream when:

Event Example
A task is completed Maya completed Logo in Acme
A milestone is completed Maya completed the milestone Launch in Acme
A discussion shared with clients is started Maya started the discussion Kickoff in Acme

It never posts about a task marked Internal, anything from a Private project, or anything to a group that has become public. Posts stay inside the group and never show in the site-wide activity stream. It never posts a team-only discussion either; making a discussion team-only or deleting it removes its post. Deleting a project removes its posts.

Open the project’s Connections tab (front end or admin). The BuddyPress group card shows the linked group and how many people came from it. Press Unlink group and confirm. The people the group brought in leave the project; people added by hand, tasks and files stay. Deleting the group unlinks it the same way.

Turn off Integrations under Settings > Features to stop the group link. People keep their project access, and the link is checked again when you turn Integrations back on.

  • kanbanomy_group_linked (action) - fires after a project is linked, with the project id, group id and the user who linked it.
  • kanbanomy_members_changed (action) - fires when project members change without the per-person hooks (a group link, an import), with the project id.
  • kanbanomy_connections_after (action) - renders extra cards on the Connections screens, with the project id (0 on Settings > Connections).

REST routes (only while BuddyPress Groups is active):

  • GET|PUT /kanbanomy/v1/projects/{id}/group - read or change a project’s group. Send group_id (0 unlinks). Needs the project’s Owner or a Project Manager, and an admin of the group. A public group returns 400 kanbanomy_group_public. The response’s group_public is true when the linked group has become public and its sync is paused.
  • GET /kanbanomy/v1/groups/{id}/projects - the linked projects the caller can open, paged with page and per_page; totals in X-WP-Total.