comment_moderation_ai

Comment Moderation AI helps site owners automatically moderate user‑generated comments using artificial intelligence. The module evaluates comments at submission time and assists moderators by flagging potentially inappropriate, risky, or non‑compliant content before it becomes publicly visible.
This module is designed for Drupal 11 sites that require scalable comment moderation while retaining human oversight and editorial control

Features

Comment Moderation AI adds the following capabilities to Drupal’s core Comment system:

• AI‑powered comment analysis

Automatically evaluates new comments using an external AI moderation service. Currently supporting Open AI via its moderation API

• Real‑time moderation at submission

Comments are analyzed as they are posted, allowing immediate flagging or moderation actions

• Workflow‑friendly moderation

Integrates with Drupal’s existing comment approval and moderation interface, allowing moderators to review flagged comments using familiar tools

• Automatic status assignment

Comments can be automatically marked for review or moderation based on AI evaluation results.

• Configurable moderation behavior

Site administrators can enable or disable moderation behavior based on site requirements.

• Drupal 11 native support

Built specifically for Drupal 11 and follows modern Drupal development best practices.

Integration with OpenAI's newest omni-moderation-latest model for superior accuracy and multimodal support. Enable/disable specific OpenAI moderation categories (hate speech, harassment, violence, etc.)

Also this module integrates will with Key module for managing Open AI keys securely

Intelligent Status Management: Risk-based automatic status assignment (high/medium/low priority) based on confidence scores with comprehensive workflow statuses including auto_flagged_high, auto_flagged_medium, flagged_low_risk, and pending_review.

Advanced Custom Policies: Beyond OpenAI moderation, includes keyword filtering, length restrictions, rate limiting, competitor detection, marketing content identification, and PII protection (emails, phones, SSNs, credit cards, addresses).

Enhanced Views Integration: Seamless integration with Drupal's /admin/content/comment/approval view featuring color-coded status badges, priority indicators, advanced filtering options, and visual flagged/clean indicators.

Post-moderation Capabilities: Allow community members to flag published comments with escalation workflows and comprehensive audit trails for all moderation decisions.

Post-Installation

After installation, navigate to Configuration → OpenAI Comment Moderation (/admin/config/comment-moderation-ai) to configure the module:

1. OpenAI API Setup: Enter your OpenAI API key and select your preferred moderation model (omni-moderation-latest recommended). Use the built-in connection test to verify your API setup.
2. Core Moderation Settings: Enable moderation, configure auto-flagging and auto-unpublishing behaviors, and set sensitivity thresholds (0.0 to 1.0).
3. OpenAI Categories: Enable/disable specific moderation categories like hate speech, harassment, self-harm, sexual content, and violence.
4. Custom Policies: Configure additional rules including keyword filtering, length restrictions, rate limiting, competitor detection, marketing content blocking, and PII protection.
5. Permissions: Set up user permissions at /admin/people/permissions for viewing flagged comments, moderating content, and bypassing moderation checks.

Once configured, the module automatically moderates new comments and enhances your existing comment approval workflow at /admin/content/comment/approval with visual status indicators and advanced filtering options.

Additional Requirements

• OpenAI API Key: Required for AI-powered moderation features. Sign up at OpenAI Platform
• PHP 8.3+: Required for optimal performance with regex operations and modern PHP features
• PHP cURL Extension: Essential for API communication with OpenAI services
• Comment Module: Must be enabled (Drupal core dependency)
• Key Module: For secure API key storage and management

The module integrates with Drupal's core comment system and requires no additional external libraries beyond the OpenAI API access.

Recommended modules/libraries

• Devel: Helpful for debugging moderation workflows and testing custom policies during development
• Admin Toolbar: Provides quick access to moderation configuration and flagged comments management
• Views Bulk Operations: Enhances bulk moderation actions for processing multiple flagged comments efficiently
• Mailsystem: Improves email notification formatting for moderation alerts and flag notifications
• Token: Enables dynamic token replacement in notification emails and moderation messages

What differentiates this module is its integration with OpenAI's latest Omni models, comprehensive custom policy engine, intelligent risk-based status management, and seamless Views integration for efficient moderation workflows.

Community Documentation

• Comprehensive README: Detailed documentation included with the module covering all features, configuration options, and troubleshooting guides
• API Documentation: Inline code documentation for developers wanting to extend or integrate with the module