Image

CleanMod – AI Comment Moderation

Description

CleanMod WordPress Plugin integrates CleanMod AI comment moderation to automatically detect and handle toxic comments on your WordPress site.

Features

  • Automatic Moderation: New comments are automatically sent to CleanMod’s moderation API
  • Flexible Behavior: Configure how flagged and blocked comments are handled
  • Fail-Safe: Comments still work even if the API is unavailable
  • Native WordPress Integration: Works with WordPress’s built-in comment system

How It Works

  1. When a new comment is submitted, the plugin intercepts it using WordPress’s pre_comment_approved filter
  2. The comment text is sent to CleanMod’s /api/v1/moderate endpoint
  3. Based on the decision returned (allow, flag, or block), the comment status is adjusted according to your settings
  4. If the API is unavailable, comments proceed normally (fail-open policy)

External Services

This plugin relies on the CleanMod moderation service (https://cleanmod.dev) to analyze and moderate comments. When a new comment is submitted on your WordPress site, the comment text is sent to CleanMod’s API for moderation analysis.

Service Provider: CleanMod

Terms of Use: https://cleanmod.dev/terms

Privacy Policy: https://cleanmod.dev/privacy

By using this plugin, you acknowledge that comment data will be transmitted to CleanMod’s servers for moderation purposes. By default, CleanMod saves only the comment hash and not the text itself. Please review CleanMod’s terms of use and privacy policy to understand how your data is handled.

Configuration

API Key

Get your API key from the CleanMod dashboard.

  1. Navigate to Settings CleanMod in WordPress admin
  2. Enter your CleanMod API key
  3. Enable the plugin
  4. Configure moderation behavior

Moderation Behavior

When decision is “flag”:

  • No change: Comment passes through normally (respects WordPress default settings)
  • Hold for moderation: Comment is held pending manual review

When decision is “block”:

  • Hold for moderation: Comment is held pending manual review
  • Mark as spam: Comment is automatically marked as spam

Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • Valid CleanMod API key

Installation

  1. Upload the cleanmod folder to /wp-content/plugins/
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to Settings CleanMod to configure your API key

FAQ

Does this replace WordPress’s built-in moderation?

No. CleanMod adds an extra safety net on top of your existing moderation rules.

What happens if the CleanMod API is unavailable?

The plugin uses a fail-open policy. If the API is unavailable, comments will proceed normally without CleanMod moderation.

Does this work with comment form plugins?

This MVP version works with native WordPress comments only. Support for Contact Form 7, WPForms, and WooCommerce reviews may be added in future versions.

Reviews

Image
December 10, 2025
Installed CleanMod to deal with increasingly toxic and spammy comments and was pleasantly surprised. Setup took just a few seconds: added the API key, enabled it, and it started working immediately. What I like is that it doesn’t try to replace WordPress moderation rules, just adds an extra layer using AI. Flagged comments go to moderation, really bad ones to spam, and normal comments pass through.Feels lightweight, fast, and well thought out. Looking forward to seeing where this plugin goes.
Read all 1 review

Contributors & Developers

“CleanMod – AI Comment Moderation” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.1.0

  • Initial release
  • Native WordPress comment moderation
  • Configurable behavior for flagged and blocked comments
  • Admin settings page