===  Comment Spam Blocker ===
Contributors: snehalpancholi
Tags: spam, comments, anti-spam, moderation, keywords
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Blocks or holds for moderation any comment containing banned keywords, excess links, or originating from blocked email domains.

== Description ==

Comment Spam Blocker gives site owners fine-grained control over comment spam without relying on third-party services. Define your own blocked keywords, hold-only phrases, link-count thresholds, and blocked email domains — all from a single settings page.

**Key Features**

* Blocked keywords list — spam or hold any comment containing these phrases
* Hold-only keywords list — always hold comments with specific phrases for manual review
* Maximum link threshold — auto-spam comments with too many URLs
* Blocked email domains — reject comments from disposable or spam email providers
* Monthly and total spam/held stats on the settings page
* Tightened comment flood protection (15-second minimum between comments)

== Installation ==

1. Upload the `comment-spam-blocker` folder to `/wp-content/plugins/`.
2. Activate the plugin in **Plugins → Installed Plugins**.
3. Go to **Settings → Comment Spam Blocker** to configure your rules.

== Frequently Asked Questions ==

= Does this replace Akismet? =
It complements Akismet rather than replacing it. Both can run simultaneously; this plugin adds custom rule-based filtering on top.

= Will legitimate comments be blocked? =
Only if they contain a keyword or domain you have listed. Review your keyword lists carefully.

= Where are spam stats pulled from? =
Directly from the wp_comments table — no extra tracking data is stored.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
