=== JRT CommentShield ===
Contributors: jrtwebsolutions
Donate link: https://www.jrtwebsolutions.com
Tags: comment spam, anti-spam, ai spam, bot protection, security
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Smart and AI-powered anti-spam protection for WordPress comments. Blocks bots and spam automatically, with optional ChatGPT-based detection.

== Description ==

JRT CommentShield protects your WordPress comment section from spam and automated bot attacks using multiple intelligent protection layers.

The plugin works silently in the background and does not require CAPTCHA or any interaction from your visitors. Legitimate users can comment normally while spam and bots are blocked automatically.

JRT CommentShield combines proven anti-spam techniques such as honeypots, timing checks, rate limiting, and IP blocking with optional AI-powered spam analysis using ChatGPT.

The plugin is lightweight, fast, and built using WordPress coding standards with a fully object-oriented architecture.

== Features ==

* Protects the native WordPress comment form
* Blocks automated spam bots using honeypot detection
* Prevents rapid and repeated comment submissions (rate limiting)
* Optional IP address blocking
* Optional AI-based spam detection powered by ChatGPT
* AI can automatically:
  - Allow comments
  - Hold comments for moderation
  - Mark comments as spam
  - Move spam comments directly to Trash
* No CAPTCHA required
* No impact on user experience
* Lightweight and performance-friendly
* Fully object-oriented and WordPress.org compliant

== AI Spam Detection ==

AI Spam Detection is optional and disabled by default.

When enabled, JRT CommentShield sends the comment text and post title to OpenAI (ChatGPT) for spam analysis.

No email addresses or IP addresses are sent to OpenAI.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install it from the WordPress Plugins screen.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to **Settings → JRT CommentShield**.
4. (Optional) Enable AI Spam Detection and enter your ChatGPT API key.
5. Save settings. Protection starts immediately.

== Frequently Asked Questions ==

= Is ChatGPT required? =
No. AI Spam Detection is optional. The plugin works without AI using built-in bot and spam protection rules.

= What data is sent to ChatGPT? =
Only the comment text and post title are sent for spam analysis. No personal data such as email addresses or IP addresses are shared.

= Does this plugin replace Akismet? =
No. JRT CommentShield is an alternative approach. Running multiple anti-spam plugins at the same time is not recommended.

= Does this plugin use CAPTCHA? =
No. The plugin works silently without interrupting visitors.

= Can spam comments be deleted automatically? =
Yes. You can choose to mark spam comments as Spam or move them directly to Trash.

= Will this slow down comment submission? =
AI detection runs only if enabled. You can configure the timeout to balance speed and accuracy.

== Screenshots ==

1. JRT CommentShield settings page
2. AI Spam Detection configuration
3. Spam handling options

== Changelog ==

= 1.0.0 =
* Initial release
* Spam and bot protection for WordPress comments
* Optional ChatGPT-powered AI spam detection
* Honeypot, rate limiting, and IP blocking
* Admin settings page

== Upgrade Notice ==

= 1.0.0 =
Initial release.

== External services ==

This plugin can optionally connect to OpenAI (ChatGPT) to help detect spam comments using AI.

This external service is only used if you enable "AI Spam Detection" in the plugin settings.

= What the service is used for =
To analyze a comment and return a spam score and recommended action (allow, hold, spam, or trash).

= What data is sent and when =
When AI Spam Detection is enabled and a visitor submits a comment, the plugin sends:
- The comment text
- The post title (to help AI understand context)
- A links count (number only)

The plugin does NOT send:
- Comment author email address
- IP address
- Site user data

= Service provider =
OpenAI

Terms of use: https://openai.com/policies/terms-of-use  
Privacy policy: https://openai.com/policies/privacy-policy