Comment threading

By default, users can reply to comments. Replies are displayed in a thread beneath the parent comment.

Comment reply behavior is controlled by the max_depth configurable and defaults to 4.

  • Set max_depth to 0 to disable comment replies.

  • Set max_depth to a non-zero value to enable comment replies.

Default view

In the default flat comment view, max_depth does not limit the depth of reply threads. Users can continue replying regardless of nesting depth.

Classic view

In the classic comment view, max_depth limits the number of reply levels that can be added to a comment thread.

When the maximum thread depth is reached, the Reply link is no longer displayed for comments at that level. Existing replies are retained and continue to be displayed.

If the maximum thread depth is reduced by an administrator, replies that exceed the new depth limit remain visible, but users cannot add further replies at those levels.

You can share a direct link to a task comment or reply. To learn more, see Share comments

If a parent comment is archived, all replies in the thread are archived with the parent comment. To learn more, see Archive comments.

Configure comment threading

To configure comment threading, update the SWARM_ROOT/data/config.php file and add the following configuration item to the comments block:

<?php
    'comments' => array(
         'threading' => array(
             'max_depth' => 4, // default value 4, set to 0 to disable replies
         ),
    ),

Where max_depth controls comment reply behavior:

  • Set to 0 to disable comment replies.

  • Any non-zero value enables comment replies.

  • In the classic comment view, non-zero values also specify the maximum thread depth.

  • In the default flat comment view, reply depth is not limited.

  • If max_depth is not specified, the default value is 4.