Comments & Moderation in PolyCMS

Comment System Overview

PolyCMS includes an integrated commenting system that allows visitors to engage with published blog posts. Comments support multi-level nesting (threaded replies) and a complete moderation workflow accessible from the admin panel.

Enabling Comments

Comments can be controlled at two levels:

Global Setting

Navigate to Blog > Settings to enable or disable comments site-wide.

Per-Post Setting

When editing a post, toggle the Allow Comments checkbox in the post settings sidebar. This overrides the global setting for that specific post.

Comment Moderation Workflow

All comments flow through a moderation pipeline. Navigate to Blog > Comments to access the moderation panel.

Comment Statuses

Moderation Actions

For each comment, moderators can:

• Approve — Make the comment visible to all visitors.
• Spam — Flag as spam and hide from the frontend.
• Reply — Post an administrative reply that appears as a threaded response.
• Edit — Modify comment content (useful for removing inappropriate language while preserving the comment).
• Delete — Permanently remove the comment.

Nested Comments

Comments support multi-level threading. When a visitor or moderator replies to a comment, the reply appears indented beneath the parent comment, creating a clear conversation structure.

Rate Limiting

Public comment submission endpoints are protected by an IP-based rate limiter to prevent spam flooding. This rate limiting applies to all public-facing endpoints including search and comment forms.

Comment Data

Each comment records:

• Author name and email
• Comment content
• Submission timestamp
• IP address (for moderation purposes)
• Parent comment ID (for threading)
• Associated post ID

Related Documentation

• Managing Posts — Enable/disable comments per post.
• Troubleshooting — Common comment-related issues.