=== AceVelocity Forms ===
Contributors: acevelocity
Tags: forms, contact form, form builder, lead form
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.7.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fast, simple form builder with a drag-and-drop field editor and shortcode placement.

== Description ==

Build contact and lead forms in WordPress without code.

* Field types: single line text, email, phone, number, date, paragraph text, dropdown, radio buttons, checkboxes, hidden.
* Per-field settings: label, required, placeholder, help text, options, default value, min/max, maximum characters, full or half width.
* Drag-and-drop or button-based field reordering, duplicate and delete.
* Place any form with `[ace_velocity_form id="123"]`.
* Server-side validation and sanitizing of every value.
* Accessible markup (labels, fieldsets, error descriptions) and clean, theme-friendly styling.
* Entries: every submission is saved. Filter, search, mark read/unread, bulk delete and export to CSV (Excel-friendly).
* Email notification to one or more addresses, with Reply-To set to the visitor, plus an optional auto-reply.
* Smart tags such as {all_fields}, {form_name}, {page_url} and {field:KEY} in subjects and messages.
* After submitting: show a message or send the visitor to a thank-you page.
* Spam protection that works with page caching: invisible honeypot, minimum fill-in time and a per-visitor rate limit.
* Live Preview: see unsaved changes instantly at desktop, tablet and mobile widths, or "Preview on my site" inside your real theme.
* Block editor block "AceVelocity Form", plus the shortcode for Divi, Astra and other builders.
* Appearance: own clean style with colour, roundness and width options, or use your theme's form styling.
* Duplicate, export and import forms between sites.
* Privacy: optional IP storage, automatic entry clean-up, WordPress personal data export/erase, suggested privacy policy text.
* Cloudflare / proxy aware visitor IP detection.
* Optional clean uninstall (off by default, so data is never lost by accident).
* Optional sending through SendGrid or Mailgun (SMTP with TLS, encrypted credentials or wp-config constants), for this plugin's emails only or the whole site.
* Email delivery check: see whether email goes through the server or an SMTP plugin, and send a test email.
* "Upgrade to a Premium Form Builder" page (disclosed affiliate link) and small, dismissible tips in the admin (never on your website). Can be switched off in Settings.

A complete User Manual is included in the plugin: AceVelocity Forms > User Manual.

More at https://go.acevelocity.com/mywpplugins

== Developer hooks ==

* `AVF_SENDGRID_API_KEY`, `AVF_MAILGUN_SMTP_LOGIN`, `AVF_MAILGUN_SMTP_PASSWORD` (constants) - define in wp-config.php to keep email credentials out of the database.

* `avf_form_submitted` (action) - `( $form, $values, $entry_id )` after a valid submission is stored and emailed.
* `avf_store_ip` (filter) - return false to stop storing visitor IP addresses.
* `avf_recommended_links` (filter) - change the upgrade link.
* `avf_client_ip` (filter) - change how the visitor IP is detected (e.g. behind Cloudflare).
* `avf_validate` (filter) - `( $errors, $values, $form )` add custom errors as field_id => message.
* `avf_capability` (filter) - capability needed to manage forms (default `manage_options`).

== Changelog ==

= 1.7.1 =
* Changed: plugin website and premium upgrade links updated.

= 1.7.0 =
* New: one-click updates from AceVelocity's update server (Update URI), with View details, auto-updates and a Check for updates link.
* New: a short "What's new" message after each update.
* New: Updates section in the User Manual.

= 1.6.0 =
* New: User Manual inside the plugin (AceVelocity Forms > User Manual), with contents, search and troubleshooting.

= 1.5.0 =
* Changed: Postmark replaced by SendGrid and Mailgun (US/EU) under Settings > Email sending.
* New: redesigned Recommended page - "Upgrade to a Premium Form Builder" with live demo, use cases, full benefits and a free vs premium comparison.
* Changed: tips now point to the upgrade page only.

= 1.4.0 =
* New: optional sending through Postmark (Settings > Email sending), with encrypted token storage, port 587/2525, message stream and scope.
* New: the Email delivery check recognises Postmark and warns when another plugin would bypass it.
* Changed: links to the Recommended page, tips and external sites open in a new window.

= 1.3.0 =
* New: Recommended page (premium form builder, email delivery, email marketing) with affiliate disclosure.
* New: small dismissible tips in the form editor, Entries and Email delivery, linking to the Recommended page.
* New: "Recommended" link on the Plugins page.
* New: Settings option to hide the Recommended page and all tips.

= 1.2.2 =
* New: Settings > Email delivery shows how the site sends email (server mail or which SMTP plugin) and can send a test email, reporting the exact route and any error.

= 1.2.1 =
* Changed: brand name written as one word, AceVelocity.

= 1.2.0 =
* New: Live Preview tab in the form editor (unsaved changes, desktop/tablet/mobile) and "Preview on my site" with your theme.
* New: "AceVelocity Form" block for the block editor.
* New: Appearance options and "use my theme's form styling" mode.
* New: duplicate, export and import forms.
* New: Settings page (IP storage, Cloudflare/proxy IP detection, entry retention, delete data on uninstall).
* New: WordPress privacy exporter/eraser and suggested privacy policy text.

= 1.1.0 =
* New: Entries screen with search, filters, read/unread, bulk actions and CSV export.
* New: email notification, auto-reply and smart tags.
* New: redirect to a page after submitting.
* New: spam protection (honeypot, minimum time, rate limit).
* New: Fields / Settings tabs in the form editor.
* Improved: field blocks can be collapsed and expanded (Edit / Done, Expand all / Collapse all).
* Changed: plugin description no longer repeats the author link.

= 1.0.0 =
* First release: form builder, field types, shortcode, validation.
