=== AI Spam Comment Detector ===
Contributors: wprashed  
Tags: comment spam, spam blocker, openai, ai moderation, antispam  
Requires at least: 5.6  
Tested up to: 6.8  
Requires PHP: 7.4  
Stable tag: 1.0  
License: GPLv2 or later  
License URI: https://www.gnu.org/licenses/gpl-2.0.html  

AI-powered comment spam detection using GPT-4. Blocks spam comments with inline user warnings—no CAPTCHA needed.

== Description ==

**Tired of traditional spam filters missing the mark or adding friction with CAPTCHAs?**  
**AI Spam Comment Detector** uses OpenAI's GPT-4 to intelligently analyze and flag spam comments *before* they get posted — and notifies users inline right on the comment form.

🧠 **Smart Detection**: Uses context-aware GPT-4 language model  
🚫 **Auto-Block Spam**: Flags or blocks comments before submission  
🔔 **Inline Error Messaging**: Warns users above the comment form  
🔐 **Private & Secure**: Only comment content is sent to OpenAI  
🔧 **API Key Config**: Add your own OpenAI API key from plugin settings  

No more CAPTCHAs. No more bots. Just intelligent spam protection.

== Features ==

- Detects spam comments in real time using GPT-4
- Automatically marks spam before submission
- Warns users with inline messages on the comment form
- Admin settings page to set the OpenAI API key
- Handles invalid API key or quota exceeded errors
- WordPress-standard and lightweight

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/ai-spam-comment-detector` directory, or install through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **Settings > AI Spam Detector** to add your OpenAI API key.
4. That’s it! Comments will now be filtered using GPT-4.

== Frequently Asked Questions ==

= What is the OpenAI API key used for? =  
The OpenAI API key is used to securely connect to OpenAI’s GPT-4 model for analyzing comment content and detecting spam.

= How does this plugin work? =  
Before a comment is submitted, it is analyzed by OpenAI's GPT-4 model in real-time. If detected as spam, a warning is shown and the comment is not submitted.

= Can I use this plugin without an API key? =  
No, the OpenAI API key is required for the AI spam detection feature to work.

= What happens if my OpenAI quota is exceeded? =  
The plugin will display an error message such as "OpenAI quota exceeded" and fallback behavior will prevent comment analysis until the quota is reset.

= Is any user data sent to OpenAI? =  
Only the comment text (content) is sent securely to OpenAI's servers for analysis. No user names, emails, or IP addresses are sent.

= Can I customize the AI behavior? =  
Currently, the system uses a fixed AI prompt. More customization features are planned for future versions.

== External Services ==

This plugin connects to OpenAI’s GPT-4 API to analyze and detect spam in WordPress comment submissions.

- **Service Name**: OpenAI (https://openai.com/)
- **What it is used for**: Analyzing comment content using the GPT-4 model to determine whether the comment is spam.
- **What data is sent and when**: The content of each comment is sent to the API at the time of submission, for real-time analysis.
- **Terms of Service**: https://openai.com/terms
- **Privacy Policy**: https://openai.com/privacy

This connection is required for the plugin's core spam detection functionality.

== Screenshots ==

1. Settings screen to enter your OpenAI API key  
2. Inline warning shown when spam is detected  

== Changelog ==

= 1.0 =  
* Initial release  

== License ==

This plugin is licensed under the GPLv2 or later.