=== ToolXON Contact Form Lite ===
Contributors: toolxon
Tags: contact form, contact form plugin, ajax form, spam protection, custom fields
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight WordPress contact form with AJAX submission, custom fields, email notifications, an admin inbox, and built-in spam protection.

== Description ==

ToolXON Contact Form Lite is a lightweight contact form plugin for WordPress that provides the essential features needed to receive and manage website messages without adding unnecessary complexity.

Add a customizable contact form to any page, post, widget, or shortcode-compatible block using the "[toolxon_contact_form]" shortcode.

Form submissions are stored in a plugin-owned database table and can be reviewed from the WordPress admin area. Optional email notifications can be sent to the site's configured WordPress administration email address.

The plugin is designed for straightforward WordPress sites that need a simple, customizable contact form with local message storage and common form protection features.

== Features ==

* Simple "[toolxon_contact_form]" shortcode.
* Customizable form title, description, labels, button text, and success message.
* Optional subject field.
* Custom text, email, phone, number, URL, and date fields.
* AJAX form submission without a full page reload.
* Admin inbox for viewing submitted messages.
* Optional email notifications to the WordPress administration email address.
* Nonce validation for form requests.
* Hidden honeypot field for basic spam protection.
* Responsive frontend and WordPress admin styling.
* Plugin-owned database table for stored submissions.
* Uninstall cleanup for plugin-owned settings and stored message data.
* No ToolXON remote API or remote analytics service for submitted form data.

== Why ToolXON Contact Form Lite? ==

ToolXON Contact Form Lite focuses on the core functionality many WordPress sites need from a contact form:

* Create a contact form quickly.
* Customize common form fields and labels.
* Receive submissions without leaving the page.
* Review submitted messages from WordPress admin.
* Optionally receive email notifications.
* Add custom fields when the standard form fields are not enough.
* Keep submitted messages inside the site's own WordPress database.

== Shortcode ==

Add the following shortcode to a page, post, widget, or shortcode-compatible block:

"[toolxon_contact_form]"

The form can then be configured from:

Settings > Contact Form

Submitted messages can be reviewed from:

Tools > Contact Messages

== Installation ==

1. Install ToolXON Contact Form Lite from the WordPress Plugins screen, or upload the plugin ZIP from Plugins > Add New > Upload Plugin.
2. Activate ToolXON Contact Form Lite.
3. Go to Settings > Contact Form.
4. Configure the form title, labels, fields, button text, success message, and available options.
5. Add "[toolxon_contact_form]" to the page where you want the form to appear.
6. View submitted messages from Tools > Contact Messages.

== FAQ ==

= Where are form submissions stored? =

Form submissions are stored in a plugin-owned table in the site's WordPress database. They can be viewed from Tools > Contact Messages.

= Where are email notifications sent? =

When email notifications are enabled, notifications are sent to the WordPress "admin_email" address configured for the site.

= Can I add custom fields? =

Yes. Custom text, email, phone, number, URL, and date fields can be added from Settings > Contact Form.

= Does the form require a page reload when submitted? =

No. The form uses AJAX submission so a normal full-page reload is not required.

= Does ToolXON receive submitted form data? =

No. ToolXON Contact Form Lite does not include a ToolXON remote API or remote analytics service for submitted form data.

= What happens to stored submissions when the plugin is uninstalled? =

The plugin removes its own settings and plugin-owned contact message table during uninstallation. Export or retain any messages you need before uninstalling.

= Does the plugin provide spam protection? =

The plugin includes a hidden honeypot field and request validation to provide basic protection against unwanted form submissions.

== Privacy ==

ToolXON Contact Form Lite does not send submitted form data to a ToolXON remote service.

Depending on the fields configured by the site owner, visitors may submit information such as names, email addresses, subjects, messages, phone numbers, URLs, dates, or other custom field values.

Submitted values are stored in the site's WordPress database and may be included in email notifications sent to the site's configured WordPress administration email address.

Site owners are responsible for determining what personal data their forms collect and for maintaining appropriate privacy notices, retention practices, and other legal requirements applicable to their website.

== Data Storage ==

Contact messages are stored in a plugin-owned database table using the active WordPress database prefix.

The plugin does not require an external ToolXON account or remote service to store submitted messages.

== Uninstallation ==

When ToolXON Contact Form Lite is uninstalled, the plugin removes its own settings and plugin-owned contact message table, including stored submissions.

Please retain or export any messages that need to be kept before uninstalling the plugin.

== Support ==

For support, bug reports, compatibility issues, or feature requests, please use the support forum on the ToolXON Contact Form Lite WordPress.org plugin page.

When reporting an issue, include your WordPress version, plugin version, PHP version where relevant, and a description of the steps needed to reproduce the problem.

== Changelog ==

= 1.2.2 =

* Updated admin menu placement to follow WordPress administration conventions.
* Normalized readme headings and configuration instructions.

= 1.2.1 =

* Prepared the plugin package for WordPress.org Plugin Check and current WordPress releases.
* Improved request sanitization and email validation.
* Improved custom database query handling and safe table identifier preparation.
* Added local, versioned frontend and admin assets.
* Added uninstall cleanup for plugin-owned settings and message data.

= 1.2.0 =

* Previous plugin release.

== Additional Information ==

ToolXON Contact Form Lite is open source software licensed under the GNU General Public License version 2 or later.