=== FormThrottle Logger ===

Contributors: 99yogesh
Tags: gravity-forms, contact-form-7, security, spam, ip, logging
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Protect Gravity Forms and Contact Form 7 from abuse by tracking IPs, blocking repeat offenders, and logging restricted submissions in a WordPress admin review page.

== Description ==

FormThrottle Logger helps reduce spam and repeated form abuse by limiting how many submissions a single IP address can make within a chosen time period for Gravity Forms and Contact Form 7.

Features:
* Monitors submissions by IP address for Gravity Forms and Contact Form 7
* Blocks repeat offenders once the configured threshold is reached
* Logs the IP address, form ID, source type, reason, and timestamp
* Adds a log screen in the plugin admin menu for reviewing blocked attempts
* Lets you choose which integrations are protected and configure the threshold and time window

== Installation ==

1. Upload the plugin files to the /wp-content/plugins/formthrottle-logger/ directory, or install it directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Make sure Gravity Forms or Contact Form 7 is installed and active.
4. Open the FormThrottle Logger menu in the WordPress admin area.
5. Review the "Restricted IP Logs" page or open Settings to adjust the submission limit and time window.

== Configuration ==

By default, the plugin allows 10 submissions within a 1-hour window. Both Gravity Forms and Contact Form 7 are enabled by default in the "Apply to" settings.

To change this:

1. Open the FormThrottle Logger Settings page from the admin menu.
2. Set the submission limit and the time window in hours.
3. Select which integrations should be protected.
4. Save your changes.

== Screenshots ==

1. View detailed IP logs including IP address, form ID, form type, blocking reason, and submission date.
2. Configure the submission limit, time window, and protected form integrations.

== Frequently Asked Questions ==

= Does this plugin require Gravity Forms or Contact Form 7? =
Yes. This plugin supports Gravity Forms and Contact Form 7 and works when at least one of these plugins is installed and activated.

= What happens when an IP is blocked? =
The submission is rejected and the event is recorded in the plugin log with the IP address, form ID, source type, reason, and timestamp.

= Can I change the submission limit? =
Yes. You can configure the threshold and time window from the FormThrottle Logger Settings page.

= How do I view the logs? =
Open the FormThrottle Logger admin menu and select "Restricted IP Logs".

== Changelog ==

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 1.0 =
Initial release.
