=== Yeekit: Limit Submissions for Elementor Forms ===
Contributors: addonsorg
Tags: elementor, elementor forms, form submissions, submission limit
Requires at least: 7.0
Tested up to: 7.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Limit how many times users, emails, or IP addresses can submit an Elementor Form — daily, weekly, monthly, or forever.

== Description ==
**Demo:** <https://demo.add-ons.org/demo-limit-submissions/>  
**Documentation:** <https://add-ons.org/document-limit-submissions-for-elementor-forms/>  
**Pro Version:** <https://add-ons.org/plugin/limit-submissions-for-elementor-forms/>

**Limit Submissions for Elementor Forms** lets you **restrict how many times a form can be submitted** based on:
- User (logged-in)
- Email address
- IP address
- Custom time period (e.g. every 6 hours, per day, week, month, or forever)

It’s lightweight, secure, and works natively with **Elementor Pro Forms** — no external services required.

== Features ==
- **Limit by User** – Restrict submissions per logged-in user.
- **Limit by Email** – Block duplicate or spam email submissions.
- **Limit by IP Address** – Prevent multiple submissions from the same IP.
- **Time Periods** – Choose between:
  - Per 24 hours
  - Per 7 days
  - Per month (~30 days)
  - Till end of day / week / month / year
  - Custom (e.g. every X hours)
- **Guest Control** – Optionally block submissions from guests.
- **Smart Validation** – Validates email, user, and IP before submission.
- **Caching Ready** – Supports `wp_cache_set()` and Redis object caching for optimized SQL queries.
- **Fully Compatible with Elementor Pro** – Works with the native Form widget and all actions (Email, Webhook, PDF, etc.).
- **Fast & Lightweight** – Minimal impact on site performance.

== Use Cases ==
- Limit each user to 1 submission per form.
- Restrict survey submissions to once per week.
- Prevent spam by limiting per IP or per email.
- Control event or coupon signup forms by time period.


== Installation ==

1. Upload the plugin files to `/wp-content/plugins/limit-submissions-for-elementor-forms/`, or install directly via **Plugins → Add New**.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Edit your Elementor Pro form → Under the **Limit Submissions** section, choose your restriction type (User, Email, IP, or Custom).
4. Set your **submission limit** and **time period**.
5. Save and test your form.


== Frequently Asked Questions ==

= Does this plugin require Elementor Pro? =  
Yes. It works with the **Elementor Pro Form widget** only.

= Can I limit form submissions per day, week, or month? =  
Yes. You can set time periods like per 24 hours, per week, per month, or a custom number of hours.

= Does it support guest (non-logged-in) users? =  
Yes, you can allow or block guests from submitting based on IP or email.

= Does it slow down my site? =  
No. It uses optimized SQL queries and WordPress caching (`wp_cache_set`) for maximum performance.

= Can I use it with other Elementor form extensions? =  
Yes. It is fully compatible with most third-party Elementor form actions and PDF add-ons.


== Screenshots ==
1. Limit Submissions settings in Elementor editor.  
2. Example: “You have reached the submission limit” message.  
3. Restrict by email example.  
4. Restrict by user login example.  


== Changelog ==
= 1.0.0 =
* Initial release: Limit submissions by user, email, IP, and custom time periods.

