=== SpamKiller ===
Contributors: spamanalyzer
Tags: spam, anti-spam, contact form, comments, woocommerce, security
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered spam detection for WordPress. Protect contact forms, comments, registrations, and WooCommerce with advanced Gemini AI technology.

== Description ==

**SpamKiller** uses advanced AI technology to protect your WordPress site from spam. Unlike traditional keyword-based filters, our plugin uses Google Gemini AI to understand context and identify spam with unprecedented accuracy.

= Features =

* **AI-Powered Detection** - Uses Google Gemini AI for context-aware spam detection
* **Fast Response Time** - ~300ms average validation time
* **Multiple Form Support** - Works with Contact Form 7, Gravity Forms, WPForms
* **WooCommerce Protection** - Checkout, product reviews, and registration spam detection
* **Comment Protection** - Validates WordPress comments automatically
* **Registration Protection** - Prevents spam bot signups
* **Real-time Statistics** - Dashboard widget with spam detection stats
* **Configurable Threshold** - Set your own spam score threshold (0-100)
* **Block or Log Mode** - Choose to reject spam or just log for review
* **Zero Configuration** - Just add your API key and you're protected

= Supported Integrations =

* Contact Form 7
* Gravity Forms
* WPForms
* WordPress Comments
* User Registration
* **WooCommerce** (NEW in v1.1.0)
  * Checkout spam protection
  * Product review validation
  * Registration during checkout

= How It Works =

1. Install and activate the plugin
2. Get your free API key from [spamkiller.io](https://spamkiller.io/register)
3. Enter your API key in the settings
4. All forms are automatically protected!

= Free Plan Includes =

* 100 validations per month
* All features included
* No credit card required

Upgrade to paid plans for more validations and higher rate limits.

= Why Choose SpamKiller? =

* **Accurate** - AI understands context, not just keywords
* **Fast** - Average response time under 300ms
* **Easy** - No complex configuration or training needed
* **Reliable** - Graceful degradation if API is unavailable
* **Private** - We don't store your form data
* **GDPR Compliant** - Privacy-focused design

== Installation ==

= Automatic Installation =

1. Login to your WordPress admin panel
2. Go to Plugins → Add New
3. Search for "SpamKiller"
4. Click "Install Now" and then "Activate"
5. Go to SpamKiller settings and enter your API key

= Manual Installation =

1. Download the plugin ZIP file
2. Login to your WordPress admin panel
3. Go to Plugins → Add New → Upload Plugin
4. Choose the ZIP file and click "Install Now"
5. Activate the plugin
6. Go to SpamKiller settings and enter your API key

= Getting an API Key =

1. Visit [spamkiller.io/register](https://spamkiller.io/register)
2. Create a free account
3. Create a new project
4. Copy your API key
5. Paste it in the plugin settings

== Frequently Asked Questions ==

= Do I need an API key? =

Yes, you need a free API key from [spamkiller.io](https://spamkiller.io). The free plan includes 100 validations per month.

= Which forms are supported? =

Currently: Contact Form 7, Gravity Forms, WPForms, WordPress Comments, and User Registration. More integrations coming soon!

= Will it slow down my site? =

No! Validation happens during form submission (not page load) and takes ~300ms on average. Plus, if the API is unavailable, forms continue to work normally.

= What happens if I exceed my quota? =

Forms will continue to work, but spam validation will be skipped until your quota resets (monthly). You can upgrade your plan anytime for more validations.

= Can I test it before using on production? =

Yes! Install on a staging site first, or use "Log only" mode which records spam but doesn't block it.

= Does it work with custom forms? =

Currently, we support the most popular form plugins. Custom form support can be added via hooks. Contact us for guidance.

= Is it GDPR compliant? =

Yes! We only process the data necessary for spam detection and don't store or share personal information with third parties.

= What if a legitimate submission is blocked? =

This is rare with our AI, but you can:
- Increase the spam threshold (e.g., from 70 to 80)
- Use "Log only" mode temporarily
- Check validation logs for patterns
- Contact support with examples

== Screenshots ==

1. Admin settings page with API status and statistics
2. Dashboard widget showing spam detection stats
3. Easy configuration - just add your API key
4. Real-time spam detection in action
5. Detailed statistics for last 30 days

== Changelog ==

= 1.1.0 - 2025-11-01 =
* **NEW:** WooCommerce integration - Checkout spam protection
* **NEW:** WooCommerce product review validation
* **NEW:** WooCommerce registration during checkout protection
* Improved admin settings UI with WooCommerce options
* Better spam detection for e-commerce transactions
* Performance optimizations

= 1.0.0 - 2025-10-29 =
* Initial release
* Contact Form 7 integration
* Gravity Forms integration
* WPForms integration
* WordPress Comments protection
* User Registration protection
* Admin dashboard widget
* Configurable spam threshold
* Block/Log modes
* Statistics dashboard

== Upgrade Notice ==

= 1.1.0 =
Major update! WooCommerce support added. Protect your online store from fake orders and spam reviews.

= 1.0.0 =
Initial release of SpamKiller. Get your free API key and start protecting your site today!

== Privacy Policy ==

SpamKiller processes form submissions to detect spam. We collect:
- Email addresses from form submissions
- Message content
- Form field names and values
- IP addresses (for logging)

We do NOT collect or store:
- Passwords
- Payment information
- Personal data beyond what's in the form

All data is transmitted securely via HTTPS. Validation results are stored locally in your WordPress database. API logs are retained for 90 days for support purposes.

For more information, see our [Privacy Policy](https://spamkiller.io/privacy).

== Support ==

Need help? Contact us:

* Email: support@spamkiller.io
* Documentation: [spamkiller.io/docs](https://spamkiller.io/docs)
* WordPress Guide: [spamkiller.io/docs/wordpress](https://spamkiller.io/docs/wordpress)

== Credits ==

Developed by [SpamKiller](https://spamkiller.io)
Powered by Google Gemini AI
