Spam & blocklist filter

Configure banned words or regexes and decide how a match is handled:

// config/comments.php
'blocklist' => ['spam', '/casino|viagra/i'],
'blocklist_action' => 'reject', // 'reject' | 'pending' | 'hidden'

• Plain strings match case-insensitively as whole words — spam matches “Spam!” but not “spammer”.
• Delimited entries such as /casino|viagra/i are used as regular expressions, as written.
• A blank or non-string entry throws an InvalidConfigurationException naming comments.blocklist.

Actions

Edits run the same filter, so a comment posted clean cannot be edited into spam and stay public. An edit only ever tightens the status — it never lifts a hidden comment to pending, and a clean edit leaves a held comment for a moderator to approve.

use RoundlyConsulting\Comments\Exceptions\CommentRejectedException;

try {
    Comments::on($post)->as($user)->body($body)->post();
} catch (CommentRejectedException $e) {
    // $e->getMessage(): "This comment contains content that is not allowed."
}