Discussions
Every project has a message board on its Discussions tab. Start a thread for anything that is not one task: a kickoff, a question for the client, a weekly update. Everyone who can read the thread can reply.
Start a discussion
Section titled “Start a discussion”- Open the project and select the Discussions tab.
- Select New discussion.
- Give it a title and write the first message. Type
@to mention someone on the project. - Turn on Clients can see to share it with the project’s clients. Leave it off to keep the thread with your team.
- Select Start discussion. The new thread opens.
The owner, managers and members of the project can start discussions. Clients cannot start one; they reply in the threads you share with them.
Open a thread, write in the box at the bottom and select Reply. Type @ to mention someone. You can edit or delete your own replies. Replies from other people appear while you have the thread open, without reloading (see Live updates).
A thread shows 50 replies a page, newest page first. The list of threads shows 20 a page, pinned threads at the top, then the most recently active.
Who sees what
Section titled “Who sees what”| Person | Sees | Can do |
|---|---|---|
| Owner and managers | Every thread | Start, reply, edit or share any thread, pin, lock and delete threads, delete any reply |
| Members | Every thread | Start, reply, edit or share their own threads, edit or delete their own replies |
| Clients | Only threads marked Clients can see this | Reply, edit or delete their own replies |
A team-only thread is hidden from clients everywhere: the Discussions tab, search, notifications, emails, the digest, Slack, BuddyPress and the REST API. A client who opens its link sees “Discussion not found”. Select Make team-only on a shared thread to take it back, or Share with clients on a team-only one.
The mention list only offers people who can read the thread. In a team-only thread that is your team. In a shared thread your team can also mention the project’s clients; a client can mention your team, never another client.
Pin, lock and delete
Section titled “Pin, lock and delete”The project owner and managers have these on each thread:
- Pin keeps the thread at the top of the list.
- Lock stops new replies. The thread stays readable, with a note that it is locked.
- Delete removes the thread and all its replies, after you confirm. This cannot be undone.
The site owner can do the same for every project from Kanbanomy > Discussions in the dashboard: search threads, filter by project or by who can see them (Shared with clients or Team only), and pin, lock, unlock or delete.
Notifications
Section titled “Notifications”- Starting a thread notifies everyone who can read it.
- A reply notifies the person who started the thread and everyone who has replied in it.
- An @mention notifies the person mentioned.
Each person gets a bell notification and, if they have email notifications on, an email with an Open the discussion button. People can turn these off under New discussions, and replies in discussions I am part of in their notification settings. The daily digest counts new discussions too. See Notifications.
Project comments from earlier versions
Section titled “Project comments from earlier versions”Before 1.3.0, a project had one comment box on its Activity tab. When you update, those comments move, oldest first, into a thread called General in each project that had any. General is team-only because project comments always were; share it with clients from the thread if you want to. The move runs in the background in batches of 500, so a site with many comments stays responsive. Running it again never moves a comment twice.
The Activity tab keeps the history of what changed and links to the project’s discussions.
Turn discussions on or off
Section titled “Turn discussions on or off”Discussions are on by default.
- For the whole site: Kanbanomy > Settings > Features, Discussions.
- For one project: the project’s Settings tab.
With discussions off, the tab and its links are hidden and the REST API answers 403. Nothing is deleted; turning it back on brings every thread back.
Slack and BuddyPress
Section titled “Slack and BuddyPress”A Slack channel can post A discussion is started and Someone replies in a discussion. A BuddyPress group linked to the project shows “started the discussion” in its activity stream. Both only ever post threads shared with clients, and never anything from a Private project. See Slack messages and BuddyPress groups.
For developers
Section titled “For developers”- REST:
GETandPOST /wp-json/kanbanomy/v1/projects/{id}/discussions(list withpage, start a thread withtitle,body,client_visible).GET,PUTandDELETE /discussions/{id}(PUTtakestitle,body,client_visible,is_pinned,is_locked).GET /discussions/{id}/replies?page=and?after=<reply id>for new replies;POSTwithbodyto reply (409 when the thread is locked).PUTandDELETE /discussion-replies/{id}. A thread the caller may not read answers 404. - Actions:
kanbanomy_discussion_created( $id, $thread, $actor ),kanbanomy_discussion_updated( $id, $after, $before, $actor ),kanbanomy_discussion_deleted( $id, $thread, $actor ),kanbanomy_discussion_reply_added( $reply_id, $reply, $thread ),kanbanomy_discussion_reply_deleted( $reply_id, $reply, $thread ),kanbanomy_discussion_mention( $user_id, $thread, $reply, $actor ). - Filters:
kanbanomy_discussion_can( $allowed, $action, $user_id, $subject )where$actionisread,start,reply,edit,shareormoderate.kanbanomy_discussions_migrate_batch( 500 )sets how many old comments move per batch. - Webhook events:
discussion_createdanddiscussion_reply_added.

